https://github.com/prs-eth/odecrop
[TGRS21] Crop Classification under Varying Cloud Cover with Neural Ordinary Differential Equations
https://github.com/prs-eth/odecrop
differential-equations gru lstm node ode ode-model rnn
Last synced: about 1 year ago
JSON representation
[TGRS21] Crop Classification under Varying Cloud Cover with Neural Ordinary Differential Equations
- Host: GitHub
- URL: https://github.com/prs-eth/odecrop
- Owner: prs-eth
- Created: 2020-02-13T14:10:48.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-03-30T07:08:43.000Z (about 4 years ago)
- Last Synced: 2025-03-24T18:11:22.722Z (about 1 year ago)
- Topics: differential-equations, gru, lstm, node, ode, ode-model, rnn
- Language: Python
- Homepage:
- Size: 528 MB
- Stars: 24
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Crop Classification under Varying Cloud Cover with Neural Ordinary Differential Equations
This is a Pytorch implementation of NODE for crop mapping task described in
[Nando Metzger, Mehmet Ozgur Turkoglu, Stefano D'Aronco, Jan Dirk Wegner, and Konrad Schindler. "Crop classification under varying cloud cover with neural ordinary differential equations." IEEE Transactions on Geoscience and Remote Sensing (2021).](https://arxiv.org/pdf/2012.02542.pdf)
## โ๏ธ ๐ Citation
If you find our work useful in your research, please consider citing our paper:
```bash
@article{metzger2021crop,
title={Crop classification under varying cloud cover with neural ordinary differential equations},
author={Metzger, Nando and Turkoglu, Mehmet Ozgur and D'Aronco, Stefano and Wegner, Jan Dirk and Schindler, Konrad},
journal={IEEE Transactions on Geoscience and Remote Sensing},
year={2021},
publisher={IEEE}
}
```
## ๐ Overview
RNNs are not very happy with irregulary sampled time series since they do not have explicit notion of time by definition.

In remote sensing and Earth observation we often have data gaps which translates irregular time series not only due to clouds, but also caused by irregular acquisition patterns in space or time, sensor failures and replacements, transmission limits, etc. For instance, we show below examples of Sentinel-2 time series data from TUM dataset (left for winter wheat, right for corn). Observations obscured
by clouds are marked in blue at the bottom. Note their irregular distribution.

Illustration of the hidden state dynamics for traditional RNNs (left) and for the ODE-RNN model (right).

## ๐งต Setup
We use a Conda environment that makes it easy to install all dependencies. Our code has been tested on Ubuntu 20.04 with PyTorch xx and CUDA xx.
1. Install [miniconda](https://docs.conda.io/en/latest/miniconda.html) with Python 3.8.
2. Create the conda environment: ```conda env create -f environment.yml```
3. Activate the environment: ```conda activate node```
## ๐ Getting Started
### Evaluate pre-trained model
coming soon
### Train yourself
coming soon