{"id":13784821,"url":"https://github.com/likyoo/open-cd","last_synced_at":"2026-01-02T13:59:45.132Z","repository":{"id":51445254,"uuid":"519390178","full_name":"likyoo/open-cd","owner":"likyoo","description":"A Change Detection Repo Standing on the Shoulders of Giants","archived":false,"fork":false,"pushed_at":"2025-04-11T11:37:54.000Z","size":482,"stargazers_count":657,"open_issues_count":84,"forks_count":83,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-11T12:08:00.906Z","etag":null,"topics":["bit","change-detection","changer","deep-learning","pytorch","transformer"],"latest_commit_sha":null,"homepage":"https://arxiv.org/abs/2407.15317","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/likyoo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-30T01:30:48.000Z","updated_at":"2025-04-11T11:37:58.000Z","dependencies_parsed_at":"2024-07-09T10:03:12.078Z","dependency_job_id":"617eea5b-b3ba-4fd4-97b6-6326e983b2e7","html_url":"https://github.com/likyoo/open-cd","commit_stats":{"total_commits":111,"total_committers":3,"mean_commits":37.0,"dds":"0.027027027027026973","last_synced_commit":"f05e7fdfe1e0f9a9afa9d6c063ea03b43345226e"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2Fopen-cd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2Fopen-cd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2Fopen-cd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2Fopen-cd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/likyoo","download_url":"https://codeload.github.com/likyoo/open-cd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253631982,"owners_count":21939370,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bit","change-detection","changer","deep-learning","pytorch","transformer"],"created_at":"2024-08-03T19:00:52.981Z","updated_at":"2026-01-02T13:59:45.126Z","avatar_url":"https://github.com/likyoo.png","language":"Python","funding_links":[],"categories":["Multispectral","SECOND Dataset"],"sub_categories":["Deep Learning"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"resources/opencd-logo.png\" width=\"600\"/\u003e\n\u003c/div\u003e\n\n------\n\n\u003cfont size=4\u003e\u003cdiv align='center' \u003e \n[[🤗Paper](https://arxiv.org/abs/2407.15317)] | [[🤗Code](https://github.com/likyoo/open-cd)] | [[🤗Checkpoint](https://huggingface.co/likyoo/Open-CD_Model_Zoo)] | [[🤗Video](https://www.youtube.com/watch?v=6Yt9g-vS_FU\u0026t=4s)]\u003c/div\u003e\u003c/font\u003e\n\n## Introduction\nOpen-CD is an open source change detection toolbox based on a series of open source general vision task tools.\n\n\n## News\n- 7/25/2025 - Open-CD Technical Report is accepted by ACMMM 2025. 🎉\n- 4/11/2025 - [MTKD](https://github.com/circleLZY/MTKD-CD) method and [JL1-CD](https://github.com/circleLZY/MTKD-CD) dataset are supported. Open-CD Technical Report is updated to v1.1.\n- 7/23/2024 - **Open-CD Technical Report v1.0 is released on [arXiv](https://arxiv.org/abs/2407.15317), thanks to all contributors! Feel free to join us!** 💥💥💥\n- 6/29/2024 - [ChangeStar](https://github.com/Z-Zheng/ChangeStar) and [FarSeg](https://github.com/Z-Zheng/FarSeg) are supported.\n- 6/20/2024 - We launch the **[Open-CD Technical Report Plan](https://github.com/likyoo/open-cd/tree/main/projects/open-cd_technical_report)**, don't hesitate to join us!!! 💥💥💥\n- 6/17/2024 - [CGNet](https://github.com/ChengxiHAN/CGNet-CD) is supported.\n- 2/10/2024 - Open-CD is upgraded to v1.1.0. [BAN](https://github.com/likyoo/BAN), [TTP](https://github.com/KyanChen/TTP) and [LightCDNet](https://github.com/NightSongs/LightCDNet) is supported. The inference API is added.\n- 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 !\n- 3/14/2023 - Open-CD is upgraded to v0.0.3. Semantic Change Detection (SCD) is supported !\n- 11/17/2022 - Open-CD is upgraded to v0.0.2, requiring a higher version of the MMSegmentation dependency.\n- 9/28/2022 - The code, pre-trained models and logs of [ChangerEx](https://github.com/likyoo/open-cd/tree/main/configs/changer) are available. :yum:\n- 9/20/2022 - Our paper [Changer: Feature Interaction is What You Need for Change Detection](https://arxiv.org/abs/2209.08290) is available!\n- 7/30/2022 - Open-CD is publicly available!\n\n## Benchmark and model zoo\n\nSupported toolboxes:\n\n- [x] [OpenMMLab Toolkits](https://github.com/open-mmlab)\n- [x] [pytorch-image-models](https://github.com/rwightman/pytorch-image-models)\n- [ ] ...\n\nSupported change detection model:\n(_The code of some models are borrowed directly from their official repositories._)\n\n- [x] [FC-EF (ICIP'2018)](configs/fcsn)\n- [x] [FC-Siam-diff (ICIP'2018)](configs/fcsn)\n- [x] [FC-Siam-conc (ICIP'2018)](configs/fcsn)\n- [x] [STANet (RS'2020)](configs/stanet)\n- [x] [IFN (ISPRS'2020)](configs/ifn)\n- [x] [SNUNet (GRSL'2021)](configs/snunet)\n- [x] [BiT (TGRS'2021)](configs/bit)\n- [x] [ChangeStar (ICCV'2021)](configs/changestar)\n- [x] [ChangeFormer (IGARSS'22)](configs/changeformer)\n- [x] [TinyCD (NCA'2023)](configs/tinycd)\n- [x] [Changer (TGRS'2023)](configs/changer)\n- [x] [HANet (JSTARS'2023)](configs/hanet)\n- [x] [TinyCDv2 (Under Review)](configs/tinycd_v2)\n- [x] [LightCDNet (GRSL'2023)](configs/lightcdnet)\n- [x] [CGNet (JSTARS'2023)](configs/cgnet)\n- [x] [BAN (TGRS'2024)](configs/ban)\n- [x] [TTP (arXiv'2023)](configs/ttp)\n- [x] [MTKD (arXiv'2025)](configs/mtkd)\n- [ ] ...\n\nSupported datasets: | [Descriptions](https://github.com/wenhwu/awesome-remote-sensing-change-detection)\n- [x] [LEVIR-CD](https://justchenhao.github.io/LEVIR/)\n- [x] [WHU-CD](https://study.rsgis.whu.edu.cn/pages/download/building_dataset.html)\n- [x] [S2Looking](https://github.com/S2Looking/Dataset)\n- [x] [SVCD](https://drive.google.com/file/d/1GX656JqqOyBi_Ef0w65kDGVto-nHrNs9/edit)\n- [x] [DSIFN](https://github.com/GeoZcx/A-deeply-supervised-image-fusion-network-for-change-detection-in-remote-sensing-images/tree/master/dataset)\n- [x] [CLCD](https://github.com/liumency/CropLand-CD)\n- [x] [RSIPAC](https://engine.piesat.cn/ai/autolearning/index.html#/dataset/detail?key=8f6c7645-e60f-42ce-9af3-2c66e95cfa27)\n- [x] [SECOND](https://captain-whu.github.io/SCD/)\n- [x] [Landsat](https://figshare.com/articles/figure/Landsat-SCD_dataset_zip/19946135/1)\n- [x] [BANDON](https://github.com/fitzpchao/BANDON)\n- [x] [JL1-CD](https://github.com/circleLZY/MTKD-CD)\n- [ ] ...\n\n## Usage\n\n[Docs](https://github.com/open-mmlab/mmsegmentation/tree/master/docs)\n\nPlease refer to [get_started.md](https://github.com/open-mmlab/mmsegmentation/blob/master/docs/en/get_started.md#installation) in mmseg.\n\nA Colab tutorial is also provided. You may directly run on [Colab](https://colab.research.google.com/drive/1puZY5R8fwlL6um6pHbgbM1NTYZUXdK2J?usp=sharing). (thanks to [@Agustin](https://github.com/AgustinNormand) for this demo) [![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1puZY5R8fwlL6um6pHbgbM1NTYZUXdK2J?usp=sharing)\n\n#### Install\n\n```\n# Install OpenMMLab Toolkits as Python packages\npip install -U openmim\nmim install mmengine\nmim install \"mmcv\u003e=2.0.0\"\nmim install \"mmpretrain\u003e=1.0.0rc7\"\npip install \"mmsegmentation\u003e=1.2.2\"\npip install \"mmdet\u003e=3.0.0\"\n```\n```\ngit clone https://github.com/likyoo/open-cd.git\ncd open-cd\npip install -v -e .\n```\nFor more details, please see [here](https://github.com/likyoo/open-cd/blob/main/docs/install.md).\n\n#### Train\n```\npython tools/train.py configs/changer/changer_ex_r18_512x512_40k_levircd.py --work-dir ./changer_r18_levir_workdir\n```\n\n#### Test\n```\n# get .png results\npython tools/test.py configs/changer/changer_ex_r18_512x512_40k_levircd.py changer_r18_levir_workdir/latest.pth --show-dir tmp_infer\n# get metrics\npython tools/test.py configs/changer/changer_ex_r18_512x512_40k_levircd.py changer_r18_levir_workdir/latest.pth\n```\n\n#### Infer\nPlease refer [inference](https://github.com/likyoo/open-cd/blob/main/docs/inference.md) doc.\n\n\n## Citation\n\nIf you find this project useful in your research, please cite:\n\n```bibtex\n@inproceedings{opencd,\n  title   = {Open-cd: A comprehensive toolbox for change detection},\n  author  = {Li, Kaiyu and Jiang, Jiawei and Codegoni, Andrea and Han, Chengxi and Deng, Yupeng and Chen, Keyan and Zheng, Zhuo and\n             Chen, Hao and Liu, Ziyuan and Gu, Yuantao and Zou, Zhengxia and Shi, Zhenwei and Fang, Sheng and Meng, Deyu and Wang, Zhi and Cao, Xiangyong},\n  booktitle={Proceedings of the 33rd ACM International Conference on Multimedia},\n  pages={13608--13612},\n  year={2025}\n}\n```\nYou might also consider citing:\n\n```bibtex\n@ARTICLE{10438490,\n  author={Li, Kaiyu and Cao, Xiangyong and Meng, Deyu},\n  journal={IEEE Transactions on Geoscience and Remote Sensing}, \n  title={A New Learning Paradigm for Foundation Model-based Remote Sensing Change Detection}, \n  year={2024},\n  volume={},\n  number={},\n  pages={1-1},\n  keywords={Adaptation models;Task analysis;Data models;Computational modeling;Feature extraction;Transformers;Tuning;Change detection;foundation model;visual tuning;remote sensing image processing;deep learning},\n  doi={10.1109/TGRS.2024.3365825}}\n\n@ARTICLE{10129139,\n  author={Fang, Sheng and Li, Kaiyu and Li, Zhe},\n  journal={IEEE Transactions on Geoscience and Remote Sensing}, \n  title={Changer: Feature Interaction is What You Need for Change Detection}, \n  year={2023},\n  volume={61},\n  number={},\n  pages={1-11},\n  doi={10.1109/TGRS.2023.3277496}}\n```\n\n## License\n\nOpen-CD is released under the Apache 2.0 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flikyoo%2Fopen-cd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flikyoo%2Fopen-cd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flikyoo%2Fopen-cd/lists"}