Zonaite 是一个用于气象数据处理的 Python 工具包，提供了天气预报数据下载和观测数据解码的功能。
-
GFS 数据下载：支持从 NOAA 的 GFS（全球预报系统）公共 S3 存储桶中选择性下载特定变量和层次的数据
- 支持通过 idx 文件进行高效的部分下载
- 提供性能监控和日志记录
- 使用数据类进行类型安全的数据结构处理
-
SYNOP 观测数据解码：支持从 Skyviewor 开放数据平台获取和解码 SYNOP 格式的气象观测数据
- 提供 WMO 国际交换气象站点信息查询（目前数据仅包括中国大陆地区）
- 支持查询可用的气象要素信息
- 支持按时间范围和站点批量获取数据
本项目使用 uv 作为包管理工具。安装步骤如下：
# 克隆仓库
git clone https://github.com/Clarmy/zonaite.git
cd zonaite
# 使用 uv 安装依赖
uv pip install .- Python >= 3.11
- pandas >= 2.2.3
- requests >= 2.32.3
- tqdm >= 4.66.2
- boto3 >= 1.34.0
from datetime import datetime, timezone
from zonaite.forecast import download_gfs_data
# 定义要下载的气象要素
elements = [
{"name": "TMP", "level": "2 m above ground"}, # 2米温度
{"name": "UGRD", "level": "10 m above ground"}, # 10米U风
{"name": "VGRD", "level": "10 m above ground"} # 10米V风
]
# 设置时间参数（使用 UTC 时间）
dt = datetime(2024, 4, 1, tzinfo=timezone.utc) # UTC时间
forecast_hour = 3 # 预报时效（小时）
# 设置输出路径
output_path = "gfs_data.grib2"
# 下载数据
result = download_gfs_data(
dt=dt,
forecast_hour=forecast_hour,
elements=elements,
output_path=output_path,
quiet=False # 显示下载进度
)
# 检查下载结果
if result.success:
print(f"下载成功！文件大小：{result.file_size_mb:.2f}MB")
print(f"下载速度：{result.download_speed_mbs:.2f}MB/s")
print(f"下载时间：{result.download_time_s:.2f}秒")
else:
print(f"下载失败：{result.error_message}")from datetime import datetime, timezone
from zonaite.obser import get_decoded_synop_data
# 设置时间范围和站点
start_date = datetime(2024, 1, 1, tzinfo=timezone.utc)
end_date = datetime(2024, 1, 31, tzinfo=timezone.utc)
station_id = "54511" # 北京站
# 获取观测数据
df = get_decoded_synop_data(start_date, end_date, station_id)
# 查看数据
if df is not None:
print("数据预览：")
print(df.head())
print("\n数据信息：")
print(df.info())如果你想参与开发，需要确保你的 Python 版本 >= 3.11，然后安装开发依赖：
# 确保使用 Python 3.11 或更高版本
python --version
# 安装开发依赖
uv pip install -e ".[dev]"开发依赖包括：
- black >= 25.1.0
- flake8 >= 7.1.2
- ipython >= 9.0.2
- isort >= 6.0.1
注意：如果你遇到依赖安装问题，请确保：
- 使用 Python 3.11 或更高版本
- 如果使用虚拟环境，确保在正确的环境中安装
- 如果仍然遇到问题，可以尝试先升级 uv：
pip install -U uv
本项目采用 MIT 许可证。详见 LICENSE 文件。