primap2 0.11.1

结构

PRIMAP2是

• 基于xarray构建的灵活而强大的数据格式。

• 一组用于处理气候政策数据的常用任务的功能，如聚合和插值。

• 基于datalad构建的数据包格式，提供对一系列数据包的元数据提取和搜索。

状态

PRIMAP2正在积极开发中，上述承诺的内容并非全部已经实现。

许可证

版权所有 2020-2022，波茨坦气候变化影响研究所以及协会。

版权所有 2023-2024，气候资源有限公司。

本软件遵循Apache许可证2.0版本（以下简称“许可证”）；除非遵守许可证，否则您不得使用此文件。您可以在以下位置获取许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”提供，不提供任何形式的明示或暗示保证。有关许可证的权限和限制的具体语言，请参阅许可证。

PRIMAP2包含xarray和pint_xarray的部分内容，这些内容也遵循Apache许可证2.0。xarray的版权声明全文包含在许可证目录中。

引用

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

Mika Pflüger和Johannes Gütschow. (2024-07-08). pik-primap/primap2: PRIMAP2版本0.11.1. Zenodo. https://doi.org/10.5281/zenodo.12683509

0.11.1

• 解决xarray额外坐标的bug的解决方案

• 改进了一些错误信息

• 禁用xdoc，因为它会引发错误

• 修复了读取无量纲数据（单位为空字符串）的交换格式

0.11.0

• 移除了Python 3.9的支持。

• 为compose的优先级定义添加了exclude_result和exclude_input参数。它们可以用来跳过处理整个结果时间序列或特定输入时间序列，例如由于无效数据或类别。

• 添加了当输入时间序列不适当时跳过策略的协议，使用StrategyUnableToProcess异常。

• 为优先级和策略选择器添加了指定实体支持。

• 为优先级和策略选择器添加了指定多个值的支持。

• 在使用loc访问器时，添加了对primap2.Not值的负选择支持。

• 使用ruff格式化代替black格式化。

• 添加了新的csg子模块，其中包含从多个输入数据集生成组合数据集的函数和配置模型。

• 添加全局最小二乘策略

• 为DatasetDataFormatAccessor添加添加维度的功能

• 为聚合访问器添加对坐标/维度和实体的值聚合功能

• 向primap2数据格式添加了元数据变量。元数据变量描述了在时间序列级别上对数据所做的处理步骤。还将用于描述的元数据类添加到公共API中。我们支持将带有元数据变量的数据集保存到netcdf，但转换为交换格式会丢失元数据变量。

• 明确要求支持的Python版本。

0.10.0

• 修复了与最新pint和pint-xarray库的兼容性。

0.9.8

• 为降尺度功能添加了额外的nan处理控制

• 允许在气篮求和中使用kwargs

• 在pr.sum中将默认min_count设置为1

• 修复了pr.merge中0维数组错误信息

• 修复了在readthedocs.org上构建文档的问题

• 修改单位协调，如果可能，返回原生单位

0.9.7

• 修复测试套件以与Pint版本0.21一起工作

0.9.6

• 添加对openscm_units的依赖关系 > 0.5.1，以确保与最新pandas的兼容性。

• 停止构建PDF输出文档，因为它不支持SVG，并且很少使用。

• 放弃对Python版本3.8的支持，为4月14日Numpy停止支持做准备。

0.9.5

• pr.merge：使用xarray的combine_first代替自己的算法以获得更好的性能。

• 修复了to_interchange_format中的nan处理问题

• 在nir_add_unit_information中将regexp_unit设置为可选，如预期的那样，已经在之前进行了修改

• 支持Python 3.11

0.9.4

• 更新以支持Pint 0.20.1。

0.9.3

• 重构pr.merge。

• 修复primap2以支持xarray版本2022.06。

• 暂时将Pint锁定到版本0.20，以解决https://github.com/hgrecco/pint/issues/1631问题。

0.9.2

• 在Dataset和DataArray的.pr访问器中添加合并函数

0.9.1

• 由于发布程序中的错误，重新发布版本0.9.0。

0.9.0

• 放弃对python 3.7的支持，并添加python 3.10支持，遵循NEP 29。

• 将气体篮子聚合函数的行为更改为与其他聚合函数相同。现在，ds.pr.gas_basket_contents_sum()和ds.pr.fill_na_gas_basket_from_contents()像ds.pr.sum()一样工作。两者现在都有一个skipna参数，默认情况下，操作相当于skipna=True。请注意，这是一个破坏性的更改，现在在聚合气体篮子时，NaN被视为零值！

0.8.1

• 最新的（尚未发布）xarray版本包含索引的重构和一些对I/O函数的小修改，以支持新旧xarray。

• 在nir_convert_df_to_long中明确dropna

• 使nir_add_unit_information更加灵活

0.8.0

• 使convert_ipcc_code_primap_to_primap2的输入格式更加灵活

• 数据读取中的几个错误修复

• 在数据读取中，我们现在在输入数据框的副本上工作，以保持它不变

0.7.1

• 要求openscm-units >= 0.3以确保制冷剂和AR5GWPCCF可用。

• 使primap2与pint-xarray v0.2.1兼容。

0.7.0

• 为数据集添加publication_date属性以记录发布日期，这对于记录连续发布的数据集的发布日期特别有用。

• 切换到稳定的sphinx-autosummary-accessors版本。

• 将sphinx版本锁定以修复RTD LaTeX构建直到上游错误被修复。

• 将字符串类型的数据变量添加到PRIMAP规范中。

• 更新ensure_valid以适应更新的规范。

• 增强交换格式文档。

0.6.0

• 改进Makefile中的venv处理。

• 将宽csv读取函数拆分为转换函数和包装器

• 添加将长格式数据框转换为交换格式的函数

• 添加帮助读取不同国家温室气体清单的函数

• 向csv读取和DataFrame转换函数添加填充列的功能，使用来自其他列的信息

• 向交换格式和数据读取函数添加额外的坐标

• 将ruamel.yaml锁定到版本0.17.4，直到https://github.com/crdoconnor/strictyaml/issues/145被解决。

• 使用sum()而不是np.sum()与生成器一起使用，以避免弃用警告

• 将未发布更改的changelog条目写入changelog_unreleased目录中的单独文件，以避免合并冲突。

• 将依赖项对的依赖项提升到0.2，并修复由pint-xarray 0.2版本引入的测试回归。

0.5.0

• 添加交换格式的读取和写入功能

• 在pm2io模块中添加宽和长（整洁）CSV文件的csv读取功能。

• 添加da.pr.coverage()和ds.pr.coverage()函数以总结数据覆盖范围。

• 添加聚合函数set和count，它们使用别名并将结果缩减到一组给定的维度，包括实体。

• 更新python打包以使用声明性样式和现代setuptools。

• 支持并测试python 3.9和Windows。

• 为数据集添加属性以存储用于实体的术语（因此是变量名称）。

0.4.0

• 添加da.pr.set()和ds.pr.set()函数以覆盖/填充/扩展数据。

• 允许单个数据集/数据数组中有多个来源。

• 支持xarray 0.17，因此放弃对Python 3.6的支持。

0.3.1

• 重新发布0.3.0以触发zenodo。

0.3.0

• 增加对气篮和分类篮的降尺度和聚合功能的支持。

• 增加对基本GWP处理的功能、文档和测试。

• 为包含primap2 API的xarray生成补丁存根文件，添加Makefile目标。

• 增加开发文档，详细说明存储库结构和PRIMAP2开发所使用的工具。

• 添加选择和索引功能，理解如“面积”这样的维度名称，以及包括分类集如“面积（ISO3）”在内的完整维度键。与ds.pr[key]和ds.pr.loc[selection]以及da.pr.loc[selection]一起使用。

• 为所有当前包含的功能添加使用文档。

• 通过属性如ds.pr.references轻松访问元数据。

0.2.0

• 添加文档。

• 添加测试。

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

• 添加用于存储到和从netcdf加载的功能。

• 添加数据格式的描述。

• 添加确保数据集符合此数据格式的函数。

• 使用pint扩展访问器提供所有函数。

0.1.0

• 首个开发版本。