一般描述

场景变化的参数。此参数中的值在时间上是恒定的，但在单个场景中会有所不同。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

基本参数提供 指数 方法。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

索引参数的集合。这个类的行为就像一个集合。可以在其中添加或删除参数。它的值是使用聚合函数（例如 sum）聚合的子参数的值。 API 参考资料

属性

示例

``json { “类型”：“聚合参数”， “agg_func”：“产品”， “参数”：[ “基准需求”， “控制曲线需求因子” ] }

在这种情况下，聚合参数是将两个参数相乘

* [基准需求](https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/parameters/constant#example)
* 控制曲线需求因子

此示例显示基准需求乘以根据储层控制曲线减少需求的系数。你可以点击每个参数来查看它们是如何定义的。  

description: WaterStrategy 支持的 Pywr 参数概述

参数

参数是在模型的每个时间步返回一个值的函数。这些值可以是基于时间（例如，当天或月份）的常数，基于时间步长的储层储量计算以及许多其他计算。自定义参数也可以用 Python 编写。

本页介绍了（大多数）Pywr 支持的参数类型。可以找到 Pywr 中的参数概述 这里。已找到内置 Pywr 参数的完整列表 这里。

1。创建参数

在网络中，单击 “参数” 选项卡：

在 “参数类型类别” 部分旁边，单击 “+” 按钮并选择 “PYWR\ _PARAMETER”。

将出现文本输入。输入您的参数的名称：\

在提供的 JSON 编辑器中根据需要修改参数：

2。WaterStrategy 中的参数编辑器

为了简化参数修改，WaterStrategy 为常用参数提供了编辑器，例如带有预填默认值的月度配置文件参数，并提供了图形编辑器以简化数据输入。

参数编辑器示例

在 “参数” 选项卡中，添加新参数时，选择 'PYWR_参数_每月\ _PROFILE' 如图所示：\

请注意，出现的编辑器将显示 JSON 选项卡，但也会显示 “绘图和表格” 选项卡。修改表中的数据将自动更新 JSON 中的数据，如下所示：\

这些更改会自动更新 JSON：

一般描述

取另一个的负数的参数 参数。 API 参考资料

属性

示例

即将推出...

``json {

}

所有的 参数 中的子类 pywr 是通用基类的后代。

一般描述

索引参数的集合

这个类的行为就像一个集合。可以在其中添加或删除参数。它的索引是使用聚合函数（例如 sum）聚合的子参数的索引。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

最少取另一个参数的参数 参数 和常量值（阈值）。

这个类是更有效的版本 聚合参数 在哪里 参数 与常量值进行比较。

属性

示例

即将推出...

``json {

}

一般描述

除以一个的参数 参数 由另一个。

属性

示例

即将推出...

``json {

}

一般描述

这个 每周概况 每年包含 52 周。一年的最后一周将有 7 天以上，因为 365/7 不是完整的。 API 参考资料

属性

示例

``json { 输入：'每周个人资料'， 值：[1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1...] }

一般描述

提供从一到零的均匀递减值的参数。

此参数旨在用于 年度虚拟存储 节点，提供代表年度交易量完美平均利用率的概况。它在重置日返回的值为 1，之后每天都会减少 1/366。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

提供每月概况的参数。月度配置文件根据当前时间步长的月份返回不同的值。 API 参考资料

属性

示例

``json { 类型：'月度个人资料'， 值：[1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1] }

Water Strategy 提供了另一种处理月度资料的方式。 

<figure><img src="../../../.gitbook/assets/image (119).png" alt=""><figcaption></figcaption></figure>

<figure><img src="../../../.gitbook/assets/image (120).png" alt=""><figcaption></figcaption></figure>

<figure><img src="../../../.gitbook/assets/image (121).png" alt=""><figcaption></figcaption></figure>

一般描述

提供每个场景的每周概况的参数

此参数提供重复的年度概况和每周分辨率。对于给定场景的每个成员，将返回不同的配置文件。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

取最小值 a 的负数的参数 参数 和常量值（阈值）。

属性

示例

即将推出...

``json {

}

一般描述

抵消另一个参数的参数 参数 按恒定值计算。

这个类是更有效的版本 聚合参数 在哪里 参数 被一个常量值所抵消。 API 参考资料

属性

上限_界限

示例

即将推出...

``json {

}

一般描述

取最大值为 a 的负数的参数 参数 和常量值（阈值）。

属性

示例

即将推出...

``json {

}

一般描述

一个改变索引参数的场景。此参数中的值在时间上是恒定的，但在单个场景中会有所不同。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

使用数组和 timestep.Index 的时变参数

此参数中的值在所有场景中都是恒定的。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

初始化自我。有关准确的签名，请参阅帮助（键入（自我））。

属性

示例

即将推出...

``json {

}

一般描述

此参数从 PyTables HDF 数据库读取数组数据。

该参数使用 PyTables 数组接口读取数据，因此不需要将整个数据集加载到内存中。这对于运行大型模型很有用。

通过以 “固定” 格式存储 HDF5 文件，用户可以实现最佳的数据访问速度，这使得 HDF5 成为使用 DataFrames 作为参数的 PyWR 场景的有效工具，在这些场景中，快速数据检索至关重要。HDF5 文件作为字典读取，其中每个密钥代表一个熊猫 DataFrame。例如，inflows.h5 文件的结构可能包含三个密钥，每个密钥代表不同的河流。每个密钥包含三个时间序列，可以将其分配给大小为 3 的 Pywr 场景。

如果使用 h5 文件 DataFrame 来运行 pywr-scenarios，请参阅 为了激活此功能

注意： pywr-scenaion 的大小必须与 h5 文件中的密钥数量相匹配

属性

示例

``json { “钥匙”：“集水河1”， “情景”：“气候变化”， “类型”：“数据框参数”， “网址”：“inflows.h5”， “index_col”: “时间步”， “parse_dates”：真 }

一般描述

使用索引参数来索引参数数组的参数。

此参数的一个示例用法是根据当前的需求储蓄水平（计算得出）返回需求储蓄系数（浮动值） 索引参数）。

属性

示例

请查看水库控制曲线参数是如何定义的。

一般描述

参数的基类，根据其他状态返回两个值之一。

属性

示例

即将推出...

``json {

}

一般描述

根据记录器值和阈值返回两个值中的一个。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

根据节点中先前的流程，返回两个值中的一个。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

根据当前音量，返回 Storage node 中的两个值之一。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

场景变化的参数。

此参数中的值因索引而异，并且在单个场景中会有所不同。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

使用数组和 timeStep.Index 的时变参数，每个场景都有乘法因子。

值是受因子干扰的基准时间序列数据。该因子取自形状因子（场景大小，12）。因此，因素因情景和月份的个别情景而异。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

一个定义常量值的简单参数。 API 参考资料

属性

示例

``json { 类型：'常量参数'， 值：123 }

一般描述

取另一个参数的最大值 参数 和常量值（阈值）。

这个类是更有效的版本 聚合参数 在哪里 参数 与常量值进行比较。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

提供每个场景的每月概况的参数。

行为是一样的 月度配置文件参数 唯一的不同是在给定场景中为每个集合返回不同的配置文件。

属性

示例

即将推出...

``json {

}

一般描述

根据当前时间步的序数返回两个值中的一个。

属性

示例

即将推出...

``json {

}

一般描述

参数值等于另一个参数的插值。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

具有自动对齐和重采样功能的时间序列参数。 API 参考资料

属性

示例

``json { “类型”：“数据框参数”， “网址”：“流入_mm3_day.csv “， “专栏”：“集水河1”， “index_col”: “时间步”， “parse_dates”：真 }

一般描述

根据当前时间步长的年份返回两个值之一。

属性

示例

即将推出...

``json {

}

一般描述

根据参数的值返回两个值中的一个。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

依赖于包含控件的附加节点的所有参数的基类_曲线参数。[API 参考资料] (https://pywr.github.io/pywr-docs/master/api/generated/pywr.parameters.control_curves.baseControlCurveParameter.html #pywr .parameters.control\ _curves.baseControlCurveParameter.

属性

示例

即将推出...

``json {

}

一般描述

参数值等于另一个参数插值的正交。 API 参考资料

属性

x 坐标用于插值的数据点限

示例

即将推出...

``json {

}

一般描述

提供每日概况的参数。

根据当前时间步长的月份，每日配置文件返回不同的值。 API 参考资料

属性

示例

``json { 类型：'dailyprofile'， 值：[1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1...] }

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

插值参数

一般描述

提供每个场景的每日概况的参数。

此参数提供重复的年度概况和每日分辨率。对于给定场景的每个成员，将返回不同的配置文件。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

使用径向基函数 (RBF) 插值每日轮廓的参数。

每日概况是在建模期间计算的 重置 使用以年日为自变量的径向基函数。一年中的天数由用户定义，另外还有每天用于插值的值。每年的第一天应始终为一，其值重复为第 366 个值。此外，对第二个和倒数第二个值进行了镜像，以鼓励边界上出现一致的梯度。RBF 计算是使用以下方法进行的 scipy.interpolate.rbf 对象，请参阅 Scipy 的文档以获取更多信息。 API 参考资料

属性

是上限

示例

即将推出...

``json {

}

示例

上面的代码定义了水库的3条储层控制曲线，称为 “水库名称”。它返回一个索引，具体取决于水库的装满程度：

一般描述

在每个场景集合中使用不同的子参数的参数。

此参数用于根据给定集合中的不同集合在不同的子参数之间切换 场景。它可用于在多个场景集合中改变非场景感知参数类型的数据。例如，许多控制曲线或插值参数并不明确支持场景。作为单个仿真的一部分，此参数可用于测试多个控制曲线定义。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

提供来自前一个时间步的节点流的参数。 API 参考资料

注意：此参数跟踪给定节点上前一个时间步的流量。这些值可用于计算当前时间步长，就好像这是任何其他参数一样。

属性

示例

即将推出...

``json {

}

一般描述

一个 参数 它返回年度谐波序列的值。

这个 参数 包括一个周期为 365 天的系列 N 余弦函数。使用一年中的朱利安日减去 1 进行计算。这在非闰年中会造成轻微的不连续性。 API 参考资料

$f (t) =a+n=1nan⋅COS ((2^nt) /365+0__n) $$

属性

示例

即将推出...

``json {

}

一般描述

参数跟踪节点的赤字（最大\ _flow-实际流量）。 API 参考资料

注意：这个参数有点不寻常，因为它的值是在after方法中计算的，而不是calc_价值观。它旨在与记录器（例如 NumpyArrayNodeRecorder）结合使用，以记录节点的赤字（定义为请求——实际流量）。请注意，这意味着记录此参数确实如此 不 给出求解器在此时间步中使用的值。或者，此参数可以由其他参数在模型中使用，其计算结果为 _昨天_赤字，其中第0个时间步的赤字为零。

属性

示例

即将推出...

``json {

}

一般描述

通用插值参数，使用上一个时间步的节点流进行插值。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

通用插值参数，根据水库或存储节点的当前（时间步长）体积返回值。这个

参数使用 排列 （表）的 水库容量 和相应的值。在这种情况下，关联值是对应的 库区 为了给定的 音量.

插值用于计算插值数组中给出的点之间的值。 API 参考资料

属性

示例

以下 Json 显示了水库面积与体积额定值的示例。这可用于定义存储或水库节点的区域属性。

``json { “类型”：“插值音量参数”， “节点”：“水库或 Storage node 名称”， “音量”：[ 0， 7, 10， 15， 25 ]， “价值观”：[ 1, 2， 4， 6, 14 ]，

“interp_kwargs”：{
	“种类”：“线性”
}，

“评论”：“体积：Mm3，值：Km2” }

Json 表示下表：

<table><thead><tr><th width="166">体积 (Mm3)</th><th width="182">面积 (Km2)</th></tr></thead><tbody><tr><td>0</td><td>1</td></tr><tr><td>7</td><td>2</td></tr><tr><td>10</td><td>4</td></tr><tr><td>15</td><td>6</td></tr><tr><td>25</td><td>14</td></tr></tbody></table>

绘制时它看起来像这样：

以下是区域评分表示例

<table><thead><tr><th width="166">体积 (Mm3)</th><th width="182">面积 (Km2)</th></tr></thead><tbody><tr><td>0</td><td>1</td></tr><tr><td>7</td><td>2</td></tr><tr><td>10</td><td>4</td></tr><tr><td>15</td><td>6</td></tr><tr><td>25</td><td>14</td></tr></tbody></table>

绘制时看起来像这样

<figure><img src="../../../.gitbook/assets/image (123).png" alt=""><figcaption></figcaption></figure>

一般描述

这个 水力发电目标参数 是一个返回水力发电目标流量的参数。此参数计算生成特定水力发电目标所需的流量。它旨在用于代表涡轮机的节点，其中每个时间步都需要特定的生产目标。 API 参考资料

属性

示例

``json {

}

一般描述

在两对或多对值之间进行插值的控制曲线参数。

返回值根据当前存储空间在一对值之间进行线性插值。第一对用于最大值和第一控制曲线之间，下一对用于第一控制曲线和第二控制曲线之间，依此类推，直到最后一对控制曲线和最小值之间使用最后一对控制曲线。每对中的第一个值是位于上方的值，第二个值是位于下方位置的值。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

集成分段函数的参数。

此参数计算分段函数的积分。分段函数以两个数组的形式给出（x 和 y) 并假定从 (0, 0) 开始。的价值观 x 应单调递增且大于零。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

在三个或更多值之间插值的控制曲线参数。

返回值在控制曲线之间线性插值，第一个和最后一个值分别为 100% 和 0%。 API 参考资料

属性

如果值为 “无”，则参数可以指定用于每条控制曲线的参数对象。参数的数量应为 2 + len（控制）_曲线）

示例

即将推出...

``json {

}

一般描述

根据折现率和基准年返回当前折扣系数的参数。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

返回给定时间步长或天数之后的节点延迟流量的参数。 API 参考资料

属性

示例

即将推出...

``json {

}