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

Provider
Allen and Pavelsky (2018); repackaged by nthh
License
CC-BY-4.0 (source)
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
Free and public. No account with the data provider is needed.
DOI
10.1126/science.aat0636
Category
Earth Observation & Geospatial
Source
https://doi.org/10.1126/science.aat0636

About this dataset

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.

How to access this dataset in 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

Files

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

Analyze this dataset without downloading it

On Scigantic, Global River Widths from Landsat (GRWL) V01.01 Raw Vector Observations, GeoParquet opens in a hosted JupyterLab notebook with the data already mounted, so you can read files where they are stored instead of copying them first. Each notebook includes an AI assistant that can see the mounted files and write and run analysis code. Open the dataset page to launch a notebook, or browse the full catalog.

This page is also available as Markdown and as JSON.

Related Earth Observation & Geospatial datasets