A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

PASTIS

A benchmark dataset for panoptic and semantic segmentation of agricultural parcels from satellite time series.
https://github.com/vsainteuf/pastis-benchmark

Category: Consumption
Sub Category: Agriculture and Nutrition

Last synced: about 22 hours ago
JSON representation

Repository metadata

README.md

🌾 PASTIS 🌾 Panoptic Agricultural Satellite TIme Series (optical and radar)

The PASTIS Dataset

  • Dataset presentation

PASTIS is a benchmark dataset for panoptic and semantic segmentation of agricultural parcels from satellite time series.
It contains 2,433 patches within the French metropolitan territory with panoptic annotations (instance index + semantic label for each pixel). Each patch is a Sentinel-2 multispectral image time series of variable lentgh.

We propose an official 5 fold split provided in the dataset's metadata, and evaluated several of the top-performing image time series networks. You are welcome to use our numbers and to submit your own entries to the leaderboard!

  • Dataset in numbers
▶️ 2,433 time series ▶️ 124,422 individual parcels ▶️ 18 crop types
▶️ 128x128 pixels / images ▶️ 38-61 acquisitions / series ▶️ 10m / pixel
▶️ 10 spectral bands ▶️ covers ~4,000 km² ▶️ over 2B pixels
  • 📡 NEW: Multimodal PASTIS with Radar (PASTIS-R)

We extend PASTIS with aligned radar Sentinel-1 observations for all 2433 patches in addition to the Sentinel-2 images. For each patch, we added approximately 70 observations of Sentinel-1 in ascending orbit, and 70 observations in descending orbit.
PASTIS-R can be used to evaluate optical-radar fusion methods for parcel-based classification, semantic segmentation, and panoptic segmentation.
For more details on PASTIS-R, refer to our recent paper on multi-modal fusion with attention-based models (preprint).

Updates

  • 27.06.2022 Major Bugfix 🪲 A bug in the panoptic metrics was driving the Recognition Quality down artificially. The bug is now fixed and the metrics have been updated here and on Arxiv. Across experiments, solving this bug improved PQ by ~2-3pts on PASTIS. See this issue for more details. If you have been using the PASTIS benchmark, you can simply re-evaluate your models with the corrected implementation.

Usage

  • Download

The dataset can be downloaded from Zenodo in different formats:

  1. PASTIS (29 GB zipped) : The original PASTIS dataset for semantic and panoptic segmentation
    on Sentinel-2 time series (format used for the ICCV 2021 paper). DOI
  2. PASTIS-R (54 GB zipped) : The extended version with Sentinel-1 observations. DOI
  3. PASTIS-R (pixel-set format) (27 GB zipped) : The PASTIS-R dataset prepared in pixel-set format
    for parcel-based classification only. See this repo and
    paper
    for more details on this format. DOI
  • Data loading

This repository also contains a PyTorch dataset class in code/dataloader.py
that can be readily used to load data for training models on PASTIS and PASTIS-R.
For the pixel-set dataset, use the dataloader in code/dataloader_pixelset.py.
The time series contained in PASTIS have variable lengths. The code/collate.py
contains a pad_collate function that you can use in the pytorch dataloader to temporally pad shorter sequences.

  • Metrics

We propose a PyTorch implementation of panoptic metrics in code/panoptic_metrics.py.
In order to use these metrics, the model's output should contain an instance prediction
and a semantic prediction for each pixel.

  • Visualization and Usage

See our notebook demo.ipynb for example of data manipulation and several visualization functions for semantic and panoptic segmentation.

  • Architectures

Pre-trained weights and implementation of U-TAE and PaPs are available on the model repository.

Leaderboard

Please open an issue to submit new entries. Do mention if the work has been published and wether the code accessible for reproducibility. We require that at least a preprint is available to add an entry.


Semantic Segmentation

Optical only (PASTIS)

Model name #Params OA mIoU Published
TSViT † 1.6M 83.4% 65.4% ✔️ link
U-TAE 1.1M 83.2% 63.1% ✔️ link
Unet-3d* 1.6M 81.3% 58.4% ✔️ link
Unet-ConvLSTM* 1.5M 82.1% 57.8% ✔️ link
FPN-ConvLSTM* 1.3M 81.6% 57.1% ✔️ link

(*) Models that we re-implemented ourselves are denoted with a star.

(†) TSViT operates on PASTIS24, where each sample is split into 24x24px sub-patches.


Optical+Radar fusion (PASTIS-R)

Model name #Params OA mIoU Published
S1+S2 U-TAE (late fusion) 1.7M 84.2% 66.3% ✔️ link
S1+S2 U-TAE (early fusion) 1.6M 83.8% 65.9% ✔️ link

Panoptic Segmentation

Optical only (PASTIS)

Model name #Params SQ RQ PQ Published
U-TAE + PaPs 1.3M 81.5 53.2 43.8 ✔️ link
U-ConvLSTM + PaPs 1.7M 80.2 43.9 35.6 ✔️ link

Optical+Radar fusion (PASTIS-R)

These values are still affected by the bug in the metrics computation, they will be re-evaluated shortly.

Model name #Params SQ RQ PQ Published
S1+S2 U-TAE + PaPs (early fusion) 1.8M 82.2 50.6 42.0 ✔️ link
S1+S2 U-TAE + PaPs (late fusion) 2.4M 81.6 50.5 41.6 ✔️ link

Documentation

The agricultural parcels are grouped into 18 different crop classes as shown in the
table below. The backgroud class corresponds to non-agricultural land, and the void label for parcels that are mostly outside their patch.

Additional information about the dataset can be found in the documentation/pastis-documentation.pdf document.

References

If you use PASTIS please cite the related paper:

@article{garnot2021panoptic,
  title={Panoptic Segmentation of Satellite Image Time Series
with Convolutional Temporal Attention Networks},
  author={Sainte Fare Garnot, Vivien  and Landrieu, Loic },
  journal={ICCV},
  year={2021}
}

For the PASTIS-R optical-radar fusion dataset, please also cite this paper:

@article{garnot2021mmfusion,
  title    = {Multi-modal temporal attention models for crop mapping from satellite time series},
  journal  = {ISPRS Journal of Photogrammetry and Remote Sensing},
  year     = {2022},
  doi      = {https://doi.org/10.1016/j.isprsjprs.2022.03.012},
  author   = {Vivien {Sainte Fare Garnot} and Loic Landrieu and Nesrine Chehata},
}

Credits

  • The satellite imagery used in PASTIS was retrieved from THEIA:
    "Value-added data processed by the CNES for the Theia www.theia.land.fr data cluster using Copernicus data.
    The treatments use algorithms developed by Theia’s Scientific Expertise Centres. "

  • The annotations used in PASTIS stem from the French land parcel identification system produced
    by IGN, the French mapping agency.

  • This work was partly supported by ASP, the French Payment Agency.

  • We also thank Zenodo for hosting the datasets.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 7 days ago

Total Commits: 46
Total Committers: 4
Avg Commits per committer: 11.5
Development Distribution Score (DDS): 0.152

Commits in past year: 1
Committers in past year: 1
Avg Commits per committer in past year: 1.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
VSainteuf v****t@p****u 39
vict0rsch v****h@p****e 4
Loic Landrieu l****c@g****m 2
Rahul 7****y 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 23
Total pull requests: 6
Average time to close issues: 19 days
Average time to close pull requests: 2 months
Total issue authors: 20
Total pull request authors: 5
Average comments per issue: 1.96
Average comments per pull request: 0.33
Merged pull request: 4
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 1
Past year average time to close issues: N/A
Past year average time to close pull requests: less than a minute
Past year issue authors: 2
Past year pull request authors: 1
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/vsainteuf/pastis-benchmark

Top Issue Authors

  • isaaccorley (2)
  • long123524 (2)
  • nazib (2)
  • DavidZhang88 (1)
  • psteinb (1)
  • SeyedHosseinTafakh (1)
  • LL0912 (1)
  • GustavoMourao (1)
  • deepai-lab (1)
  • XuanfengLiuNo1 (1)
  • Sina-Mohammadi (1)
  • iammehdii (1)
  • Spiruel (1)
  • TolgaBkm (1)
  • pallabm22 (1)

Top Pull Request Authors

  • loicland (2)
  • patrontheo (1)
  • LouisStefanuto (1)
  • vict0rsch (1)
  • rahultembhurney (1)

Top Issue Labels

Top Pull Request Labels


Dependencies

code/requirements.txt pypi
  • geopandas *
  • numpy *
  • pandas *
  • torch *

Score: 6.806829360392177