# HydroLAKES v1.0 Global Lake Polygons, GeoParquet

## Facts

- Provider: Messager, Lehner et al. / HydroSHEDS; repackaged by nthh
- License: CC-BY-4.0 (https://source.coop/nthh/hydrolakes)
- Format: JSON (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/nthh/hydrolakes (us-west-2)
- Access: public, readable without an account
- DOI: https://doi.org/10.1038/ncomms13603
- Category: Environmental Science
- Source: https://doi.org/10.1038/ncomms13603
- Page: https://scigantic.com/archive/ee0b72d9-9204-568c-a81c-223a2a641823
- Keywords: Environmental Science, JSON, AWS Open Data

## About

The complete HydroLAKES v1.0 polygon layer (Messager et al., Nature Communications 2016): shoreline polygons for about 1.43 million lakes and reservoirs of at least 10 ha worldwide, compiled from multiple shoreline sources and linked to the HydroSHEDS river network. Producer attributes are kept, including lake area, shoreline length and development, estimated volume and mean depth, average discharge, residence time, elevation, watershed area, pour point coordinates and lake type (lake, reservoir, lake control). Files: hydrolakes-polygons-v1.0.parquet (about 950 MB, spatially ordered GeoParquet), a fields.json dictionary, a PMTiles display layer with MapLibre styles, the original HydroLAKES technical documentation PDF and LICENSE.txt. Pour points are not included in this release. Static research compilation, not a current lake inventory. Query remotely with DuckDB spatial or read with geopandas for limnology, lake water balance and carbon studies. Licensed CC BY 4.0 by HydroSHEDS; cite Messager et al. (2016), doi:10.1038/ncomms13603.

## Load the data

```python
import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-west-2', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='us-west-2.opendata.source.coop', Prefix='nthh/hydrolakes/', Delimiter='/')
```

Lists the files with anonymous access. Runs on any machine, with no cloud account.

## Data structure

File types in sampled files: JSON

Example file: `nthh/hydrolakes/HydroLAKES_TechDoc_v10.pdf`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/ee0b72d9-9204-568c-a81c-223a2a641823
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/ee0b72d9-9204-568c-a81c-223a2a641823
- Over MCP: `get_schema_card` with id `ee0b72d9-9204-568c-a81c-223a2a641823` at https://api.scigantic.com/mcp

## Related topics

- [JSON datasets](https://scigantic.com/topics/json)
- [Environmental Science datasets](https://scigantic.com/topics/environmental-science)
