# VSM: Global Vertical Vegetation Structure Model, GEDI RH0-RH100 at 10 m (2020)

## Facts

- Provider: University of Copenhagen GeoAI group (Zhang et al.)
- License: CC-BY-4.0 (https://source.coop/geoai-ucph/gvsm)
- Format: TIFF (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/geoai-ucph/gvsm (us-west-2)
- Access: public, readable without an account
- Category: Earth Observation & Geospatial
- Source: https://eartharxiv.org/repository/view/15380
- Page: https://scigantic.com/archive/4e24d485-b3e1-5b5a-9475-3380fe39570c
- Keywords: Earth Observation & Geospatial, satellite imagery, LiDAR, TIFF, AWS Open Data

## About

The Vertical Vegetation Structure Model (VSM) maps the full GEDI relative height profile, not only canopy height, across global land at 10 m. A deep learning model trained on 178 million GEDI L2A lidar waveforms translates Sentinel-2 L2A imagery into 101 relative height metrics, RH0 to RH100 in decimetres, each with predictive quantiles for uncertainty (median Q1 available; 5th and 95th percentiles to follow). RH98-RH100 approximate canopy top height; RH50 and the lower metrics describe canopy layering, understory density and structural diversity for forest monitoring, carbon and biodiversity work. Layout: 2020/ /RH{level}_Q{quantile}.tif at 10 m in each Sentinel-2 tile's UTM zone (10,980 x 10,980 px), plus mosaics/2020/ global overviews averaged to 0.01 degree in EPSG:4326 (36,000 x 13,889 px); an experiments/ folder holds supporting runs. Cloud Optimized GeoTIFF, Int16, lossless LERC+ZSTD; about 360 TB per year. 2024 is in preparation. Read with rasterio or rioxarray after picking tiles from the MGRS grid. Licensed CC BY 4.0; cite the EarthArXiv preprint (eartharxiv.org/repository/view/15380).

## 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='geoai-ucph/gvsm/', Delimiter='/')
```

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

## Data structure

File types in sampled files: TIFF

Example file: `geoai-ucph/gvsm/2020/01GEL/RH0_Q0.tif`

Path pattern: `{prefix}/{seg1}/{YYYY}/{seg3}/{filename}`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/4e24d485-b3e1-5b5a-9475-3380fe39570c
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/4e24d485-b3e1-5b5a-9475-3380fe39570c
- Over MCP: `get_schema_card` with id `4e24d485-b3e1-5b5a-9475-3380fe39570c` at https://api.scigantic.com/mcp

## Related topics

- [Earth Observation & Geospatial datasets](https://scigantic.com/topics/earth-observation-and-geospatial)
- [Satellite imagery datasets](https://scigantic.com/topics/satellite-imagery)
- [TIFF datasets](https://scigantic.com/topics/tiff)
- [LiDAR datasets](https://scigantic.com/topics/lidar)
