sysumkit

一个用于气象数据（主要为降水）下载、处理、可视化的Python软件包，该包由“淼的Python研学”公众号博主开发和维护。

功能特性

数据下载

1. IMERG数据下载

IMERG数据集下载需要进行必要的配置，请参阅官方文档https://urs.earthdata.nasa.gov/profile。 如果不明白怎么配置，可以查看往期付费推文https://mp.weixin.qq.com/s/FNDrmp9tZiYWWcVpAahsjw，一顿饭钱，感谢各位老板！ 详细使用教程可以查看：淼的Python研学 微信公众号，2026年7月31日推文介绍

from sysumkit.download.auth import configure_earthdata

configure_earthdata()

执行下载：

from sysumkit.download.imerg import ImergDownloader

# 1. 下载
dl = ImergDownloader(
    links_txt=r'C:\Users\sysum\Desktop\subset_GPM_3IMERGDF_07_20260730_065249_.txt',
    output_folder=r'D:\IMERG',
    organize_by_date=True,
)
dl.download()

# 2. 删除因为网络等问题下载不完整的文件 这里设置为小于5MB的文件【小心，先确认正常文件大小是多少】
dl.check_incomplete_files(
    min_size_mb=5
)

# 3. 重试失败
dl.retry_failed(max_retries=3)

2. GsMaP数据下载 截至2026年7月，官方给的FTP服务器的信息都是固定的，我写死在源码里面了，可以直接调用。 但是，由于GsMaP数据很坑，提供的是.gz文件，并且单个文件只有一行，所以经过查阅相关资料，我给大家处理好了，直接转换为nc数据就可以使用了。

from sysumkit.download.gsmap import GsmapDownloader

# 1. 初始化下载器
dl = GsmapDownloader(
    base_dir='/standard/v8/daily_G/00Z-23Z/',
    start_mon='200706',  # 测试用短时间段
    end_mon='200706',
    target=r'D:\GSMaP',
    variable='precip'
)

# 2. 执行下载
dl.download()

# 3. 如果有失败，重试
dl.retry_failed(max_retries=3)

# 4. 转换为 NC
dl.gz_to_nc()

目前只包括当前两种数据，后续有需要会添加更多的数据源。

数据处理

暂不开源，后续会面向专属会员开放，打造一批好用的数据处理工具、并且提供高级算法。

数据可视化

暂不开源，后续会面向专属会员开放。 后续会纳入各种统计图表（如泰勒图、箱线图）、地理空间可视化图，参考公众号"Python地理数据可视化系列"。

快速开始

安装

打开/激活你的Python环境，切换到.whl文件所在目录，执行下面的代码：

pip install sysumkit-0.1.0-py3-none-any.whl

使用案例

见examples目录

联系作者

1. 欢迎加入“Python科研AI交流群”(QQ群号)：428657886
2. 咨询、服务欢迎添加作者本人