安装#

GluonTS 可以通过 PyPi 获取

pip install gluonts

注意

GluonTS 使用 语义化版本控制 来管理版本。由于该库正在积极开发中,我们将 v0 用作主要版本。

我们计划在每个季度末发布一个新的次要版本。当前的计划发布可以在 GitHub 上找到。

版本保证

重大更改只会在新的次要版本中引入。当前版本的错误修复和次要改进会按需发布。

对于生产环境使用,我们建议在安装 GluonTS 时限制版本

pip install gluonts==0.12.*

可选和额外的依赖项#

重要

GluonTS 使用最小依赖模型。

这意味着要使用大多数模型和功能,需要安装额外的依赖项。

Python 有 额外依赖项 (extras) 的概念,这些依赖项是可选安装的,用于解锁包的某些功能。

安装包时,它们通过 [...] 在包名称后、版本规范前传递

pip install "some-package[extra-1,extra-2]==version"

我们在 GluonTS 中大量使用可选依赖项,以保持所需依赖项的数量最少。为了仍然允许用户选择启用某些功能,我们提供了许多额外依赖项。

例如,我们支持使用 Apache Arrow 读取和写入基于 Arrow 和 Parquet 的数据集。然而,这是一个庞大的依赖项,尤其是在不需要它的情况下。因此,我们提供了 arrow 额外依赖项,它会安装所需的包,并且可以通过以下方式轻松启用

pip install "gluonts[arrow]"

模型#

PyTorch#

使用 PyTorch 编写的模型可以通过 gluonts.torch 子包获取。

除了 PyTorch,我们还需要安装 PyTorch Lightning

这两个所需的依赖项都包含在 torch 额外依赖项中

pip install "gluonts[torch]"

MXNet#

基于 MXNet 的模型需要安装特定版本的 mxnet

注意

MXNet 为 CPU 和 GPU 使用提供了不同的包。请参考其文档来选择适合您用例的正确版本。

mxnet 额外依赖项将安装仅支持 CPU 的版本

pip install "gluonts[mxnet]"

第三方#

R-Forecast#

GluonTS 包含一个轻量级封装,用于调用 Rforecast 包。

要使用它,您需要安装 R 并安装 forecast

R -e 'install.packages(c("forecast", "nnfor"), repos="https://cloud.r-project.org")'

您还需要安装 R 额外依赖项,使用

pip install "gluonts[R]"
Prophet#

Prophet 预测库可以通过 gluonts.model.prophet 获取,并且需要安装 prophet 包。您可以通过安装 prophet 额外依赖项来获取它

pip install "gluonts[prophet]"

数据集#

JSON#

由于 Python 内置的 json 包已知相对较慢,如果可用,我们使用更快的实现:orjson(推荐)和 ujson

您可以通过以下方式安装 orjson

pip install orjson

提示

如果未安装 orjsonujson,GluonTS 会发出警告。不同的实现之间没有功能差异,但特别是在处理大型数据集时,依赖默认的 json 包会显著影响性能。

Arrow#

GluonTS 支持使用 PyArrowParquet 文件。

此外,也支持 arrow 的自定义数据格式

要使用这些,请安装 pyarrow 包或使用 arrow 额外依赖项

pip install "gluonts[arrow]"

其他#

Shell#

shell 模块提供与 Amazon SageMaker 的集成,可通过以下方式获取

pip install "gluonts[shell]"