/DeepCropMapping

Official implementation of "DeepCropMapping: A multi-temporal deep learning approach with improved spatial generalizability for dynamic corn and soybean mapping".

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

DeepCropMapping: A multi-temporal deep learning approach with improved spatial generalizability for dynamic corn and soybean mapping

This repository is the official implementation of DeepCropMapping: A multi-temporal deep learning approach with improved spatial generalizability for dynamic corn and soybean mapping.

Requirements

  • torch
  • numpy
  • pandas
  • scikit-learn
  • jupyter

The code has been tested in the following environment: Ubuntu 16.04.4 LTS, Python 3.5.2, PyTorch 1.2.0

Data

The preprocessed data (.npy files) for model training and evaluation is not directly provided here due to the large data volume. You can download raw Landsat Analysis Ready Data (ARD) from EarthExplore and raw Cropland Data Layer (CDL) from CropScape, then follow the code in the preprocessing folder to generate the .npy files. The raw Landsat ARD and CDL data should be stored in a new data folder that has the following structure (specific downloaded file names may change):

data
├── Site_A
│   ├── ARD
│   │   ├── 2015
│   │   │   ├── LC08_CU_018007_20150424_20181206_C01_V01_PIXELQA.tif
│   │   │   ├── LC08_CU_018007_20150424_20181206_C01_V01_SRB2.tif
│   │   │   └── . . .
│   │   ├── . . .
│   │   └── 2018
│   └── CDL
│       ├── CDL_2015_clip_20190409130240_375669680.tif
│       ├── . . .
│       └── CDL_2018_clip_20190409125506_12566268.tif
├── Site_B
├── . . .
└── Site_F

The preprocessed data should be stored in the preprocessing/out folder that has the following structure:

preprocessing/out
├── Site_A
│   ├── x-2015.npy
│   ├── y-2015.npy
│   ├── . . .
│   ├── x-2018.npy
│   └── y-2018.npy
├── Site_B
├── . . .
└── Site_F

Training and evaluation

  • The PyTorch implementation of DeepCropMapping (DCM) model is located in the models folder.
  • The utils folder contains some utilities that are used for data loading, normalization, training and evluation.

The specific training and evaluation process can be executed by running the .ipynb files in the experiments folder.

The hyperparameters for different sites in the paper are set as follows:

Hyperparameter Site A Site B Site C Site D Site E Site F
Dimension of LSTM hidden features 256 512 256 512 256 256
Number of LSTM layers 2 2 2 2 2 3