# LakeATLAS v1.0 Lake Polygons and Pour Points with Hydro-environmental Attributes

## Facts

- Provider: Lehner, Messager, Korver and Linke / HydroATLAS; repackaged by nthh
- License: CC-BY-4.0 (https://source.coop/nthh/lakeatlas)
- Format: JSON (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/nthh/lakeatlas (us-west-2)
- Access: public, readable without an account
- DOI: https://doi.org/10.1038/s41597-022-01425-z
- Category: Environmental Science
- Source: https://doi.org/10.1038/s41597-022-01425-z
- Page: https://scigantic.com/archive/033ac316-abf9-5874-a730-2536c8b28d77
- Keywords: Environmental Science, JSON, AWS Open Data

## About

LakeATLAS v1.0 (Lehner et al., Scientific Data 2022), the lake member of the HydroATLAS family: the 1.4 million HydroLAKES lakes and reservoirs annotated with 56 hydro-environmental variables in 281 attributes, describing both the lake itself and its upstream catchment, including hydrology, physiography, climate, land cover, soils and geology, and anthropogenic pressures. Two spatially ordered GeoParquet files hold the lake polygons (about 1.1 GB) and lake pour points (about 280 MB), each with a fields.json dictionary and a field-semantics.json supplement, plus PMTiles display layers, the HydroATLAS technical documentation and the 52 MB LakeATLAS attribute catalogue PDF. Attribute observation and model-input dates vary by variable; check the catalogue. Read with DuckDB or geopandas for lake typology, ecology, and catchment-pressure analyses. The producer catalogue marks most fields CC BY 4.0 and some fields ODbL 1.0 (both open); retain attribution and cite Lehner et al. (2022), doi:10.1038/s41597-022-01425-z.

## Load the data

```python
import os
from PIL import Image
im = Image.open(os.path.join(os.environ['SCIGANTIC_MOUNT_PATH'], 'lakeatlas-preview-v2.png'))
print(im.size, im.mode)
```

Run in a Scigantic notebook on 2026-11-17 against `lakeatlas-preview-v2.png`: PIL image (1200, 720) mode RGB format PNG.

From any machine:

```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/lakeatlas/', 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/lakeatlas/HydroATLAS_TechDoc_v10_1.pdf`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/033ac316-abf9-5874-a730-2536c8b28d77
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/033ac316-abf9-5874-a730-2536c8b28d77
- Over MCP: `get_schema_card` with id `033ac316-abf9-5874-a730-2536c8b28d77` at https://api.scigantic.com/mcp

## Related topics

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