Skip to content

patrontheo/pastis-benchmark

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌾 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. drawing

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.

About

Fork of pastis benchmark to submit PR

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Jupyter Notebook 90.8%
  • Python 9.2%