FullHydro downloads
===================

Data computed by the FullHydro tools.  Full... is the data; Flow... is the tool
(code) that computes it.

Ready to download (final)
  merit-hydro-v1.0.1-90m/fullbasin/fulldivide/v1.1/  FullDivide, basins and regions, global
  merit-hydro-v1.0.1-90m/fullbasin/fulltopo/v1.1/    FullTopo, drainage order, global (four structures; four more in region 43)
  merit-hydro-v1.0.1-90m/fullbasin/fullmorph/v1.1/   FullMorph, upstream shape and terrain, global
  hydrosheds-v2.0-30m/fullbasin/fulldivide/v1.0/     FullDivide, basins and regions, North and South America
  papers/flowdivide/v1.0/                            the data for the figures of the FlowDivide paper
FullAttr is in preparation.

  merit-hydro-v1.0.1-90m/   MERIT Hydro v1.0.1, 90 m, global
  hydrosheds-v2.0-30m/      HydroSHEDS v2.0, 30 m, released continents
    fullbasin/              FullBasin, every land pixel
      fulldivide/           basins and regions          computed by FlowDivide
      fulltopo/             drainage order              computed by FlowTopo
      fullmorph/            upstream shape              computed by FlowMorph
      fullattr/             flow length, stream order   computed by FlowTopo
    fullriver/              FullRiver, river channels (coming soon)
  nhdplus-v2.1-30m/         NHDPlus V2.1, 30 m, conterminous United States: coming soon, no files yet
  geodata-d8-v3-250m/       GEODATA 9-second D8, about 250 m, Australia: coming soon, no files yet
  papers/                   the data the figures of the papers are drawn from
    flowdivide/             the FlowDivide paper

Folders    <source grid>/<dataset>/<part>/<version>/ and papers/<paper>/<version>/,
           the same paths on https://data.fullhydro.org/
Files      every table as <name>.csv and <name>.parquet (Apache Parquet),
           every outline layer as <name>.gpkg (GeoPackage) and <name>.geo.parquet (GeoParquet 1.1),
           every raster as a Cloud-Optimized GeoTIFF (.tif): the same content in each pair.
           Each folder of files has a SHA256SUMS.txt: sha256sum -c SHA256SUMS.txt checks a download.

Before you download: three notes
  1. Independent datasets.  Built on MERIT Hydro v1.0.1, MERIT DEM v1.0.3 and
     HydroSHEDS v2.0, but not official MERIT Hydro products, and not part of the
     official HydroSHEDS family of products.  Cite the source data:
       MERIT Hydro        Yamazaki et al. (2019), https://doi.org/10.1029/2019WR024873
       MERIT DEM          Yamazaki et al. (2017), https://doi.org/10.1002/2017GL072874
       HydroSHEDS v2.0    Lehner et al. (2022), https://doi.org/10.1029/2022EO220167
       HydroBASINS        Lehner and Grill (2013), https://doi.org/10.1002/hyp.9740
  2. The licence follows the source data; follow its terms.  Files on MERIT Hydro and
     MERIT DEM: CC BY-NC 4.0 (non-commercial use) or ODbL 1.0 (commercial use allowed,
     derived data shared under ODbL 1.0), whichever you choose.  Files on HydroSHEDS
     v2.0: CC BY 4.0.  The code: MIT.
       CC BY-NC 4.0       https://creativecommons.org/licenses/by-nc/4.0/
       ODbL 1.0           https://opendatacommons.org/licenses/odbl/1-0/
       CC BY 4.0          https://creativecommons.org/licenses/by/4.0/
       MERIT Hydro        https://global-hydrodynamics.github.io/MERIT_Hydro/#license-agreement
       MERIT DEM          https://global-hydrodynamics.github.io/MERIT_DEM/#license-agreement
       HydroSHEDS v2.0    https://www.hydrosheds.org/products/hydrosheds-v2
  3. Get the source data from their providers.  The key layers, the flow
     directions (dir) and the elevations (elv), are not redistributed here.
     Download them from
       MERIT Hydro (90 m)        https://global-hydrodynamics.github.io/MERIT_Hydro/
       HydroSHEDS v2.0 (30 m)    https://www.hydrosheds.org/hydrosheds-v2

Code       https://github.com/hellolulujiang/flowdivide
           https://github.com/hellolulujiang/flowtopo
           https://github.com/hellolulujiang/flowmorph
Licence    the code (the three repositories above)                 MIT
           every file on MERIT Hydro (merit-hydro-v1.0.1-90m/)     CC BY-NC 4.0 or ODbL 1.0, your choice
           every file on HydroSHEDS v2.0 (hydrosheds-v2.0-30m/)    CC BY 4.0
           papers/flowdivide/ (built on HydroSHEDS v2.0)           CC BY 4.0
Contact    Lulu Jiang, https://lulujiang.me

Every file can be read over HTTP without downloading it whole (range requests):
  rasterio.open("https://data.fullhydro.org/merit-hydro-v1.0.1-90m/fullbasin/fulldivide/v1.1/basins/bsn_global_90m.tif")
  geopandas.read_parquet("https://data.fullhydro.org/merit-hydro-v1.0.1-90m/fullbasin/fulldivide/v1.1/regions/rgn_global.geo.parquet")