Piggy_Packages V2026.1 帮助文档（一）开箱即用

Piggy_Packages 是⼀个专为⽓象科研⼈员和爱好者打造的、⾼度集成的软件包合集。它基于Cygwin 进⾏了深度定制和优化，旨在 Windows 操作系统环境下提供 ⼀个“解压即⽤”的便捷气象科研平台，⽆需复杂的安装步骤和依赖配置，让你能够快速投⼊到实际的科研⼯作中。它适用于：

1. 想要在个人电脑上学习使用WRF、CDO等专业气象工具，但是不想折腾环境的同学。
2. 想要在公共电脑上快速开始科研工作的同学。

获取Piggy_Packages

请按Win+R快捷键打开“运行”对话框，输入cmd运行命令提示符，然后粘贴下方代码获取（代码中的中文句号能够正确解析，不用担心）：

curl piggy。nui。st

如果上述命令失效，可以使用下方备用命令获取：

powershell -Command "[text.encoding]::utf8.GetString([Convert]::FromBase64String(\"5LiL6L295Zyw5Z2A77yaaHR0cDovL251aS5zdC83dwrmioDmnK/mlK/mjIFRUee+pO+8mjg1Mjk4MzcxNQ==\"))"

开始之前

Piggy_Packages ⽬前⽀持 Windows 10 （22H2）和 Windows 11。请注意，随着 Windows 10 ⽀持周期的结束，对于 Windows 10 的⽀持将很快被移除。

如果你必须使用Windows 8.1、Windows 10 早期版本，Piggy_Packages 中的大部分功能应该可以运行。

Piggy_Packages 可以解压直接使用，但是推荐安装以下可选程序，以提升使用体验：

1. Visual Studio Code 微软开发的代码编辑器，下载地址： https://code.visualstudio.com/
2. Windows Terminal 微软开发的新一代终端工具，Windows 11已经内置，Windows 10系统需要自行安装，下载地址： https://aka.ms/terminal

开箱使用

在开始之前，我们强烈建议您不要将 Piggy_Packages 解压缩到包含空格或特殊字符的⽬录中。

例如，避免使⽤类似 C:\My Documents\Piggy_Packages\ 这样的路径。推荐使⽤更简洁的路径，如 D:\Piggy_Packages\ 或 C:\tools\Piggy_Packages\。这可以避免许多潜在的路径识别问题，确保各组件正常运⾏。

为了保证Piggy_Packages正常运行，请确保所在的分区有至少50GB的可用空间。

Piggy_Packages Version 2026.1 提供了4个交互终端，可以根据喜好或者心情选择，如图所示：

为了避免权限问题，强烈建议通过右键以管理员身份运行。

Piggy-Bash（经典）：Cygwin原生Mintty终端，如果你正在使用Windows 10，且未安装Windows Terminal，请使用这个终端。

Piggy-Bash（简约）：简单正式，如果你正在使用Windows 11，或者安装了Windows Terminal，使用这个终端可以获得更好的使用体验。

Piggy-Zsh（现代、樱花粉）：搭载了更好看，更潮流的终端主题，你一定会喜欢！

Note：Piggy-Zsh（现代、樱花粉）需要特定字体以正确显示图标，MesloLGS NF字体位于Piggy_Packages目录下的fonts目录，全选4个字体，然后右键安装：

安装完成后，请在Windows Terminal设置中，选择MesloLGS NF字体：

如果你选择使用zsh，可以通过下方命令自定义主题：

p10k configure

内置功能

Piggy_Packages内置了多种气象和科研工具，主要有：WRF、CDO、NCO、NCL、NCVIEW、Panploy、ecCodes、MET、UPP、ESMF、GDAL、RTTOV等，足以满足绝大多数科研需求。

WRF程序包位于/pp_model/WRF-4.7.1目录下，包含以下内容：

1. download_geog.sh ⾼精度地形数据下载脚本
2. WPS WRF前处理系统
3. WPS_GEOG 静态地形数据（低精度）
4. download_geog.sh ⾼精度地形数据下载脚本
5. WRF-Ideal WRF理想模式
6. WRF-REAL WRF 中尺度⼤⽓模式
7. WRF-VF WRF 中尺度⼤⽓模式（启⽤vortex following）
8. WRF-PM WRF 中尺度⼤⽓模式（启⽤preset moves）
9. WRFPLUS WRF切线性和伴随模式，⽤于敏感性试验和WRFDA四维变分
10. WRFDA WRF同化系统
11. RTTOV 快速辐射传输模式（v12.1），⽤于WRFDA卫星资料同化
12. WRF-Chem WRF化学模式
13. WRF-Hydro WRF⽔⽂模式

Piggy_Packages同时内置了Python、R、Ruby等脚本支持。对于Python，已经内置了numpy、pandas、matplotlib、cartopy、metpy、wrf-python、xarray、scipy、scikit-learn等气象常用库，但是无法支持所有Python库，如果你已经安装了Windows版的Python，请优先使用Windows版本。

Piggy_Packages还内置了GCC、OpenMPI等编译器，和make、cmake、meson、ninja等构建⼯具，用于构建你自己的程序包。

在后续章节中，我们将详细介绍这些功能。

便携使用

为了⽅便您快速访问 Windows 系统中的常⽤位置，Piggy_Packages 预设了⼀些环境变量，您可以配合 cd 命令使⽤：

$Desktop: 指向您 Windows 系统的“桌⾯“⽬录。

示例: cd "$Desktop"

$Documents: 指向您 Windows 系统的“⽂档”⽬录。

示例: cd "$Documents"

$Home: 指向您 Windows 系统的⽤户“个⼈“⽬录。

示例: cd "$Home"

$SMPROGRAMS: 指向您 Windows 系统的开始菜单程序⽬录。

示例: cd "$SMPROGRAMS"

您的 Windows 驱动器被“挂载”到了 Piggy_Packages ⽂件系统中的特定位置。挂载点前缀有以下两个：

/cygdrive/

/mnt/

例如，要访问您的 Windows D 盘，您可以使⽤以下任⼀命令：

cd /cygdrive/d

cd /mnt/d