# Global Free-Flowing Rivers Connectivity Assessment (Grill et al. 2019), GeoParquet

## Facts

- Provider: Grill, Lehner, Thieme et al.; repackaged by nthh
- License: CC-BY-4.0 (https://source.coop/nthh/free-flowing-rivers)
- Format: PNG, JSON (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/nthh/free-flowing-rivers (us-west-2)
- Access: public, readable without an account
- DOI: https://doi.org/10.1038/s41586-019-1111-9
- Category: Environmental Science
- Source: https://doi.org/10.1038/s41586-019-1111-9
- Page: https://scigantic.com/archive/c4e2942b-e112-57c8-af0f-8095316ac2bd
- Keywords: Environmental Science, PNG, JSON, AWS Open Data

## About

The complete river reach network from Mapping the world's free-flowing rivers (Grill, Lehner, Thieme et al., Nature 2019), which assessed connectivity status for about 12 million km of rivers worldwide using the HydroSHEDS network. Each reach carries the producer's connectivity status index (CSI) and its component pressure indicators for fragmentation by dams, flow regulation, sediment trapping, water consumption, road density and urban area, plus discharge, river order and the free-flowing / good-connectivity / impacted classification. Files: free-flowing-rivers-v1.parquet (about 887 MB GeoParquet with all producer fields and source geometry), a fields.json dictionary of columns and units, free-flowing-rivers-v1.pmtiles (3.6 GB) with MapLibre styles for display, a manifest and LICENSE.txt. Static assessment based on source data from about 2017; indicators are model-derived. Query directly with DuckDB spatial or read with geopandas. Licensed CC BY 4.0 by the producers; cite Grill et al. (2019), doi:10.1038/s41586-019-1111-9.

## 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/free-flowing-rivers/', Delimiter='/')
```

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

## Data structure

File types in sampled files: PNG, JSON

Example file: `nthh/free-flowing-rivers/LICENSE.txt`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/c4e2942b-e112-57c8-af0f-8095316ac2bd
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/c4e2942b-e112-57c8-af0f-8095316ac2bd
- Over MCP: `get_schema_card` with id `c4e2942b-e112-57c8-af0f-8095316ac2bd` at https://api.scigantic.com/mcp

## Related topics

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