likyoo/open-cd

Introduction

Open-CD is an open source change detection toolbox based on a series of open source general vision task tools.

News

• 4/21/2023 - Open-CD v1.0.0 is released in 1.x branch, based on OpenMMLab 2.0 ! PyTorch 2.0 is also supported ! Enjoy it !
• 3/14/2023 - Open-CD is upgraded to v0.0.3. Semantic Change Detection (SCD) is supported !
• 11/17/2022 - Open-CD is upgraded to v0.0.2, requiring a higher version of the MMSegmentation dependency.
• 9/28/2022 - The code, pre-trained models and logs of ChangerEx are available. 😋
• 9/20/2022 - Our paper Changer: Feature Interaction is What You Need for Change Detection is available!
• 7/30/2022 - Open-CD is publicly available!

Benchmark and model zoo

Supported toolboxes:

• OpenMMLab Toolkits
• pytorch-image-models
• ...

Supported change detection model: (The code of some models are borrowed directly from their official repositories.)

• FC-EF (ICIP'2018)
• FC-Siam-diff (ICIP'2018)
• FC-Siam-conc (ICIP'2018)
• STANet (RS'2020)
• IFN (ISPRS'2020)
• SNUNet (GRSL'2021)
• BiT (TGRS'2021)
• ChangeFormer (IGARSS'22)
• TinyCD (NCA'2023)
• Changer (TGRS'2023)
• TinyCDv2
• ...

Supported datasets: | Descriptions

• LEVIR-CD
• S2Looking
• SVCD
• DSIFN
• CLCD
• RSIPAC
• SECOND
• Landsat
• BANDON
• ...

Usage

Docs

Please refer to get_started.md in mmseg.

A Colab tutorial is also provided. You may directly run on Colab. (thanks to @Agustin for this demo)

simple usage

# Install OpenMMLab Toolkits as Python packages
pip install -U openmim
mim install mmengine
mim install "mmcv>=2.0.0"
mim install "mmpretrain>=1.0.0rc7"
pip install "mmsegmentation>=1.0.0"
pip install "mmdet>=3.0.0"

git clone https://github.com/likyoo/open-cd.git
cd open-cd
pip install -v -e .

train

python tools/train.py configs/changer/changer_ex_r18_512x512_40k_levircd.py --work-dir ./changer_r18_levir_workdir

infer

# get .png results
python tools/test.py configs/changer/changer_ex_r18_512x512_40k_levircd.py  changer_r18_levir_workdir/latest.pth --show-dir tmp_infer
# get metrics
python tools/test.py configs/changer/changer_ex_r18_512x512_40k_levircd.py  changer_r18_levir_workdir/latest.pth

Citation

If you find this project useful in your research, please consider cite:

@ARTICLE{10129139,
  author={Fang, Sheng and Li, Kaiyu and Li, Zhe},
  journal={IEEE Transactions on Geoscience and Remote Sensing}, 
  title={Changer: Feature Interaction is What You Need for Change Detection}, 
  year={2023},
  volume={61},
  number={},
  pages={1-11},
  doi={10.1109/TGRS.2023.3277496}}

License

Open-CD is released under the Apache 2.0 license.