# TreeSatAI Time Series: Tree Species Labels with Aerial Imagery and Yearly Sentinel-1/2 Series (Lower Saxony)

## Facts

- Provider: IGN France (Astruc G. et al.), extending TreeSatAI by Ahlswede et al.
- License: CC-BY-SA-4.0 (https://huggingface.co/datasets/IGNF/TreeSatAI-Time-Series)
- Size: 9 files
- Format: PNG (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/IGNF/TreeSatAI-Time-Series
- Access: public, readable without an account
- DOI: https://doi.org/10.5194/essd-15-681-2023
- Category: Earth Observation & Geospatial
- Source: https://arxiv.org/abs/2404.08351
- Page: https://scigantic.com/archive/73f10591-08a1-58b9-9a4a-b58fe4ceee1d
- Keywords: Earth Observation & Geospatial, satellite imagery, time series, benchmark, PNG, Hugging Face

## About

Multi-label tree species classification over 50,381 forest patches of 60 m x 60 m in Lower Saxony, Germany, with labels for 20 European tree species (15 genera) from state forest administration data. It extends the TreeSatAI Benchmark Archive of Ahlswede et al. (ESSD 2023), which gave one Sentinel-1 and one Sentinel-2 image per patch, by adding all Sentinel-1 ascending and descending backscatter (VV, VH) and Sentinel-2 L2A reflectance (10 bands with cloud and snow probability masks) acquired over a year, aligned with the year of the 0.2 m RGB-infrared aerial patch (2017 for earlier flights). Zips hold aerial, sentinel (single-date), sentinel-ts (HDF5 per patch with product names), labels (species presence and proportion), geojson patch locations and train, val and test splits. Measured: 9 files, about 22.8 GB. It was introduced with OmniSat (ECCV 2024) and used by MAESTRO; read the time series with h5py. Licensed CC BY-SA 4.0 per the card; cite Ahlswede et al. 2023 and Astruc et al. 2024.

## Load the data

```python
from huggingface_hub import hf_hub_download
path = hf_hub_download(repo_id="IGNF/TreeSatAI-Time-Series", filename="TreesatAI-TS-fig.png", repo_type="dataset")
print(path)
```

## Data structure

File types in sampled files: PNG

Example file: `TreesatAI-TS-fig.png`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/73f10591-08a1-58b9-9a4a-b58fe4ceee1d
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/73f10591-08a1-58b9-9a4a-b58fe4ceee1d
- Over MCP: `get_schema_card` with id `73f10591-08a1-58b9-9a4a-b58fe4ceee1d` 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)
- [Benchmark datasets](https://scigantic.com/topics/benchmark)
- [Time series datasets](https://scigantic.com/topics/time-series)
- [PNG datasets](https://scigantic.com/topics/png)
