Awesome

Detectron2 implementation of STMDA-RetinaNet

This is the implementation of our Computer Vision and Image Understanding 2022 work 'A Multi Camera Unsupervised Domain Adaptation Pipeline for Object Detection in Cultural Sites through Adversarial Learning and Self-Training'. The aim is to reduce the gap between source and target distributions improving the object detector performance on the target domains when training and tests data belong to different distributions.<br> If you want to use this code with your dataset, please follow the following guide. <br> Please leave a star ⭐ and cite the following paper if you use this repository for your project.

@article{PASQUALINO2022103487,
    title = {A multi camera unsupervised domain adaptation pipeline for object detection in cultural sites through adversarial learning and self-training},
    journal = {Computer Vision and Image Understanding},
    pages = {103487},
    year = {2022},
    issn = {1077-3142},
    doi = {https://doi.org/10.1016/j.cviu.2022.103487},
    url = {https://www.sciencedirect.com/science/article/pii/S1077314222000911},
    author = {Giovanni Pasqualino and Antonino Furnari and Giovanni Maria Farinella}
}

Architecture

Step 1

In this step the models is trained using synthetic labeled images (source domain) and unlabeled real images Hololens and GoPro (target domains). At the end of this step, the model is used to produce pseudo label on both Hololens and GoPro images.
<img src='STMDA-RetinaNet-step1.png' width=100%/>

Step 2

In this step the model is trained using synthetic labeled images (source domain) and pseudo label real images Hololens and GoPro (target domains) produced in the previous step. This is an iterative step and at the end of each step we produce better pseudo label on the target domains. <img src='STMDA-RetinaNet-step2.png' width=100%/>

Installation

You can use this repo following one of these three methods:<br> NB: Detectron2 0.2.1 is required, installing other versions this code will not work.

Google Colab

Quickstart here 👉 <br> Or load and run the STMDA-RetinaNet.ipynb on Google Colab following the instructions inside the notebook.

Detectron 2 on your PC

Follow the official guide to install Detectron2 0.2.1<br> Or<br> Download the official Detectron 0.2.1 from here<br> Unzip the file and rename it in detectron2<br> run python -m pip install -e detectron2

Detectron2 via Dockerfile

Follow these instructions:

cd docker/
# Build 
docker build -t detectron2:v0 .

# Launch
docker run --gpus all -it --shm-size=8gb -v /home/yourpath/:/home/yourpath --name=name_container detectron2:v0

If you exit from the container you can restart it using:

docker start name_container
docker exec -it name_container /bin/bash

Dataset

Dataset is available here

Data Preparation

If you want to use this code with your dataset arrange the dataset in the format of COCO. Inside the script stmda_train.py register your dataset using: <br> register_coco_instances("dataset_name_source_training",{},"path_annotations","path_images")<br> register_coco_instances("dataset_name_init_target_training",{},"path_annotations","path_images")<br> register_coco_instances("dataset_name_init_target2_training",{},"path_annotations","path_images")<br><br>

these are the paths where will be saved the annotations produced at the end of the step 1<br> register_coco_instances("dataset_name_target_training",{},"path_annotations","path_images")<br> register_coco_instances("dataset_name_target2_training",{},"path_annotations","path_images")<br><br>

register_coco_instances("dataset_name_target_test",{},"path_annotations","path_images")<br> register_coco_instances("dataset_name_target_test2",{},"path_annotations","path_images")<br>

Training

Replace at the following path detectron2/modeling/meta_arch/ the retinanet.py script with our retinanet.py. <br> Do the same for the fpn.py file at the path detectron2/modeling/backbone/, evaltuator.py and coco_evaluation.py at detectron2/evaluation/<br> Inside the script stmda_train.py you can set the parameters for the second step training like number of iteration and threshold.<br> Run the script stmda_train.py <br> Trained models are available at these links: <br> MDA-RetinaNet<br> STMDA-RetinaNet <br> <br> MDA-RetinaNet-CycleGAN<br> STMDA-RetinaNet-CycleGAN

Testing

If you want to test the model load the new weights, set to 0 the number of iterations and run stmda_train.py

Results

Other Works

DA-RetinaNet <br> Detectron2 implementation of DA-Faster RCNN