Fix placeholders and add citation

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +216 -197
README.md CHANGED
@@ -1,197 +1,216 @@
1
- ---
2
- license: apache-2.0
3
- pipeline_tag: image-segmentation
4
- tags:
5
- - infrared-small-target-detection
6
- - multimodal
7
- - vision-language
8
- - pytorch
9
- ---
10
-
11
-
12
- <h1>ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection</h1>
13
-
14
- <p>
15
- <b>Tongtong Wang</b><sup>1</sup>&nbsp;
16
- <b>Mingzhu Xu</b><sup>1βœ‰</sup>&nbsp;
17
- <b>Chenglong Yu</b><sup>1</sup>&nbsp;
18
- <b>Jing Wang</b><sup>1</sup>&nbsp;
19
- <b>Xiaohui Lin</b><sup>1</sup>&nbsp;
20
- <b>Weili Guan</b><sup>2</sup>
21
- </p>
22
-
23
- <p>
24
- <sup>1</sup>School of Software, Shandong University<br>
25
- <sup>2</sup>Harbin Institute of Technology, Shenzhen<br>
26
- <sup>βœ‰</sup>Corresponding author
27
- </p>
28
-
29
- <p>
30
- <a href="<paper-link>">
31
- <img src="https://img.shields.io/badge/ACM%20MM-2026-blue" alt="ACM MM 2026">
32
- </a>
33
- <a href="https://github.com/iLearn-Lab/MM26-ADGNet">
34
- <img src="https://img.shields.io/badge/GitHub-MM26--ADGNet-black?logo=github" alt="GitHub">
35
- </a>
36
- </p>
37
-
38
- ## πŸ“– Model Description
39
-
40
- This repository provides the official model checkpoints for **ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection**, accepted by **ACM Multimedia 2026**.
41
-
42
- Infrared Small Target Detection aims to accurately segment weak and tiny targets from complex infrared backgrounds. Existing pure-vision methods rely mainly on pixel-level information, while existing vision-language methods commonly describe targets and backgrounds using a single textual prompt. Such a symmetric design overlooks the inherent semantic differences between sparse infrared targets and structurally complex backgrounds.
43
-
44
- ADGNet addresses this problem through three main components:
45
-
46
- - **Asymmetric Dual-text Prompt (ADP):** uses an abstract, image-independent target prompt and a detailed, image-dependent background prompt.
47
- - **Asymmetric Dual-Branch Interaction (ADBI):** independently performs target localization and background suppression using their corresponding textual priors.
48
- - **Adaptive Feature Aggregation (AFA):** dynamically fuses target-enhanced and background-suppressed features for accurate segmentation.
49
-
50
- The model uses the pretrained **CLIP ViT-B/16** text encoder to extract semantic representations from the target and background prompts.
51
-
52
- ---
53
-
54
- ## πŸ† Available Checkpoints
55
-
56
- All ADGNet checkpoints are hosted in this Hugging Face model repository.
57
-
58
- Download the required checkpoint directly from the **Files and versions** section of this repository.
59
-
60
- | Dataset | Checkpoint |
61
- | :--------: | :----------------------------------------------------------: |
62
- | IRSTD-1K | [`ADGNet_mIoU_72.38_IRSTD-1K.pth.tar`](https://huggingface.co/iLearn-Lab/MM26-ADGNet/blob/main/ADGNet_mIoU_72.38_IRSTD-1K.pth.tar) |
63
- | NUDT-SIRST | [`ADGNet_mIoU_95.53_NUDT-SIRST.pth.tar`](https://huggingface.co/iLearn-Lab/MM26-ADGNet/blob/main/ADGNet_mIoU_95.53_NUDT-SIRST.pth.tar) |
64
- | SIRST | [`ADGNet_mIoU_83.08_SIRST.pth.tar`](https://huggingface.co/iLearn-Lab/MM26-ADGNet/blob/main/ADGNet_mIoU_83.08_SIRST.pth.tar) |
65
-
66
- ---
67
-
68
- ## πŸš€ Usage
69
-
70
- These checkpoints are designed to be used with the official ADGNet implementation:
71
-
72
- ```text
73
- https://github.com/iLearn-Lab/MM26-ADGNet
74
- ```
75
-
76
- ### 1. Clone the Official Repository
77
-
78
- ```bash
79
- git clone https://github.com/iLearn-Lab/MM26-ADGNet.git
80
- cd MM26-ADGNet
81
- ```
82
-
83
- ### 2. Prepare the Checkpoints
84
-
85
- Place the downloaded checkpoints in:
86
-
87
- ```text
88
- MM26-ADGNet/
89
- └── SOTA_pth/
90
- β”œβ”€β”€ ADGNet_mIoU_72.38_IRSTD-1K.pth.tar
91
- β”œβ”€β”€ ADGNet_mIoU_95.53_NUDT-SIRST.pth.tar
92
- └── ADGNet_mIoU_83.08_SIRST.pth.tar
93
- ```
94
-
95
- ### 3. Prepare the CLIP Text Encoder
96
-
97
- ADGNet uses the pretrained **CLIP ViT-B/16** model:
98
-
99
- ```bash
100
- git clone https://huggingface.co/openai/clip-vit-base-patch16
101
- ```
102
-
103
- Update the local CLIP model path in the corresponding project configuration or source file before inference.
104
-
105
- ### 4. Run Evaluation
106
-
107
- Example evaluation on IRSTD-1K:
108
-
109
- ```bash
110
- python train.py \
111
- --trainset "IRSTD-1K" \
112
- --testset "IRSTD-1K" \
113
- --dataset_dir "./datasets" \
114
- --mode test \
115
- --ckpt "./SOTA_pth/ADGNet_mIoU_72.38_IRSTD-1K.pth.tar"
116
- ```
117
-
118
- Replace the dataset name and checkpoint path when evaluating on NUDT-SIRST or SIRST.
119
-
120
- ---
121
-
122
- ## πŸ“‚ Dataset and Text Annotation Preparation
123
-
124
- The original infrared images and ground-truth masks are not included in this model repository. Please obtain **IRSTD-1K**, **NUDT-SIRST**, and **SIRST** from their respective official sources.
125
-
126
- The asymmetric text annotations used by ADGNet are released separately in our Hugging Face dataset repository:
127
-
128
- - **AITIR Text Annotations:** [`Download`](<huggingface-text-dataset-link>)
129
-
130
- After downloading the original datasets and text annotations, organize them according to the official ADGNet repository:
131
-
132
- ```text
133
- datasets/
134
- β”œβ”€β”€ IRSTD-1K/
135
- β”‚ β”œβ”€β”€ images/
136
- β”‚ β”œβ”€β”€ masks/
137
- β”‚ β”œβ”€β”€ img_idx/
138
- β”‚ └── text/
139
- β”œβ”€β”€ NUDT-SIRST/
140
- β”‚ β”œβ”€β”€ images/
141
- β”‚ β”œβ”€β”€ masks/
142
- β”‚ β”œβ”€β”€ img_idx/
143
- β”‚ └── text/
144
- └── SIRST/
145
- β”œβ”€β”€ images/
146
- β”œβ”€β”€ masks/
147
- β”œβ”€β”€ img_idx/
148
- └── text/
149
- ```
150
-
151
- ---
152
-
153
- ## 🎯 Intended Use
154
-
155
- The released checkpoints are intended for:
156
-
157
- - Academic research on infrared small target detection
158
- - Reproduction of the results reported in the ADGNet paper
159
- - Evaluation on IRSTD-1K, NUDT-SIRST, and SIRST
160
- - Research on multimodal and text-guided infrared image segmentation
161
- - Comparison with other infrared small target detection methods
162
-
163
- ---
164
-
165
- ## ⚠️ Limitations
166
-
167
- - The model requires both infrared images and corresponding textual prompts.
168
- - Detection performance may vary when applied to datasets or scenes that differ substantially from the training distribution.
169
- - The released checkpoints are designed for the dataset splits and evaluation settings used in the paper.
170
- - The model depends on the pretrained CLIP ViT-B/16 text encoder.
171
- - The original infrared datasets are subject to their respective licenses and terms of use.
172
-
173
- ---
174
-
175
- ## πŸ”— Related Resources
176
-
177
- - **GitHub Repository:** [iLearn-Lab/MM26-ADGNet](https://github.com/iLearn-Lab/MM26-ADGNet)
178
- - **Paper:** [`ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection`](<paper-link>)
179
- - **Text Annotations:** [`AITIR Text Annotations`](<huggingface-text-dataset-link>)
180
-
181
- ---
182
-
183
- ## πŸ“š Citation
184
-
185
- If you find ADGNet or the released checkpoints useful in your research, please consider citing our paper:
186
-
187
- ```bibtex
188
-
189
- ```
190
-
191
- Please also consider checking out and citing our other related work:
192
-
193
- ```bibtex
194
-
195
- ```
196
-
197
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ pipeline_tag: image-segmentation
4
+ tags:
5
+ - infrared-small-target-detection
6
+ - multimodal
7
+ - vision-language
8
+ - pytorch
9
+ ---
10
+
11
+ <h1>ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection</h1>
12
+
13
+ <p>
14
+ <b>Tongtong Wang</b><sup>1</sup>&nbsp;
15
+ <b>Mingzhu Xu</b><sup>1βœ‰</sup>&nbsp;
16
+ <b>Chenglong Yu</b><sup>1</sup>&nbsp;
17
+ <b>Jing Wang</b><sup>1</sup>&nbsp;
18
+ <b>Xiaohui Lin</b><sup>1</sup>&nbsp;
19
+ <b>Weili Guan</b><sup>2</sup>
20
+ </p>
21
+
22
+ <p>
23
+ <sup>1</sup>School of Software, Shandong University<br>
24
+ <sup>2</sup>Harbin Institute of Technology, Shenzhen<br>
25
+ <sup>βœ‰</sup>Corresponding author
26
+ </p>
27
+
28
+ <p>
29
+ <a href="https://huggingface.co/papers/2609.00853">
30
+ <img src="https://img.shields.io/badge/ACM%20MM-2026-blue" alt="ACM MM 2026">
31
+ </a>
32
+ <a href="https://github.com/iLearn-Lab/MM26-ADGNet">
33
+ <img src="https://img.shields.io/badge/GitHub-MM26--ADGNet-black?logo=github" alt="GitHub">
34
+ </a>
35
+ </p>
36
+
37
+ ## πŸ“– Model Description
38
+
39
+ This repository provides the official model checkpoints for **ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection**, accepted by **ACM Multimedia 2026**.
40
+
41
+ Infrared Small Target Detection aims to accurately segment weak and tiny targets from complex infrared backgrounds. Existing pure-vision methods rely mainly on pixel-level information, while existing vision-language methods commonly describe targets and backgrounds using a single textual prompt. Such a symmetric design overlooks the inherent semantic differences between sparse infrared targets and structurally complex backgrounds.
42
+
43
+ ADGNet addresses this problem through three main components:
44
+
45
+ - **Asymmetric Dual-text Prompt (ADP):** uses an abstract, image-independent target prompt and a detailed, image-dependent background prompt.
46
+ - **Asymmetric Dual-Branch Interaction (ADBI):** independently performs target localization and background suppression using their corresponding textual priors.
47
+ - **Adaptive Feature Aggregation (AFA):** dynamically fuses target-enhanced and background-suppressed features for accurate segmentation.
48
+
49
+ The model uses the pretrained **CLIP ViT-B/16** text encoder to extract semantic representations from the target and background prompts.
50
+
51
+ ---
52
+
53
+ ## πŸ† Available Checkpoints
54
+
55
+ All ADGNet checkpoints are hosted in this Hugging Face model repository.
56
+
57
+ Download the required checkpoint directly from the **Files and versions** section of this repository.
58
+
59
+ | Dataset | Checkpoint |
60
+ | :--------: | :----------------------------------------------------------: |
61
+ | IRSTD-1K | [`ADGNet_mIoU_72.38_IRSTD-1K.pth.tar`](https://huggingface.co/iLearn-Lab/MM26-ADGNet/blob/main/ADGNet_mIoU_72.38_IRSTD-1K.pth.tar) |
62
+ | NUDT-SIRST | [`ADGNet_mIoU_95.53_NUDT-SIRST.pth.tar`](https://huggingface.co/iLearn-Lab/MM26-ADGNet/blob/main/ADGNet_mIoU_95.53_NUDT-SIRST.pth.tar) |
63
+ | SIRST | [`ADGNet_mIoU_83.08_SIRST.pth.tar`](https://huggingface.co/iLearn-Lab/MM26-ADGNet/blob/main/ADGNet_mIoU_83.08_SIRST.pth.tar) |
64
+
65
+ ---
66
+
67
+ ## πŸš€ Usage
68
+
69
+ These checkpoints are designed to be used with the official ADGNet implementation:
70
+
71
+ ```text
72
+ https://github.com/iLearn-Lab/MM26-ADGNet
73
+ ```
74
+
75
+ ### 1. Clone the Official Repository
76
+
77
+ ```bash
78
+ git clone https://github.com/iLearn-Lab/MM26-ADGNet.git
79
+ cd MM26-ADGNet
80
+ ```
81
+
82
+ ### 2. Prepare the Checkpoints
83
+
84
+ Place the downloaded checkpoints in:
85
+
86
+ ```text
87
+ MM26-ADGNet/
88
+ └── SOTA_pth/
89
+ β”œβ”€β”€ ADGNet_mIoU_72.38_IRSTD-1K.pth.tar
90
+ β”œβ”€β”€ ADGNet_mIoU_95.53_NUDT-SIRST.pth.tar
91
+ └── ADGNet_mIoU_83.08_SIRST.pth.tar
92
+ ```
93
+
94
+ ### 3. Prepare the CLIP Text Encoder
95
+
96
+ ADGNet uses the pretrained **CLIP ViT-B/16** model:
97
+
98
+ ```bash
99
+ git clone https://huggingface.co/openai/clip-vit-base-patch16
100
+ ```
101
+
102
+ Update the local CLIP model path in the corresponding project configuration or source file before inference.
103
+
104
+ ### 4. Run Evaluation
105
+
106
+ Example evaluation on IRSTD-1K:
107
+
108
+ ```bash
109
+ python train.py \
110
+ --trainset "IRSTD-1K" \
111
+ --testset "IRSTD-1K" \
112
+ --dataset_dir "./datasets" \
113
+ --mode test \
114
+ --ckpt "./SOTA_pth/ADGNet_mIoU_72.38_IRSTD-1K.pth.tar"
115
+ ```
116
+
117
+ Replace the dataset name and checkpoint path when evaluating on NUDT-SIRST or SIRST.
118
+
119
+ ---
120
+
121
+ ## πŸ“‚ Dataset and Text Annotation Preparation
122
+
123
+ The original infrared images and ground-truth masks are not included in this model repository. Please obtain **IRSTD-1K**, **NUDT-SIRST**, and **SIRST** from their respective official sources.
124
+
125
+ The asymmetric text annotations used by ADGNet are released separately in our Hugging Face dataset repository:
126
+
127
+ - **AITIR Text Annotations:** [`Download`](https://huggingface.co/datasets/iLearn-Lab/MM26-ADGNet-AITIR-Text)
128
+
129
+ After downloading the original datasets and text annotations, organize them according to the official ADGNet repository:
130
+
131
+ ```text
132
+ datasets/
133
+ β”œβ”€β”€ IRSTD-1K/
134
+ β”‚ β”œβ”€β”€ images/
135
+ β”‚ β”œβ”€β”€ masks/
136
+ β”‚ β”œβ”€β”€ img_idx/
137
+ β”‚ └── text/
138
+ β”œβ”€β”€ NUDT-SIRST/
139
+ β”‚ β”œβ”€β”€ images/
140
+ β”‚ β”œβ”€β”€ masks/
141
+ β”‚ β”œβ”€β”€ img_idx/
142
+ β”‚ └── text/
143
+ └── SIRST/
144
+ β”œβ”€β”€ images/
145
+ β”œβ”€β”€ masks/
146
+ β”œβ”€β”€ img_idx/
147
+ └── text/
148
+ ```
149
+
150
+ ---
151
+
152
+ ## 🎯 Intended Use
153
+
154
+ The released checkpoints are intended for:
155
+
156
+ - Academic research on infrared small target detection
157
+ - Reproduction of the results reported in the ADGNet paper
158
+ - Evaluation on IRSTD-1K, NUDT-SIRST, and SIRST
159
+ - Research on multimodal and text-guided infrared image segmentation
160
+ - Comparison with other infrared small target detection methods
161
+
162
+ ---
163
+
164
+ ## ⚠️ Limitations
165
+
166
+ - The model requires both infrared images and corresponding textual prompts.
167
+ - Detection performance may vary when applied to datasets or scenes that differ substantially from the training distribution.
168
+ - The released checkpoints are designed for the dataset splits and evaluation settings used in the paper.
169
+ - The model depends on the pretrained CLIP ViT-B/16 text encoder.
170
+ - The original infrared datasets are subject to their respective licenses and terms of use.
171
+
172
+ ---
173
+
174
+ ## πŸ”— Related Resources
175
+
176
+ - **GitHub Repository:** [iLearn-Lab/MM26-ADGNet](https://github.com/iLearn-Lab/MM26-ADGNet)
177
+ - **Paper:** [`ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection`](https://huggingface.co/papers/2609.00853)
178
+ - **Text Annotations:** [`AITIR Text Annotations`](https://huggingface.co/datasets/iLearn-Lab/MM26-ADGNet-AITIR-Text)
179
+
180
+ ---
181
+
182
+ ## πŸ“š Citation
183
+
184
+ If you find ADGNet or the released checkpoints useful in your research, please consider citing our paper:
185
+
186
+ ```bibtex
187
+ @inproceedings{wang2026adgnet,
188
+ title = {ADGNet: Asymmetric Dual-text Guided Network for Infrared Small Target Detection},
189
+ author = {Wang, Tongtong and Xu, Mingzhu and Yu, Chenglong and Wang, Jing and Lin, Xiaohui and Guan, Weili},
190
+ booktitle = {Proceedings of the ACM International Conference on Multimedia},
191
+ year = {2026},
192
+ }
193
+ ```
194
+
195
+ Please also consider checking out and citing our other related work:
196
+
197
+ ```bibtex
198
+ @inproceedings{yu2026dgnet,
199
+ title = {DGNet: Dual-knowledge Guided Network for Infrared Small Target Detection},
200
+ author = {Yu, Chenglong and Xu, Mingzhu and Wang, Jing and Wang, Tongtong and Miao, Pingping and Nie, Liqiang},
201
+ booktitle = {Proceedings of the ACM International Conference on Multimedia},
202
+ year = {2026},
203
+ }
204
+
205
+ @article{11017756,
206
+ author = {Xu, Mingzhu and Yu, Chenglong and Li, Zexuan and Tang, Haoyu and Hu, Yupeng and Nie, Liqiang},
207
+ journal = {IEEE Transactions on Geoscience and Remote Sensing},
208
+ title = {HDNet: A Hybrid Domain Network With Multiscale High-Frequency Information Enhancement for Infrared Small-Target Detection},
209
+ year = {2025},
210
+ volume = {63},
211
+ pages = {1--15},
212
+ doi = {10.1109/TGRS.2025.3574962},
213
+ }
214
+ ```
215
+
216
+ ---