# weathernext_gui

**Repository Path**: humanfans/weathernext_gui

## Basic Information

- **Project Name**: weathernext_gui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

"""
WeatherNext 2 Mini GUI

Google WeatherNext 2 / WeatherNext Cyclones Mini 模型的桌面与 Web 可视化工具。

## 快速开始 / Quick Start

### 安装 Python 依赖（国内镜像源）

```bash
# 清华（推荐，可从阿里/中科大换）
pip install --break-system-packages -r requirements.txt \
    -i https://pypi.tuna.tsinghua.edu.cn/simple
# 阿里云
pip install --break-system-packages -r requirements.txt \
    -i https://mirrors.aliyun.com/pypi/simple
# 中科大
pip install --break-system-packages -r requirements.txt \
    -i https://pypi.mirrors.ustc.edu.cn/simple
```

> deb 安装时 postinst 会自动用以上镜像轮询安装。

### DTK 原生桌面应用（当前唯一入口，deepin V25 原生）

```bash
# 方式一：源码构建（DTK6 QML）
cd dtk_app && cmake -B build && cmake --build build
./build/weathernext-mini-gui

# 方式二：安装 deb 包（推荐）
sudo apt install ./dist/weathernext-mini-gui_1.18.0_amd64.deb
```

> 应用为 DTK 原生（QML + DConfig 配置 + 系统通知），启动时自动拉起本地 FastAPI 后端
> （127.0.0.1:8765）负责真实 WeatherNext 2 Mini 推理与绘图。旧 PyQt6 入口已移除。

### 无头冒烟测试（不启动 GUI，仅验证后端）

```bash
python dtk_app/backend.py --demo
curl http://127.0.0.1:8765/health
```

## 项目结构 / Layout

```
weathernext-mini-gui/
├── dtk_app/            # DTK 原生应用（QML 6 功能页、main.cpp、backend.py 后端、DConfig）
├── weathernext_gui/    # 核心库：WN2 推理引擎、ECMWF 初始场读取、包头边界裁剪
│   ├── model/          #   wn2_engine.py / wn2_real.py（真实 WN2 Mini CPU 推理）
│   ├── geo/            #   baotou.py + baotou_counties.geojson（9 旗县区掩膜）
│   └── ecmwf/          #   ECMWF Open Data 0.25° 下载与缓存
├── scripts/            # 三模块流水线：step1_download / step2_infer / step3_plot
├── weathernext_src/    # WeatherNext 官方源码（按 Apache-2.0 引用，推理时加入 sys.path）
├── data/               # 模型权重 / 初始场缓存（体积大，不入库）
├── docs/               # 参赛截图与功能页说明
├── output/             # 产品图输出示例
├── build_deb.sh        # deb 打包脚本（含国内镜像依赖安装）
└── 参赛材料_deepin插件开发大赛.md
```

## 功能 / Features（DTK 应用 6 页）

| 页面 | 功能 |
| --- | --- |
| 🌍 全球预报仪表盘 | 全球地图动画、变量/气压层/时次选择、统计卡 |
| 🌀 热带气旋追踪器 | 多集合成员风暴路径、强度时间序列、数据表 |
| 📊 集合预报分析 | 集合均值、离散度、CRPS 检验、RMSE/MAE 指标 |
| 🚀 模型推理 | 真实 WeatherNext 2 Mini 推理（CPU，ECMWF 初始场） |
| 📍 单点预报分析 | 包头 14 城市时间序列、垂直廓线 |
| 📝 报告生成 | NetCDF/CSV/PNG 导出、Markdown 预报报告 |

## 模型参考 / Model Reference

- WeatherNext 2: https://arxiv.org/abs/2506.10772
- WeatherNext Cyclones: https://www.nature.com/articles/s41586-026-10953-2
- 官方代码仓库: https://github.com/google-deepmind/weathernext
- 数据源: Google Cloud (Earth Engine / BigQuery), Open-Meteo