{"id":13784900,"url":"https://github.com/likyoo/BAN","last_synced_at":"2025-05-11T20:31:18.136Z","repository":{"id":210423703,"uuid":"724385019","full_name":"likyoo/BAN","owner":"likyoo","description":"The pytorch implementation for \"A New Learning Paradigm for Foundation Model-based Remote Sensing Change Detection\"","archived":false,"fork":false,"pushed_at":"2024-04-10T01:06:13.000Z","size":723,"stargazers_count":75,"open_issues_count":5,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-17T21:39:11.976Z","etag":null,"topics":["change-detection","computer-vision","deep-learning","remote-sensing-image"],"latest_commit_sha":null,"homepage":"https://arxiv.org/abs/2312.01163","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":"2023-11-28T01:01:11.000Z","updated_at":"2024-10-23T07:24:23.000Z","dependencies_parsed_at":"2024-01-13T03:27:57.254Z","dependency_job_id":"4837a7c5-4022-4f8a-8042-af0d396b2964","html_url":"https://github.com/likyoo/BAN","commit_stats":{"total_commits":31,"total_committers":1,"mean_commits":31.0,"dds":0.0,"last_synced_commit":"b2e835432ea78551e7f3f4bf63bdda87b200632d"},"previous_names":["likyoo/ban"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2FBAN","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2FBAN/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2FBAN/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/likyoo%2FBAN/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/likyoo","download_url":"https://codeload.github.com/likyoo/BAN/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253631982,"owners_count":21939369,"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":["change-detection","computer-vision","deep-learning","remote-sensing-image"],"created_at":"2024-08-03T19:00:53.815Z","updated_at":"2025-05-11T20:31:17.489Z","avatar_url":"https://github.com/likyoo.png","language":"Python","funding_links":[],"categories":["Multispectral"],"sub_categories":["Deep Learning"],"readme":"# BAN\n\nOfficial implementation for the paper [\"A New Learning Paradigm for Foundation Model-based Remote Sensing Change Detection\"](https://arxiv.org/abs/2312.01163), the code is developed on top of [Open-CD v1.1.0](https://github.com/likyoo/open-cd/tree/f05e7fdfe1e0f9a9afa9d6c063ea03b43345226e).\n\n## News\n- 2/10/2024 - BAN is supported in [Open-CD](https://github.com/likyoo/open-cd). :yum:\n\n## Usage\n\n### Install\n\n- Create a conda virtual environment and activate it:\n\n```bash\nconda create -n BAN python=3.8 -y\nconda activate BAN\n```\n\n- Install `PyTorch` and `torchvision` :\n\nFor examples, to install torch==2.0.0 with CUDA==11.8:\n\n```bash\npip install torch==2.0.0 torchvision==0.15.1 torchaudio==2.0.1 --index-url https://download.pytorch.org/whl/cu118\n```\n\n- Install `OpenMMLab` Toolkits as Python packages:\n\n```bash\npip install -U openmim\nmim install mmengine==0.10.1\nmim install mmcv==2.1.0\nmim install mmpretrain==1.1.1\npip install mmsegmentation==1.2.2\npip install mmdet==3.2.0\n```\n\n- Install Open-CD\n\n```bash\ngit clone https://github.com/likyoo/open-cd.git\ncd open-cd\npip install -v -e .\ncd ..\n```\n\n- Install other requirements:\n\n```bash\npip install ftfy regex\n```\n\n- Clone this repo:\n\n```bash\ngit clone https://github.com/likyoo/BAN.git\ncd BAN\n```\n\n### Data Preparation\n\nDownload datasets ([LEVIR-CD](https://justchenhao.github.io/LEVIR/), [S2Looking](https://github.com/S2Looking/Dataset), [BANDON](https://github.com/fitzpchao/BANDON), [WHU-CD](https://study.rsgis.whu.edu.cn/pages/download/building_dataset.html))  and move (or link) them to `BAN/data`.\n\n\n### Evaluation\n\nTo evaluate our `BAN` on LEVIR-CD test, run:\n\n```bash\npython test.py \u003cconfig-file\u003e \u003ccheckpoint\u003e\n```\n\nYou can download checkpoint files from [huggingface](https://huggingface.co/likyoo/BAN/tree/main/checkpoint) | [baidu disk](https://pan.baidu.com/s/1RkIGsOB3XBi7Oi6mKIpZ2w?pwd=kfp9).\n\nFor example, to evaluate the `BAN-vit-l14-clip_mit-b0` with a single GPU:\n\n```bash\npython test.py configs/ban/ban_vit-l14-clip_mit-b0_512x512_40k_levircd.py checkpoint/ban_vit-l14-clip_mit-b0_512x512_40k_levircd.pth\n```\n\n### Training\n\nTo train the `BAN`, run:\n\n```bash\npython train.py \u003cconfig-file\u003e\n```\n\nFor example, to train the `BAN-vit-l14-clip_mit-b0` with a single GPU on LEVIR-CD, run:\n\n```bash\npython train.py configs/ban/ban_vit-l14-clip_mit-b0_512x512_40k_levircd.py\n```\n\n**Note**: You can download pretrained files from [huggingface](https://huggingface.co/likyoo/BAN/tree/main/pretrain) | [baidu disk](https://pan.baidu.com/s/1RkIGsOB3XBi7Oi6mKIpZ2w?pwd=kfp9).\n\n\n### Citation\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flikyoo%2FBAN","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flikyoo%2FBAN","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flikyoo%2FBAN/lists"}