unfccc-di-api 4.0.4

警告

由于UNFCCC API最近的变化，UNFCCCApiReader类在标准环境中已无法使用。为了继续访问数据，您有两个选择

1. 使用新的 ZenodoReader。它使用类似于 UNFCCCApiReader 的 查询 函数提供访问权限，但仅支持查询包含所有数据的完整数据集。它依赖于我们的 数据包，我们定期更新；然而，数据自然不如直接从 API 查询那样最新。

2. 在不受 UNFCCC DI API 阻塞的环境中运行您的函数。根据我们的测试，Azure 虚拟机可以工作，以及 github 托管的运行者，但 Mac OS 运行者除外。

功能

• 高级 API，用于查询特定实体的所有信息。

• 低级 API，用于选择性地查询信息，其分辨率与 UNFCCC 网页查询工具相同。

引用

如果您使用此库并希望引用它，请按以下方式引用：

Mika Pflüger, Daniel Huppmann & Johannes Gütschow. (2024-01-08). pik-primap/unfccc_di_api: 版本 4.0.4. Zenodo. https://doi.org/10.5281/zenodo.10471122

数据包

如果您只需要所有数据的 CSV 和 parquet 格式（适用于使用 pandas 读取），请查看我们的 数据包。

CI 状态和其他链接

4.0.4 (2024-07-05)

• 使用最新数据发布版本，该版本已切换到所有数据的单个 parquet 文件。

4.0.3 (2024-07-04)

• 由于技术原因重新发布 4.0.2。

4.0.2 (2024-07-04)

• 使用 ZenodoReader 时，请使用截至 2024-07-04 发布的数据。

4.0.1 (2024-01-08)

• 使用 ZenodoReader 时，请使用截至 2024-01-08 发布的数据。

• 支持 python 3.12。

4.0.0 (2023-07-18)

• 破坏性变更：UNFCCC 限制了 API 访问，您可能需要更改代码以使用新的 ZenodoReader。

• 添加 ZenodoReader，它不依赖于 API 访问。

• 使用 ZenodoReader 时，请使用截至 2023-07-18 发布的数据。

• 使用较新的 Python 和 Sphinx 版本在 ReadTheDocs 上构建文档。

3.0.2 (2022-12-13)

• 支持 python 3.11。

• 停止支持 python 3.6。

3.0.1 (2022-03-15)

• 修复处理未指定措施 ID 的问题。DI API 开始返回没有名称或描述的措施 ID。我们现在将它们称为 未知措施编号 {measureId} 而不是出错。

3.0.0 (2021-12-03)

• 支持 python 3.10。

• 修复处理重复变量 ID 的问题。 注意：这涉及到对公共 API 的更改！特别是，UNFCCCSingleCategoryApiReader.variables 现在具有通用索引，而不是使用 variableId 作为索引。此外，query 函数现在如果提供 category_ids 则正确限制查询，并为多类别变量填充所有类别的数据。

• 修复针对较新 mypy 类型检查版本的 pre-commit 配置。

• 当查询结果为空时，抛出一个更具信息量的 NoDataError（KeyError 子类）而不是通用的 KeyError。

2.0.1 (2021-04-23)

• 更改构建系统。

2.0.0 (2021-02-09)

• 在查询数据时接受 ASCII 格式 gases，并将气体和单位归一化到 ASCII（可选），感谢 Daniel Huppmann。请注意，默认情况下，气体和单位已归一化到 ASCII，如果您出于兼容性原因需要旧行为，请将 normalize_gas_names=False 传递给您的 query() 调用。

1.1.1 (2021-02-08)

• 将 ipython 笔记本和 CHANGELOG 包含在发布 tarball 中。

1.1.0 (2021-01-25)

• 在查询未知实体时添加有用的错误消息，感谢 Daniel Huppmann。

1.0.0 (2021-01-22)

• 添加使用 GitHub actions 的持续集成。

• 添加测试。

• 以笔记本格式添加使用文档。

• 修复文档。

0.1.0 (2021-01-22)

• 在 PyPI 上的第一个版本。

• 将 API 包装器转换为独立的 Python 包。