Afterburner软件包

什么是Afterburner？

Afterburner是一个Python软件包，提供分析和处理气候模型数据的功能，尤其是（但不限于）英国气象局统一模型产生的数据。

目前Afterburner代码库与Python 2.7和Python 3.6或更高版本兼容。然而，由于官方已停止对Python 2.7的支持，强烈建议使用Python 3。

许可证

Afterburner软件在3-Clause BSD许可证下提供，具体详情请参阅Afterburner发行版根目录下的LICENSE.TXT文件。

依赖项

afterburner软件包依赖于以下软件包，每个软件包都有自己的依赖项。

• scitools-iris（版本2.1或更高；推荐版本2.4）
• pyparsing
• windspharm
• sphinx（仅当您打算构建和安装文档集时需要）
• nose（仅当您打算运行单元测试时需要）

安装

可以从PyPI或conda-forge安装afterburner包。推荐使用conda-forge进行安装。

从PyPI安装

虽然可以从PyPI安装afterburner包，但安装某些先决条件包（特别是cartopy）可能具有挑战性。因此，建议首先在一个合适的conda环境中安装Iris，然后使用pip将afterburner安装到该环境中，但跳过依赖包的安装（使用--no-deps选项）。

% conda activate <your-env>
% conda info -c conda-forge iris==2.4.0   # just to preview package dependencies
% conda install -c conda-forge iris==2.4.0
% conda install -c conda-forge windspharm
% pip install --no-deps metoffice-afterburner

注意：安装Iris应该会安装pyparsing包。

从conda-forge安装

% conda activate <your-env>
% conda install -c conda-forge iris==2.4.0
% conda install -c conda-forge windspharm
% conda install -c conda-forge metoffice-afterburner

从tarball安装

您也可以直接从源代码安装。从PyPI下载包的tarball后，解压它，切换到源目录，然后输入以下命令（如果需要，可以使用相关的选项：使用--help查看支持哪些选项）

% python setup.py install

Rose和Cylc的集成

如果您打算将afterburner Python包与Rose和Cylc结合使用（例如，将Afterburner应用集成到Rose套件中），那么您还应该在您的系统上安装这些包。

除了上述链接的GitHub项目主页，这两个包也可以在PyPI上找到（Rose | Cylc）。

然而，需要注意的是，即使没有安装Rose和Cylc包，afterburner Python包也应该能够成功构建和安装。

文档

可以通过运行build_docs子命令生成基于sphinx的Afterburner文档。

% python setup.py build_docs

该命令将在doc/src/_build/html目录中构建HTML文档。如果需要，可以使用install_docs子命令将文档安装到目标目录。

% python setup.py install_docs --dst-dir=<destination-dir> [--host=<hostname>]

或者，如果您愿意，可以手动修改并运行位于doc/src/build_docs.sh的shell脚本。

测试

如果需要，可以使用以下命令运行Afterburner单元测试

% python setup.py test

根据您的Python运行时环境中安装的包，某些单元测试可能会被跳过。