用于处理大气时间序列数据集的软件包
项目描述
大气数据社区工具包（ACT）是一个开源的Python工具包，用于处理不同维度的大气时间序列数据集。工具包具有科学过程中的所有功能；发现、IO、质量控制、校正、检索、可视化和分析。它是共享代码的社区平台，旨在减少工作重复并更好地将科学界与如大气辐射测量（ARM）用户设施等程序连接起来。作为路线图的一部分，总体开发目标将定期更新。
请通过提交问题来报告任何问题或功能请求。此外，我们的讨论板欢迎各种想法、一般讨论或提问，以及展示和分享！
版本 2.0
ACT 现已发布 2.0 版本。本版本包含许多功能命名更改，例如 IO 和 Discovery 模块功能命名更改。为了准备此次发布，我们提供了一个v2.0指南，其中解释了更改以及如何使用新的语法。
新版本可在 PyPI 和 conda-forge 上获取。
请将 2.0 版本的任何错误报告到下文重要链接部分提到的 Issue Tracker。
重要链接
引用
如果您使用 ACT 准备出版物，请引用上面徽章中列出的 DOI，该 DOI 会随着每个版本发布而更新，以确保贡献者获得适当的认可。DOI 通过 Zenodo 提供。
依赖项
可选依赖项
安装
ACT 可以通过几种不同的方式进行安装。一种方式是使用 pip 进行安装。使用 pip 安装时，还会安装 requirements.txt 中找到的 ACT 依赖项。要使用 pip 安装
pip install act-atmos
安装 ACT 最简单的方法是使用最新发布中的 conda 包。为此，您必须下载并安装 Anaconda 或 Miniconda。使用 Anaconda 或 Miniconda 安装时，建议在使用 ACT 或其他包时创建新的 conda 环境。要创建基于 environment.yml 的新环境
conda env create -f environment.yml
或为基本环境，并在需要时下载可选依赖项
conda create -n act_env -c conda-forge python=3.12 act-atmos
终端或命令提示符中安装 ACT 最新版本的命令
conda install -c conda-forge act-atmos
要更新较旧的 ACT 版本到最新发布版本，请使用
conda update -c conda-forge act-atmos
如果您正在使用 mamba
mamba install -c conda-forge act-atmos
如果您不希望使用 Anaconda 或 Miniconda 作为 Python 环境，或者希望使用 ACT 的最新、未发布版本，请参阅下文关于 从源安装 的部分。
从源安装
从源安装 ACT 是获取尚未发布到版本中的最新更新和增强的唯一方式。ACT 的最新源代码可以从 GitHub 仓库获取，https://github.com/ARM-DOE/ACT。您可以下载并解压源代码的 zip 文件，或者使用 git 检出仓库
git clone https://github.com/ARM-DOE/ACT.git
一旦本地拥有该目录，可以使用以下方式以开发模式安装 ACT：
pip install -e .
如果您想直接安装存储库，可以使用以下方式：
pip install git+https://github.com/ARM-DOE/ACT.git
贡献
ACT 是一个开源、社区软件项目。所有用户都欢迎对该软件包做出贡献。
可以使用以下命令获取最新源代码：
git clone https://github.com/ARM-DOE/ACT.git
如果您打算对 ACT 进行更改并希望这些更改被包含在内，强烈建议您对存储库进行分支。
我们欢迎对 ACT 的所有用途做出贡献，前提是代码可以在 BSD 3 条款许可证下分发。此目录中的 LICENSE.txt 文件中有此许可证的副本。有关更多贡献信息，请参阅贡献指南。
测试
对于测试，我们使用 pytest。要安装 pytest
$ conda install -c conda-forge pytest
并且可以使用 pytest 进行 matplotlib 图像测试
$ conda install -c conda-forge pytest-mpl
安装后，您可以从源目录外部启动测试套件（您需要安装 pytest，并且对于 mpl 参数需要 pytest-mpl）
$ pytest --mpl --pyargs act
可以使用源目录内的 pytest 命令测试就地安装。
下载文件
下载适合您平台的文件。如果您不确定该选择哪个，请了解有关 安装包 的更多信息。