Add model card with citation and file index

README.md

@@ -0,0 +1,48 @@
+---
+license: mit
+tags:
+  - satellite-imagery
+  - audio
+  - multimodal
+  - contrastive-learning
+  - soundscape
+  - remote-sensing
+---
+
+# Sat2Sound
+
+Trained checkpoints and backbone weights for **Sat2Sound: A Unified Framework for Zero-Shot Soundscape Mapping**, accepted at EarthVision 2026 (IEEE/ISPRS Workshop on Large Scale Computer Vision for Remote Sensing).
+
+- Paper: [arxiv.org/pdf/2505.13777](https://arxiv.org/pdf/2505.13777)
+- Code: [github.com/MVRL/sat2sound](https://github.com/MVRL/sat2sound)
+
+## Files
+
+| Path | Description |
+|---|---|
+| `sat2sound/bingmap_nometa.ckpt` | GeoSound-Bing, no metadata |
+| `sat2sound/bingmap_withmeta.ckpt` | GeoSound-Bing, with metadata |
+| `sat2sound/sentinel_nometa.ckpt` | GeoSound-Sentinel, no metadata |
+| `sat2sound/sentinel_withmeta.ckpt` | GeoSound-Sentinel, with metadata |
+| `sat2sound/SoundingEarth_nometa.ckpt` | SoundingEarth, no metadata |
+| `sat2sound/SoundingEarth_withmeta.ckpt` | SoundingEarth, with metadata |
+| `sat2text/bingmap_i2t_baseline.ckpt` | Sat2Text image-text baseline |
+| `backbones/pretrain-vit-base-e199.pth` | SatMAE ViT-Base backbone |
+| `backbones/mga-clap.pt` | MGACLAP audio encoder backbone |
+| `demo/GeoSound_gallery_w_bingmap.h5` | Retrieval demo gallery (9,931 samples) |
+| `ckpt_cfg.json` | Experiment name → checkpoint path mapping |
+
+Checkpoints and backbones are resolved automatically by the codebase via `src/hub.py:resolve_hf_ckpt` — no manual download needed.
+
+## Citation
+
+```bibtex
+@inproceedings{khanal2026sat2sound,
+  title     = {{Sat2Sound}: A Unified Framework for Zero-Shot Soundscape Mapping},
+  author    = {Khanal, Subash and Sastry, Srikumar and Dhakal, Aayush and
+               Ahmad, Adeel and Stylianou, Abby and Jacobs, Nathan},
+  booktitle = {IEEE/ISPRS Workshop: Large Scale Computer Vision for
+               Remote Sensing (EarthVision)},
+  year      = {2026},
+}
+```