# Global River Widths from Landsat (GRWL) V01.01 Raw Vector Observations, GeoParquet

## Facts

- Provider: Allen and Pavelsky (2018); repackaged by nthh
- License: CC-BY-4.0 (https://source.coop/nthh/grwl-raw)
- Format: PNG, JSON, Parquet (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/nthh/grwl-raw (us-west-2)
- Access: public, readable without an account
- DOI: https://doi.org/10.1126/science.aat0636
- Category: Earth Observation & Geospatial
- Source: https://doi.org/10.1126/science.aat0636
- Page: https://scigantic.com/archive/7b391927-fd55-5c25-9ca5-e0a42477eef8
- Keywords: Earth Observation & Geospatial, satellite imagery, time series, PNG, JSON, Parquet, AWS Open Data

## About

The complete Global River Widths from Landsat (GRWL) V01.01 raw vector observations of Allen and Pavelsky (Science, 2018), who mapped river and stream centrelines and wetted widths at mean annual discharge from Landsat imagery for all rivers wider than 30 m. All 64,572,998 centreline observations and the ten original DBF fields (width in metres, number of channels, lake/reservoir/canal/tidal flags, UTM zone and source scene identifiers) are kept losslessly in grwl-raw-v01.01.parquet (about 5.5 GB GeoParquet), with a fields.json dictionary. A separately versioned PMTiles layer (zoom 0-12, 3.2 GB) shows the widest observations at low zoom and preserves detailed geometry and widths at zooms 8-12. The conversion was checked record by record against the source. Static product from Landsat scenes of varying dates, not a time series. Use for river surface area, hydraulic geometry, SWOT validation and global hydrology. Query with DuckDB or geopandas. Licensed CC BY 4.0 by the producer; cite Allen and Pavelsky (2018), doi:10.1126/science.aat0636.

## 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/grwl-raw/', Delimiter='/')
```

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

## Data structure

File types in sampled files: PNG, JSON, Parquet

Example file: `nthh/grwl-raw/LICENSE.txt`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/7b391927-fd55-5c25-9ca5-e0a42477eef8
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/7b391927-fd55-5c25-9ca5-e0a42477eef8
- Over MCP: `get_schema_card` with id `7b391927-fd55-5c25-9ca5-e0a42477eef8` at https://api.scigantic.com/mcp

## Related topics

- [Earth Observation & Geospatial datasets](https://scigantic.com/topics/earth-observation-and-geospatial)
- [Parquet datasets](https://scigantic.com/topics/parquet)
- [JSON datasets](https://scigantic.com/topics/json)
- [Satellite imagery datasets](https://scigantic.com/topics/satellite-imagery)
- [Time series datasets](https://scigantic.com/topics/time-series)
- [PNG datasets](https://scigantic.com/topics/png)
