FlowDivide 0.6.4   run south-america   2026-09-27 14:58
  command              python flowdivide.py run south-america --steps fd1,fd2 --out-root <directory> --no-open --acc <directory>/upg.tif --drop bsn,rgn,pieces

inputs
  flow directions      <directory>/south-america_DIR_1s_v2r0.tif
                       hydrosheds convention, 1 arc-second (30 m), 259200 rows x 219600 columns
                       blocks of 3600 pixels (one degree)
  basin groups         predefined units: <directory>/hybas_sa_lev03_v1c.shp
  upstream count       <directory>/upg.tif, on the same grid, 30 m
  upstream area        <directory>/south-america_ACA_1s_v2r0.tif (km2), on the same grid, 30 m

options
  steps                fd1, fd2
  capacities           2^31 = 160 blocks (160 square degrees) = 2073600000 pixels of 30 m, the cut 3 levels deep
                       2^30 = 80 blocks (80 square degrees) = 1036800000 pixels of 30 m, the cut 3 levels deep
                       2^29 = 40 blocks (40 square degrees) = 518400000 pixels of 30 m, the cut 4 levels deep
  basin groups         the predefined units (Level-03); the automatic groups made as well, for Figure 3c
  merge policy         none
  channel threshold    1 km2;  attributes for basins of at least 1 km2
  work tile            16384 pixels of 30 m
  views                1/400° (280 m) = 9 pixels a cell, basins of 0.0194 km2 and more;  1/200° (560 m) = 18 pixels a cell, basins of 0.0775 km2 and more;  1/120° (930 m) = 30 pixels a cell, basins of 0.2151 km2 and more;  1/20° (5.6 km) = 180 pixels a cell, basins of 7.7450 km2 and more
  vector files         GeoParquet; at least 8 colour numbers

outputs   under <directory>/
  dir     recoded flow directions                            30 m  global/fineresolution/dir/dir_south-america_1s_merit.tif  kept
  acc     upstream pixel count                               30 m  given, not written
  aca     upstream area (km2)                                30 m  given, not written
  str     channel mask                                       30 m  global/fineresolution/str/str_south-america_1s.tif  kept
  l3      predefined groups on the grid                      30 m  global/fineresolution/l3/l3_south-america_1s.tif  kept
  bsn     basin of every pixel                               30 m  global/fineresolution/bsn/bsn_south-america_1s.tif  dropped after fd2_region_views_2^29
  tables  outlets, basins, groups                            30 m  global/table/
  views   basin and group views, rasters and polygons        1/400° (280 m), 1/200° (560 m), 1/120° (930 m), 1/20° (5.6 km)  global/coarseresolution/, global/vector/
  2^31    regions, pieces, views                             30 m  partitions/160deg2/  rgn dropped after fd2_region_views_2^29, pieces dropped after fd2_piece_views
  2^30    regions, pieces, views                             30 m  partitions/80deg2/  rgn dropped after fd2_region_views_2^29, pieces dropped after fd2_piece_views
  2^29    regions, pieces, views                             30 m  partitions/40deg2/  rgn dropped after fd2_region_views_2^29, pieces dropped after fd2_piece_views
  logs    markers, summary, timings: input, compute, output        _logs/, _logs/timings_south-america.csv
