BreizhCrops
A Satellite Time Series Dataset for Crop Type Identification
Science Score: 20.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
○codemeta.json file
-
○.zenodo.json file
-
○DOI references
-
✓Academic publication links
Links to: arxiv.org, mdpi.com -
✓Committers with academic emails
5 of 6 committers (83.3%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (14.1%) to scientific vocabulary
Repository
A Satellite Time Series Dataset for Crop Type Identification
Basic Info
Statistics
- Stars: 205
- Watchers: 7
- Forks: 44
- Open Issues: 15
- Releases: 0
Metadata Files
readme.md
BreizhCrops:
A Time Series Dataset for Crop Type Mapping
Check our Breizhcrops Tutorial Colab Notebook for quick hands-on examples.
Installation
Linux and macOS
Install Breizhcrops as python package from PyPI!
pip install breizhcrops
Windows
If you use Windows, execute these lines.
git clone https://github.com/dl4sits/BreizhCrops.git
pip install torch==1.6.0 -f https://download.pytorch.org/whl/torch_stable.html
conda install gdal fiona geopandas
pip install .
Getting Started
This minimal working example ```python
import package
import breizhcrops as bzh
initialize and download FRH04 data
dataset = bzh.BreizhCrops("frh04")
get data sample
x, y, field_id = dataset[0]
load pretrained model
model = bzh.models.pretrained("Transformer")
create a batch of batchsize 1
x = x.unsqueeze(0)
perform inference
y_pred = model(x) ``` downloads the FRH04 dataset partition (used for evaluation), loads a pretrained model and performs a prediction on the first sample.
Furthermore, for a detailed data analysis you can check the Hands-on Tutorial on Time Series. This is a Jupyter Notebook for timeseries data exploration with BreizhCrops benchmark.
Train a model
Train a model via the example script train.py
bash
python train.py TransformerEncoder --learning-rate 0.001 --weight-decay 5e-08 --preload-ram
This script uses the default model parameters from breizhcrops.models.TransformerModel.
When training multiple epochs, the --preload-ram flag speeds up training significantly
Acknowledgements
The model implementations from this repository are based on the following papers and github repositories.
- TempCNN (reimplementation from keras source code ) Pelletier et al., 2019
- LSTM Recurrent Neural Network adapted from Rußwurm & Körner, 2017
- MS-ResNet implementation from Fei Wang
- TransformerEncoder implementation was originally adopted from Yu-Hsiang Huang GitHub, but later replaced by own implementation when
torch.nn.transformermodules became available - InceptionTime Fawaz et al., 2019
- StarRNN Turkoglu et al., 2019
- OmniscaleCNN Tang et al., 2020
The raw label data originates from
* Registre parcellaire graphique (RPG) of the French National Geographic Institute (IGN)
Reference
This work will be published in the proceedings of ISPRS Archives 2020. Preprint available on ArXiv
@article{breizhcrops2020,
title={BreizhCrops: A Time Series Dataset for Crop Type Mapping},
author={Ru{\ss}wurm, Marc and Pelletier, Charlotte and Zollner, Maximilian and Lef{\`e}vre, S{\'e}bastien and K{\"o}rner, Marco},
journal={International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences ISPRS (2020)},
year={2020}
}
ISPRS virtual congress video can be found here
ICML workshop 2019
A previous version (see workshop website or arxiv version 1) was presented at the presented at the ICML 2019 Time Series workshop, Long Beach, USA ICML workshop contributions do not appear in the ICML proceedings.
Owner
- Name: dl4sits
- Login: dl4sits
- Kind: organization
- Repositories: 2
- Profile: https://github.com/dl4sits
GitHub Events
Total
- Watch event: 12
- Fork event: 3
Last Year
- Watch event: 12
- Fork event: 3
Committers
Last synced: 11 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Marc Rußwurm | m****m@t****e | 155 |
| Maximilian Zollner | m****r@t****e | 44 |
| Charlotte P | c****r@u****r | 8 |
| Marc Rußwurm | m****m@g****e | 7 |
| Marc Russwurm | m****m@e****h | 2 |
| Marco Körner | m****r@t****e | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 11 months ago
All Time
- Total issues: 34
- Total pull requests: 4
- Average time to close issues: 19 days
- Average time to close pull requests: about 9 hours
- Total issue authors: 14
- Total pull request authors: 3
- Average comments per issue: 1.0
- Average comments per pull request: 0.25
- Merged pull requests: 4
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- MarcCoru (15)
- charlotte-pel (4)
- Luffy2Github (3)
- JunwenBai (2)
- gsp2188 (1)
- DivinorWieldor (1)
- burcsuslu (1)
- stienheremans (1)
- wakame1367 (1)
- ec-a (1)
- ankitpatnala (1)
- suredream (1)
- GenghisYoung233 (1)
Pull Request Authors
- maxzoll (2)
- MarcCoru (1)
- charlotte-pel (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 6,883 last-month
- Total dependent packages: 0
- Total dependent repositories: 4
- Total versions: 14
- Total maintainers: 1
pypi.org: breizhcrops
A Satellite Time Series Dataset for Crop Type Identification
- Homepage: http://github.com/dl4sits/breizhcrops
- Documentation: https://breizhcrops.readthedocs.io/
- License: MIT
-
Latest release: 0.0.4.1
published about 4 years ago
Rankings
Maintainers (1)
Dependencies
- geojson >=2.4.1
- geopandas >=0.5.0
- h5py *
- jupyter >=1.0.0
- matplotlib >=3.1.0
- numpy *
- pandas >=0.24.2
- pytest *
- requests *
- scikit-learn *
- seaborn >=0.9.0
- torch >=1.6.0
- tqdm >=4.32.2