Science Score: 46.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 11 DOI reference(s) in README
  • Academic publication links
    Links to: arxiv.org, sciencedirect.com, zenodo.org
  • Committers with academic emails
    1 of 4 committers (25.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.9%) to scientific vocabulary
Last synced: 7 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: VSainteuf
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 14.8 MB
Statistics
  • Stars: 239
  • Watchers: 7
  • Forks: 44
  • Open Issues: 6
  • Releases: 0
Created almost 5 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

:earofrice: PASTIS :earofrice: 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

:arrowforward: 2,433 time series | :arrowforward: 124,422 individual parcels | :arrowforward: 18 crop types
:-------------------------------------------- | :-------------------------------------------------- | :------------------------------ :arrow
forward: 128x128 pixels / images | :arrowforward: 38-61 acquisitions / series | :arrowforward: 10m / pixel :arrowforward: 10 spectral bands | :arrowforward: covers ~4,000 km² | :arrow_forward: over 2B pixels

  • :satellite: 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 :beetle: 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%| :heavycheckmark: link| | U-TAE | 1.1M| 83.2% | 63.1%| :heavycheckmark: link| | Unet-3d* | 1.6M| 81.3% | 58.4%| :heavycheckmark: link| | Unet-ConvLSTM* |1.5M | 82.1% | 57.8%| :heavycheckmark: link| | FPN-ConvLSTM* | 1.3M| 81.6% | 57.1%|:heavycheckmark: 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%| :heavycheckmark: link| | S1+S2 U-TAE (early fusion)| 1.6M| 83.8% | 65.9% | :heavycheckmark: link|


Panoptic Segmentation

Optical only (PASTIS)

| Model name | #Params| SQ | RQ | PQ| Published | | ------------------ |--- |--- | --- |--- |--- | | U-TAE + PaPs |1.3M | 81.5|53.2 |43.8| :heavycheckmark: link| | U-ConvLSTM + PaPs |1.7M | 80.2 |43.9 |35.6 | :heavycheckmark: 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|:heavycheckmark: link| | S1+S2 U-TAE + PaPs (late fusion) | 2.4M | 81.6 |50.5 |41.6 |:heavycheckmark: 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.

Owner

  • Login: VSainteuf
  • Kind: user

GitHub Events

Total
  • Watch event: 45
  • Issue comment event: 2
  • Fork event: 4
Last Year
  • Watch event: 45
  • Issue comment event: 2
  • Fork event: 4

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 46
  • Total Committers: 4
  • Avg Commits per committer: 11.5
  • Development Distribution Score (DDS): 0.152
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
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 (Top 20 + Academic)

Issues and Pull Requests

Last synced: 7 months ago

All Time
  • Total issues: 22
  • 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: 2.05
  • Average comments per pull request: 0.33
  • Merged pull requests: 4
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • isaaccorley (2)
  • long123524 (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)
  • nazib (1)
  • pallabm22 (1)
Pull Request Authors
  • loicland (2)
  • LouisStefanuto (2)
  • patrontheo (1)
  • vict0rsch (1)
  • rahultembhurney (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

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