Add metadata for pipeline tag, library name and link to paper
Browse filesThis PR improves the model card for Weather-R1 by adding:
- **Metadata**: Added `pipeline_tag: image-text-to-text` and `library_name: transformers` to ensure the model is correctly categorized and discoverable on the Hub.
- **Paper link**: Linked the repository to its corresponding ArXiv paper.
- **Image rendering**: Updated the image path to use a relative link that renders correctly on the Hugging Face Hub.
These changes help researchers find and use the model more effectively.
README.md
CHANGED
|
@@ -1,65 +1,78 @@
|
|
| 1 |
-
---
|
| 2 |
-
license: cc-by-nc-sa-4.0
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
|
| 27 |
-
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
|
| 33 |
-
|
| 34 |
-
|
| 35 |
-
β ββ WeatherQA-
|
| 36 |
-
β
|
| 37 |
-
|
| 38 |
-
|
| 39 |
-
|
| 40 |
-
|
| 41 |
-
|
| 42 |
-
|
| 43 |
-
|
| 44 |
-
|
| 45 |
-
|
| 46 |
-
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
|
| 50 |
-
|
| 51 |
-
|
| 52 |
-
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
|
| 57 |
-
|
| 58 |
-
|
| 59 |
-
|
| 60 |
-
|
| 61 |
-
|
| 62 |
-
|
| 63 |
-
|
| 64 |
-
|
| 65 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: cc-by-nc-sa-4.0
|
| 3 |
+
pipeline_tag: image-text-to-text
|
| 4 |
+
library_name: transformers
|
| 5 |
+
tags:
|
| 6 |
+
- meteorology
|
| 7 |
+
- reasoning
|
| 8 |
+
- vlm
|
| 9 |
+
- weather
|
| 10 |
+
---
|
| 11 |
+
|
| 12 |
+
# π€οΈ Weather-R1: Multimodal Reasoning in Meteorology
|
| 13 |
+
|
| 14 |
+
This repository contains the checkpoints for **Weather-R1**, as presented in the paper [Weather-R1: Logically Consistent Reinforcement Fine-Tuning for Multimodal Reasoning in Meteorology](https://huggingface.co/papers/2601.14044).
|
| 15 |
+
|
| 16 |
+
[**Paper (ArXiv)**](https://arxiv.org/abs/2601.14044) | [**Code (GitHub)**](https://github.com/Marcowky/Weather-R1)
|
| 17 |
+
|
| 18 |
+
# π€οΈ Introduction
|
| 19 |
+
|
| 20 |
+
While Vision Language Models (VLMs) show advancing reasoning capabilities, their application in meteorology is constrained by a domain gap and a reasoning faithfulness gap. Mainstream Reinforcement Fine-Tuning (RFT) can induce Self-Contradictory Reasoning (Self-Contra), where the reasoning process contradicts the final answer, which is unacceptable in this high-stakes domain.
|
| 21 |
+
|
| 22 |
+
To address these challenges, we construct WeatherQA, a multimodal multiple-choice benchmark for meteorology comprising 15,400 entries that cover four themes and seven imaging modality tasks. We propose Logically Consistent Reinforcement Fine-Tuning (LoCo-RFT), which introduces a logical consistency reward to resolve Self-Contra. Based on this paradigm and WeatherQA, we present Weather-R1, the first reasoning VLM with logical faithfulness in meteorology, to the best of our knowledge. Weather-R1 (7B) achieves 52.9% accuracy on WeatherQA, a 9.8 percentage point gain over the baseline model Qwen2.5-VL-7B; it surpasses Supervised Fine-Tuning and RFT baselines, exceeds the original Qwen2.5-VL-32B, and improves out-of-domain ScienceQA performance by 4.98 percentage points.
|
| 23 |
+
|
| 24 |
+
<div align="center\">
|
| 25 |
+
<img src="https://huggingface.co/Marcowky/Weather-R1/resolve/main/asserts/Case_Study.png" width="70%" />
|
| 26 |
+
<p><em>Response Comparison.</em></p>
|
| 27 |
+
</div>
|
| 28 |
+
|
| 29 |
+
# ποΈ Folder Structure
|
| 30 |
+
This repository provides model checkpoints organized by training strategy and task:
|
| 31 |
+
|
| 32 |
+
```
|
| 33 |
+
Weather-R1/
|
| 34 |
+
ββ LoCo-RFT/ # Weather-R1 checkpoints
|
| 35 |
+
β ββ WeatherQA-500hPa/
|
| 36 |
+
β ββ WeatherQA-850hPa/
|
| 37 |
+
β ββ WeatherQA-Land/
|
| 38 |
+
β ββ WeatherQA-Max-Temp/
|
| 39 |
+
β ββ WeatherQA-Min-Temp/
|
| 40 |
+
β ββ WeatherQA-Phenom/
|
| 41 |
+
β ββ WeatherQA-Rain/
|
| 42 |
+
ββ RFT/ # Standard RFT checkpoints
|
| 43 |
+
β ββ WeatherQA-500hPa/
|
| 44 |
+
β ββ WeatherQA-850hPa/
|
| 45 |
+
β ββ WeatherQA-Land/
|
| 46 |
+
β ββ WeatherQA-Max-Temp/
|
| 47 |
+
β ββ WeatherQA-Min-Temp/
|
| 48 |
+
β ββ WeatherQA-Phenom/
|
| 49 |
+
β ββ WeatherQA-Rain/
|
| 50 |
+
ββ asserts/ # Figures used in README
|
| 51 |
+
```
|
| 52 |
+
|
| 53 |
+
Each task folder contains HuggingFace-style model files such as `config.json`,
|
| 54 |
+
`tokenizer.json`, and sharded weights like `model-00001-of-00004.safetensors`.
|
| 55 |
+
|
| 56 |
+
# π Training and Evaluation
|
| 57 |
+
|
| 58 |
+
Please refer to our official repository: [Weather-R1](https://github.com/Marcowky/Weather-R1)
|
| 59 |
+
|
| 60 |
+
# π Acknowledgements
|
| 61 |
+
|
| 62 |
+
Training code is built on [EasyR1](https://github.com/hiyouga/EasyR1).
|
| 63 |
+
|
| 64 |
+
# π Citation
|
| 65 |
+
|
| 66 |
+
If you use Weather-R1 resources, please cite the following paper:
|
| 67 |
+
|
| 68 |
+
```bibtex
|
| 69 |
+
@misc{wu2026weatherr1logicallyconsistentreinforcement,
|
| 70 |
+
title={Weather-R1: Logically Consistent Reinforcement Fine-Tuning for Multimodal Reasoning in Meteorology},
|
| 71 |
+
author={Kaiyu Wu and Pucheng Han and Hualong Zhang and Naigeng Wu and Keze Wang},
|
| 72 |
+
year={2026},
|
| 73 |
+
eprint={2601.14044},
|
| 74 |
+
archivePrefix={arXiv},
|
| 75 |
+
primaryClass={cs.CV},
|
| 76 |
+
url={https://arxiv.org/abs/2601.14044},
|
| 77 |
+
}
|
| 78 |
+
```
|