Skip to content

πŸ›°οΈ Learning to Aggregate Multi-Scale Context for Instance Segmentation in Remote Sensing Images (TNNLS 2024)

License

Notifications You must be signed in to change notification settings

yeliudev/CATNet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Context Aggregation Network

arXiv License

This repository maintains the official implementation of the paper Learning to Aggregate Multi-Scale Context for Instance Segmentation in Remote Sensing Images by Ye Liu, Huifang Li, Chao Hu, Shuang Luo, Yan Luo, and Chang Wen Chen, which has been accepted by TNNLS.

Installation

Please refer to the following environmental settings that we use. You may install these packages by yourself if you meet any problem during automatic installation.

Install from source

  1. Clone the repository from GitHub.
git clone https://github.com/yeliudev/CATNet.git
cd CATNet
  1. Install dependencies.
pip install -r requirements.txt
  1. Set environment variable
export PYTHONPATH=$PWD:$PYTHONPATH

Getting Started

Download and prepare the datasets

  1. Download the pre-processed datasets.
  1. Prepare the files in the following structure.
CATNet
β”œβ”€β”€ configs
β”œβ”€β”€ datasets
β”œβ”€β”€ models
β”œβ”€β”€ tools
β”œβ”€β”€ data
β”‚   β”œβ”€β”€ dior
β”‚   β”‚   β”œβ”€β”€ Annotations
β”‚   β”‚   β”œβ”€β”€ ImageSets
β”‚   β”‚   └── JPEGImages
β”‚   β”œβ”€β”€ hrsid
β”‚   β”‚   β”œβ”€β”€ annotations
β”‚   β”‚   └── images
β”‚   β”œβ”€β”€ isaid
β”‚   β”‚   β”œβ”€β”€ train
β”‚   β”‚   β”œβ”€β”€ val
β”‚   β”‚   └── test
β”‚   └── vhr
β”‚       β”œβ”€β”€ annotations
β”‚       └── images
β”œβ”€β”€ README.md
β”œβ”€β”€ setup.cfg
└── Β·Β·Β·

Train a model

Run the following command to train a model using a specified config.

mim train mmdet <path-to-config> --gpus 4 --launcher pytorch

If an out-of-memory error occurs on iSAID dataset, please uncomment L22-L24 in the dataset code and try again. This will filter out a few images with more than 1,000 objects, largely reducing the memory cost.

Test a model and evaluate results

Run the following command to test a model and evaluate results.

mim test mmdet <path-to-config> --checkpoint <path-to-checkpoint> --gpus 4 --launcher pytorch

Model Zoo

We provide multiple pre-trained models here. All the models are trained using 4 NVIDIA A100 GPUs and are evaluated using the default metrics of the datasets.

Dataset Model Backbone Schd Aug Performance Download
BBox AP Mask AP
iSAID CAT Mask R-CNN ResNet-50 3x βœ— 45.1 37.2 model | metrics
CAT Mask R-CNN ResNet-50 3x βœ“ 47.7 39.2 model | metrics
DIOR CATNet ResNet-50 3x βœ— 74.0 β€” model | metrics
CATNet ResNet-50 3x βœ“ 78.2 β€” model | metrics
CAT R-CNN ResNet-50 3x βœ— 75.8 β€” model | metrics
CAT R-CNN ResNet-50 3x βœ“ 80.6 β€” model | metrics
NWPU
VHR-10
CAT Mask R-CNN ResNet-50 6x βœ— 71.0 69.3 model | metrics
CAT Mask R-CNN ResNet-50 6x βœ“ 72.4 70.7 model | metrics
HRSID CAT Mask R-CNN ResNet-50 6x βœ— 70.9 57.6 model | metrics
CAT Mask R-CNN ResNet-50 6x βœ“ 72.0 59.6 model | metrics

Citation

If you find this project useful for your research, please kindly cite our paper.

@article{liu2024learning,
  title={Learning to Aggregate Multi-Scale Context for Instance Segmentation in Remote Sensing Images},
  author={Liu, Ye and Li, Huifang and Hu, Chao and Luo, Shuang and Luo, Yan and Chen, Chang Wen},
  journal={IEEE Transactions on Neural Networks and Learning Systems},
  year={2024}
}

About

πŸ›°οΈ Learning to Aggregate Multi-Scale Context for Instance Segmentation in Remote Sensing Images (TNNLS 2024)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages