AK_TCN_gpkgs - Data Product README (TXT)
======================================

1. Overview
-----------
AK_TCN_gpkgs contains Trough Capillary Networks (TCNs) detected from high-
resolution (C)Maxar imagery over the Alaska Tundra. The imagery was provided by
the Polar Geospatial Center (PGC), University of Minnesota, under U.S. National
Science Foundation (NSF)-OPP awards 1043681 and 1559691.

2. Contents
-----------
This data product provides:
- Per-file GeoPackages (GPKG) containing detected TCN raster/vector layers.
- Skeletonized representations (nodes,edges,components) of detected trough networks.
- Hierarchical organization aligned to the PGC mosaic tiling scheme:
  * Tile level (~100 km^2)
  * Subtile level (~20 km^2)
- Graph-theoretic statistics to support hydrologic and related analyses.

3. Processing Summary
---------------------
Detected trough features are skeletonized and organized according to the PGC
mosaic tiling workflow [1]. Graph-theoretic statistics are derived from the
skeleton networks to support downstream analyses[2].

4. Acknowledgements and Funding
-------------------------------
Imagery support was provided by the Polar Geospatial Center (PGC), University of
Minnesota, under NSF-OPP awards 1043681 and 1559691.

Model training and data processing were supported by NSF grants 1720875, 1722572,
1927872, 1927723, and 1927729.

Computational resources were provided by the eXtreme Science and Engineering
Discovery Environment (XSEDE; Award DPP 190001) and the Texas Advanced Computing
Center (TACC; Award DPP20001).

5. Reference
------------
[1] PGC mosaic tiling workflow (pgc_mosaic_build_tile.py):
    https://github.com/PolarGeospatialCenter/imagery_utils/blob/main/pgc_mosaic_build_tile.py
[2] TCN detection and Graph Theoretic stats pipeline
    https://github.com/UConnARIAL/trough_pipeline.git

6. Helper Scripts
-----------------
Some scripts/bash cmds to help clean up and get info (sizes)

To find if there are sidecar files inside the folders
Sidecar files are generated when we access gpkg files via lib,tools etc and 
should be removed by default but sometimes they linger!

bash find_sidecars.sh

To remove them
chmod +x find_sidecars.sh
./find_sidecars.sh . | tr '\0' '\n'

To get the sizes of all tile folders
du -sm ./* | awk '{print $2 "\t" $1}'

To get the sizes of al subtile files
du -sm ./*/*_TCN.gpkg 2>/dev/null | awk '{print $2 "\t" $1}'