Skip to content
/ OSSOD Public

[JAG2024] Code for "Semi-Supervised Object Detection with Uncurated Unlabeled Data for Remote Sensing Images"

Notifications You must be signed in to change notification settings

Lans1ng/OSSOD

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Semi-Supervised Object Detection with Uncurated Unlabeled Data for Remote Sensing Images

💥 News

The paper is accepted by International Journal of Applied Earth Observation and Geoinformation (JAG) and is accessible here.

📖 Introduction

Semi-supervised object detection (SSOD) assumes that both labeled and unlabeled data originate from the same label space, constituting in-distribution (ID) samples. Open-set semi-supervised object detection (OSSOD) accommodates the existence of substantial out-of-distribution (OOD) samples, mirroring the complexities of real-world scenarios.

🎨 Overview

Overview of the proposed open-set semi-supersvised object detection (OSSOD) framework.

🎮 Getting Started

1. Install Environment

conda create --name ossod python=3.8
conda activate ossod

pip install torch===1.7.1+cu110 torchvision===0.8.2+cu110 torchaudio===0.7.2 -f https://download.pytorch.org/whl/torch_stable.html --no-cache

git clone https://github.com/Lans1ng/OSSOD.git
cd OSSOD
pip install -r requirements.txt

2. Prepare Dataset

  • Download the DIOR dataset (Google Drive or BaiduNetDisk)

  • Organize the dataset as follow:

    dataset/
    ├──DIOR/
    │   ├── annotations_json_split1
    │   ├── annotations_json_split2
    │   ├── JPEGImages
    │   │   ├── 00001.jpg
    │   │   ├── 00002.jpg
    │   │   ├── ...
    │   │   ├── 23463.jpg
    • JPEGImages represents all images in DIOR dataset
    • Annotations for split1 and split2 are already included in the repo.

3. Download Checkpoints

Before training,please download the pretrained backbone (ResNet-50) to pretrained_model/backbone.

4. Training

Take split1 of the DIOR dataset as examples:

  • Use in-distribution (ID) labeled data to train a baseline
python train.py --config configs/baseline/baseline_ssod_split1.py --work-dir work_dirs/split1/baseline_ssod --base_stage True
  • Use unlabeled data to train semi-supervised detector:

    • Train detectors with ID unlabeled data
    #unbiased teacher
    python train.py --config configs/unbiased_teacher/split1/unbiased_teacher_id.py --work-dir work_dirs/split1/unbiased_teacher_ID 
    
    #our proposed ossod
    python train.py --config configs/unbiased_teacher/split1/unbiased_teacher_ossod_id.py --work-dir work_dirs/split1/unbiased_teacher_ossod_ID
    • Train detectors with ID and mixed unlabeled data
    #unbiased teacher
    python train.py --config configs/unbiased_teacher/split1/unbiased_teacher_id_mix.py --work-dir work_dirs/split1/unbiased_teacher_ID_MIX 
    
    #our proposed ossod
    python train.py --config configs/unbiased_teacher/split1/unbiased_teacher_ossod_id_mix.py --work-dir work_dirs/split1/unbiased_teacher_ossod_ID_MIX
    • Train detectors with ID, mixed and out-of-distribution (OOD) unlabeled data
    #unbiased teacher
    python train.py --config configs/unbiased_teacher/split1/unbiased_teacher_id_mix_ood.py --work-dir work_dirs/split1/unbiased_teacher_ID_MIX_OOD 
    
    #our proposed ossod
    python train.py --config configs/unbiased_teacher/split1/unbiased_teacher_ossod_id_mix_ood.py --work-dir work_dirs/split1/unbiased_teacher_ossod_ID_MIX_OOD

5. Testing

Take split1 of the DIOR dataset as examples:

python eval.py --config configs/unbiased_teacher/split1/unbiased_teacher_ossod_id_mix_ood.py --checkpoint work_dirs/split1/unbiased_teacher_ossod_ID_MIX_OODlatest.pth --eval mAP  --show-dir results

💡 Acknowledgement

🖊️ Citation

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

@article{liu2024semi,
  title={Semi-Supervised Object Detection with Uncurated Unlabeled Data for Remote Sensing Images},
  author={Liu, Nanqing and Xu, Xun and Gao, Yingjie and Zhao, Yitao and Li, Heng-Chao},
  journal={International Journal of Applied Earth Observation and Geoinformation},
  year={2024}
}

About

[JAG2024] Code for "Semi-Supervised Object Detection with Uncurated Unlabeled Data for Remote Sensing Images"

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages