Add comprehensive model card for SDGPA

README.md

@@ -1,3 +1,104 @@
----
-license: mit
----
+---
+license: mit
+pipeline_tag: image-segmentation
+library_name: diffusers
+---
+
+# SDGPA: Zero Shot Domain Adaptive Semantic Segmentation by Synthetic Data Generation and Progressive Adaptation
+
+Official implementation of paper: [**Zero Shot Domain Adaptive Semantic Segmentation by Synthetic Data Generation and Progressive Adaptation**](https://huggingface.co/papers/2508.03300) (IROS 25').
+
+Code: [https://github.com/roujin/SDGPA](https://github.com/roujin/SDGPA)
+
+<div align="center">
+  <img src="https://github.com/roujin/SDGPA/raw/main/poster_cvpr%20001.png" alt="SDGPA Overview" width="100%"/>
+</div>
+
+## Abstract
+Deep learning-based semantic segmentation models achieve impressive results yet remain limited in handling distribution shifts between training and test data. In this paper, we present SDGPA (Synthetic Data Generation and Progressive Adaptation), a novel method that tackles zero-shot domain adaptive semantic segmentation, in which no target images are available, but only a text description of the target domain's style is provided. To compensate for the lack of target domain training data, we utilize a pretrained off-the-shelf text-to-image diffusion model, which generates training images by transferring source domain images to target style. Directly editing source domain images introduces noise that harms segmentation because the layout of source images cannot be precisely maintained. To address inaccurate layouts in synthetic data, we propose a method that crops the source image, edits small patches individually, and then merges them back together, which helps improve spatial precision. Recognizing the large domain gap, SDGPA constructs an augmented intermediate domain, leveraging easier adaptation subtasks to enable more stable model adaptation to the target domain. Additionally, to mitigate the impact of noise in synthetic data, we design a progressive adaptation strategy, ensuring robust learning throughout the training process. Extensive experiments demonstrate that our method achieves state-of-the-art performance in zero-shot semantic segmentation.
+
+## Installation
+
+Environment setting:
+
+All of our experiments are conducted on NVIDIA RTX 3090 with cuda 11.8
+```bash
+source env.sh
+```
+
+## Running
+
+You can find all the training scripts in the `scripts/` folder.
+
+We use day $\to$ snow setting as an example.
+
+First, you should decide where you want to put the datasets. Let's denote it as `<data_root>` (for example:`/data3/roujin`). By default, the experimental logs are stored in `<data_root>`.
+
+Then, organize the folder as follows:
+```
+<data_root>
+└─ ACDC
+   └─ gt
+   └─ rgb_anon
+└─ cityscapes
+   └─ gtFine
+   └─ leftImg8bit
+└─ GTA5
+   └─ images
+   └─ labels
+```
+
+You can refer to cityscapes and ACDC's official websites for the datasets. For GTA5, as we only use a subset of them, we provide the following link to download the subset for your convenience: [https://huggingface.co/datasets/roujin/GTA5subset](https://huggingface.co/datasets/roujin/GTA5subset)
+
+For synthetic data generation:
+```bash
+source img_gen/run.sh <data_root> snow
+```
+
+For progress model adaptation:
+```bash
+source scripts/snow.sh <data_root>
+```
+
+Evaluation:
+```bash
+source eval.sh <data_root> <setting>
+```
+`<setting>` can be "day", "fog", "rain", "snow", "night", "game"
+
+## Evaluation Results
+
+We release the following results. See all logs and checkpoints during training from [https://huggingface.co/roujin/SDGPA/tree/main](https://huggingface.co/roujin/SDGPA/tree/main)
+
+| Setting          | Day→Night                                                                               | Clear→Snow                                                                             | Clear→Rain                                                                             | Clear→Fog                                                                             | Real→Game                                                                              |
+| :--------------- | :-------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------- |
+| results on paper | 26.9±0.8                                                                                | 47.4±0.7                                                                               | 48.6±0.8                                                                               | 58.8±0.7                                                                              | 43.4±0.4                                                                               |
+| our released     | 27.6                                                                                    | 46.8                                                                                   | 49.0                                                                                   | 59.8                                                                                  | 43.1                                                                                   |
+| checkpoint       | [link](https://huggingface.co/roujin/SDGPA/blob/main/night2/weights/weights_65.pth.tar) | [link](https://huggingface.co/roujin/SDGPA/blob/main/snow2/weights/weights_65.pth.tar) | [link](https://huggingface.co/roujin/SDGPA/blob/main/rain2/weights/weights_65.pth.tar) | [link](https://huggingface.co/roujin/SDGPA/blob/main/fog2/weights/weights_65.pth.tar) | [link](https://huggingface.co/roujin/SDGPA/blob/main/game2/weights/weights_65.pth.tar) |
+
+We recommend you to read the scripts and the paper for more details.
+
+For hyperparameter selection of InstructPix2Pix, we recommend reading: [https://huggingface.co/spaces/timbrooks/instruct-pix2pix/blob/main/README.md](https://huggingface.co/spaces/timbrooks/instruct-pix2pix/blob/main/README.md)
+
+## Acknowledgements
+
+This code is built upon the following repositories:
+
+*   [https://github.com/azuma164/ZoDi](https://github.com/azuma164/ZoDi)
+*   [https://huggingface.co/timbrooks/instruct-pix2pix](https://huggingface.co/timbrooks/instruct-pix2pix)
+
+We thank them for their excellent work!
+
+## Citation
+
+```bibtex
+@misc{luo2025sdgpa,
+      title={Zero Shot Domain Adaptive Semantic Segmentation by Synthetic Data Generation and Progressive Adaptation}, 
+      author={Jun Luo and Zijing Zhao and Yang Liu},
+      year={2025},
+      eprint={2508.03300},
+      archivePrefix={arXiv},
+      primaryClass={cs.CV},
+      url={https://arxiv.org/abs/2508.03300}, 
+}
+```