InPeerReview commited on
Commit
e2a3312
Β·
verified Β·
1 Parent(s): 3aafbf3

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +121 -3
README.md CHANGED
@@ -1,3 +1,121 @@
1
- ---
2
- license: apache-2.0
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ## πŸ› οΈ Requirements
2
+
3
+ ### Environment
4
+ - **Python** 3.8+
5
+ - **PyTorch** 1.13.0+
6
+ - **CUDA** 11.6+
7
+ - **Ubuntu** 18.04 or higher / Windows 10
8
+
9
+ ### Installation
10
+
11
+ ```bash
12
+ # Create conda environment
13
+ conda create -n dccs python=3.8 -y
14
+ conda activate dccs
15
+
16
+ # Install PyTorch
17
+ pip install torch==1.13.0 torchvision==0.14.0 torchaudio==0.13.0
18
+
19
+ # Install dependencies
20
+ pip install packaging
21
+ pip install timm==0.4.12
22
+ pip install pytest chardet yacs termcolor
23
+ pip install submitit tensorboardX
24
+ pip install triton==2.0.0
25
+ pip install causal_conv1d==1.0.0
26
+ pip install mamba_ssm==1.0.1
27
+
28
+ # Or simply run
29
+ pip install -r requirements.txt
30
+ ```
31
+
32
+ ## πŸ“ Dataset Preparation
33
+
34
+ We evaluate our method on three public datasets: **IRSTD-1K**, **NUAA-SIRST**, and **SIRST-Aug**.
35
+
36
+ | Dataset | Link |
37
+ |---------|------|
38
+ | IRSTD-1K | [Download](https://github.com/RuiZhang97/ISNet) |
39
+ | NUAA-SIRST | [Download](https://github.com/YimianDai/sirst) |
40
+ | SIRST-Aug | [Download](https://github.com/Tianfang-Zhang/AGPCNet) |
41
+
42
+ Please organize the datasets as follows:
43
+
44
+ ```
45
+ β”œβ”€β”€ dataset/
46
+ β”‚ β”œβ”€β”€ IRSTD-1K/
47
+ β”‚ β”‚ β”œβ”€β”€ images/
48
+ β”‚ β”‚ β”‚ β”œβ”€β”€ XDU514png
49
+ β”‚ β”‚ β”‚ β”œβ”€β”€ XDU646.png
50
+ β”‚ β”‚ β”‚ └── ...
51
+ β”‚ β”‚ β”œβ”€β”€ masks/
52
+ β”‚ β”‚ β”‚ β”œβ”€β”€ XDU514.png
53
+ β”‚ β”‚ β”‚ β”œβ”€β”€ XDU646.png
54
+ β”‚ β”‚ β”‚ └── ...
55
+ β”‚ β”‚ └── trainval.txt
56
+ β”‚ β”‚ └── test.txt
57
+ β”‚ β”œβ”€β”€ NUAA-SIRST/
58
+ β”‚ β”‚ └── ...
59
+ β”‚ └── SIRST-Aug/
60
+ β”‚ └── ...
61
+ ```
62
+
63
+ ## πŸš€ Training
64
+
65
+ ```bash
66
+ python main.py --dataset-dir '/path/to/dataset' \
67
+ --batch-size 4 \
68
+ --epochs 400 \
69
+ --lr 0.05 \
70
+ --mode 'train'
71
+ ```
72
+
73
+ **Example:**
74
+ ```bash
75
+ python main.py --dataset-dir './dataset/IRSTD-1K' --batch-size 4 --epochs 400 --lr 0.05 --mode 'train'
76
+ ```
77
+
78
+ ## πŸ“Š Testing
79
+
80
+ ```bash
81
+ python main.py --dataset-dir '/path/to/dataset' \
82
+ --batch-size 4 \
83
+ --mode 'test' \
84
+ --weight-path '/path/to/weight.tar'
85
+ ```
86
+
87
+ **Example:**
88
+ ```bash
89
+ python main.py --dataset-dir './dataset/IRSTD-1K' --batch-size 4 --mode 'test' --weight-path './weight/irstd1k_weight.pkl'
90
+ ```
91
+
92
+ ## πŸ“ˆ Results
93
+
94
+ ### Quantitative Results
95
+
96
+ | Dataset | IoU (Γ—10⁻²) | Pd (Γ—10⁻²) | Fa (Γ—10⁻⁢) | Weights |
97
+ |:-------:|:------------:|:----------:|:----------:|:-------:|
98
+ | IRSTD-1K | 69.64 | 95.58 | 10.48 | [Download](https://drive.google.com/file/d/1KqlOVWIktfrBrntzr53z1eGnrzjWCWSe/view?usp=sharing) |
99
+ | NUAA-SIRST | 78.65 | 78.65 | 2.48 | [Download](https://drive.google.com/file/d/13JQ3V5xhXUcvy6h3opKs15gseuaoKrSQ/view?usp=sharing) |
100
+ | SIRST-Aug | 75.57 | 98.90 | 33.46 | [Download](https://drive.google.com/file/d/1lcmTgft0LStM7ABWDIMRHTkcOv95p9LO/view?usp=sharing) |
101
+
102
+
103
+ ## πŸ“‚ Project Structure
104
+
105
+ ```
106
+ DCCS/
107
+ β”œβ”€β”€ dataset/ # Dataset loading and preprocessing
108
+ β”œβ”€β”€ model/ # Network architecture
109
+ β”œβ”€β”€ utils/ # Utility functions
110
+ β”œβ”€β”€ weight/ # Pretrained weights
111
+ β”œβ”€β”€ main.py # Main entry point
112
+ β”œβ”€β”€ requirements.txt # Dependencies
113
+ └── README.md
114
+ ```
115
+
116
+ ## πŸ™ Acknowledgement
117
+
118
+ We sincerely thank the following works for their contributions:
119
+
120
+ - [BasicIRSTD](https://github.com/XinyiYing/BasicIRSTD) - A comprehensive toolbox
121
+ - [MSHNet](https://github.com/ying-fu/MSHNet) - Scale and Location Sensitive Loss