下表介绍了最常用的 Pywr 节点类型:
输入节点
输入节点代表系统中的水输入。
集水节点
集水节点通常用于表示流入系统的河流或其他类型的流入。
比例输入节点
比例输入节点适用于需要将固定流量比率分配给多条下游路径的简单情况。
Link Node
Link node 代表水系统中的一个环节或其他兴趣点,其中分配了最大或最小流量限制或分配优先级。
河流节点
河流节点是河流网络中的一个节点,它可能有多个上游节点(即汇合点),但只有一个下游节点。
延迟节点
这些延迟持续给定的时间步长或天数。当流量传播时间不可忽视时使用,例如因为时间步长相对较短。
Storage Node
Storage node 是可以储存水(如水坝或含水层)的通用节点,水量有最小和最大限制。
水库节点
储层节点是 storage node 的一种,具有表示蒸发和降水的附加功能。
输出节点
输出节点是水离开系统的位置。
损失 Link Node
损失链路允许定义流经此节点的固定比例的流量损失。
涡轮节点
涡轮节点可以代表水电站的涡轮机。它计算每个时间步生成特定水力发电目标所需的流量。
Pywr 节点类型还可以进一步细分为 6 个类别: 水输入, 水上运输, 储水, 水产量, 水电,以及 其他。您可以在 “节点类型” 部分的子部分中找到有关这些节点和节点类型分组的更多详细信息。
这个 集水节点 是另一种具有固定流入量的输入节点。集水节点通常用于表示流入系统的河流或其他类型的流入。在其上定义的任何流量都必须流入系统。
流入时间序列(例如 Pywr 数据框)通常定义在 流 属性表示集水流入量,但也可以使用其他参数(例如常量、月度概况等...)。
流
集水节点在每个时间步提供的水量
必填项,如果未输入,则默认为 0。
即将推出...
这个 比例输入节点 适用于需要将固定比例的流量分配给多条下游路径的简单案例。 API 参考资料。
分配罚款
通过节点的单位流量成本
可选
因素
施加额外分割的因素。额外数量_
假设插槽比因子长度小一(根据 pywr.nodes. MultisplitLink 文档)可选插槽
_名字
从该节点连接时引用插槽的标识符。长度必须比所需的额外插槽数多一个
可选
流
集水区每步提供的水量
可选
即将推出...
这个 link node 代表水系统或其他兴趣点中的一个环节,其中分配了最大或最小流量限制或分配优先级。请注意,在 Pywr 中,不能为边(链接)分配流量限制,因此链接节点通常用于此目的。 API 参考资料。
flow
分配罚款
通过节点的单位流量成本
可选
最大_
节点上的最大流量约束
可选
min_流
节点上的最小流量约束
可选
即将推出...
这个 河流节点 是河流网络中的一个节点,可能有多个上游节点(即汇合点),但只有一个下游节点。 API 参考资料。
flow
分配罚款
通过节点的单位流量成本
可选
最大_
节点上的最大流量约束
可选
min_流
节点上的最小流量约束
可选
即将推出...
这个 延迟节点 是一个将流量延迟给定时间步长或天数的节点。与所选时间尺度相比,当水传播时间不可忽略时,将使用此节点。 API 参考资料。
分配罚款
通过节点的单位流量成本
可选
时间步长
延迟流量的时间步数
可选
天
延迟流量的天数。仅当天数完全可以被模型时间步长 delta 整除时,指定天数(而不是时间步长)才有效
可选
初始流程
在任何延迟流可用之前,节点为初始时间步提供的流程。这在所有延迟时间步长和任何模型场景中都是恒定的。默认为 0.0
可选
即将推出...
这个 RiverSplit node 是河流网络的分裂。它适用于需要将固定比例的流量分配给多条下游路径的简单案例。 API 参考资料。
litLink 文档)。
因素
施加额外分割的因素。额外数量_假设插槽比因子长度小一(根据 pywr.nodes. Multisp
可选
插槽_名字
从该节点连接时引用插槽的标识符。长度必须比所需的额外插槽数多一个。
可选
即将推出...
这个 RiverSplitWithGauge node 是河网中残留流量 (MRF) 最小的分裂。按照 Riversplit 但默认情况下,在底层对象中创建另一条路径来建模 MRF。这条路径使得MRF不是强制比率的一部分。该对象的目的是模拟可以在MRF上方抽取一定比例的流量(例如,900__% 的流量高于MRF)的情况。 API 参考资料。
成本成本本
mrf
仪表处的最小残留流量 (MRF)
必填项
mrf_
通过 MRF 的路径
成本
所需
其他(不受约束的)路径的成
所需
因素
施加额外分割的因素。额外数量_假定槽位比因子长度小一(按照 MultSplitLink 文档)
必填项
插槽名称
从该节点连接时引用插槽的标识符。长度必须比所需的额外插槽数多一个
必填项
即将推出...
这个 RiverGaug 是一个河流测量站,残留流量(MRF)最小。 API 参考资料。
mrf
仪表处的最小残留流量 (MRF)
必填项
mrf_cost
通过 MRF 的路线费用
必填项
成本
另一条(不受限制)路线的成本
必填项
即将推出...
这个 BreakLink node 可用于减少模型中的路径数量。
例如,在具有形式 (3、1、3),即 3 个(A、B、C)输入通过瓶颈 (X) 连接到 3 个输出(D、E、F)的模型中,有 3 个\ *3 条路线 = 9 条路线。
如果 X 是存储,则只有 6 条路由:A->X_O,B->X_O,C->X_o 和 X_i->D_O,X_我->e_O,X_i->f\ _o。
BreakLink node 是一个复合节点,由 存储 音量为零和 链接。它可以代替普通链路,但好处是它减少了模型中的路由数量(在上述情况下)。由此产生的 LP 更容易求解。 API 参考资料。
值
分配罚款
通过节点的单位流量成本
可选
转换_
factor
节点流入量和流出量之间的转换可选最大
_流
节点上的最大流量约束
可选
分钟_flow
节点上的最小流量约束
可选 p
rev_流
在前一个时间步中通过此节点的总流量
可选
这个 PiecewiseLink node 是 Node 的扩展,表示非线性 链接 使用逐件成本函数。该对象旨在模拟提供特定流速有好处,但超过固定限值会发生变化(或零)成本的情况。 API 参考资料。
这个节点是使用复合节点结构实现的,如下所示:
这意味着路由不会直接穿过此节点,因为中间有单独的域。取而代之的是,为每个子链接和输出/输入节点的连接创建了几条新路由。路径中断的原因是为了避免在同一条路径中存在多个 PieceWiseLinks 时路径数量几何增加。
flow
分配罚款
通过节点的单位流量成本
可选
最大_
节点上的最大流量约束
可选
min_流
节点上的最小流量约束
可选
即将推出...
这个 MultiSplitLink node 是的扩展 PieceWiseLink 其中包括其他可供连接的插槽。
从概念上讲,这个节点在内部看起来像下面这样,
每个额外的插槽都会在 PieceWiseLink(即上面的 X2)和该类中的节点(即 Bo 和 Bi)中添加一个额外的子链接。
最后,提供了一种机制来(可选)固定最后一个非分割子链接(即 X1)和每个额外子链接(即 X2)之间的比率。该机制使用 聚合节点 内部。 API 参考资料。
注意:用户在使用因子机制时必须小心。因子使用最后一个非分割子链接(即 X1 但不是 X0)。如果此连接受最大或最小流量约束,或者如果它存在另一个不受约束的链接(即 X0 不受约束),则整个节点的比率可能无法按预期强制执行。
flow
分配罚款
通过节点的单位流量成本
可选
最大_
节点上的最大流量约束
可选额外的
_插槽
要提供的额外插槽(和子链接)的数量。必须大于零。
可选
时段_n
ames 连接其他节点时用来指代插槽的名称。长度必须比额外数目多一_老虎机。第一个项目是指 PieceWiseLink 连接,每个额外插槽都有以下物品。
可选
因素
如果给定,则长度必须等于比 extra_slots 的数量多一个。每个项目是通过附加子链接的总流量所占的比例。如果特定子链接不需要系数,则使用 无 用于其物品。在求解器中使用之前,对因子进行了归一化。
可选
即将推出...
layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true
水 storage node 类型允许用户使用不同的运行模式建造不同的水库。以下是最常用的储水节点:
Storage Node水库节点这个 storage node 是可以储存水的通用节点,水有最小和最大体积限制。 API 参考资料。
分配罚款
通过节点的单位流量成本
可选
分钟_容
量存储器的最小容量。
默认为 0.0 可选最大值
_卷
存储空间的最大容量。默认为 0.0
必填项,如果未输入,则默认为 0
初始的_音量,初始_卷_pc
以绝对值或比例形式指定初始音量。如果最大值,则两者都是必需的_卷 是一个参数,因为不会在第一个时间步对该参数进行评估。如果两者都给出并且 最大_体积不是参数,则绝对值将被忽略
一个是必填
区域、级别
可选浮点数或用于定义 storage node 面积和等级的参数。这些值可通过 get 获取_区域 和 get_level 方法分别是
可选
即将推出...
这个 水库节点 是 storage node 的子类,具有表示蒸发和降水的附加功能。 API 参考资料。
长度/天)可选单位
分配罚款
通过节点的单位流量成本
可选
分钟_容
量存储器的最小容量。
默认为 0.0 可选最大值
_卷
存储空间的最大容量。默认为 0.0
必填项,否则默认为 0
初始的_音量,初始_卷_pc
以绝对值或比例形式指定初始音量。如果最大值,则两者都是必需的_卷 是一个参数,因为不会在第一个时间步对该参数进行评估。如果两者都给出并且 最大_体积不是参数,则绝对值将被忽略
一个是必填
区域、级别
可选浮点数或用于定义 storage node 面积和等级的参数。这些值可通过 get 获取_区域 和 得到_
水平方法分别
可选
蒸发、降水蒸发和降水
率(
_转换
将降水和蒸发量转换为所需的长度/天单位的换算系数
可选,默认值为 0.001 转换为 mm/day 以用于 km2 库区
蒸发惩罚(蒸发成本)
根据蒸发输出设定分配补偿
可选,默认为-999
即将推出...
这个 VirtualStorage node 是一个虚拟存储单元。 API 参考资料。
注意事项:
待办事项:目前不考虑成本属性。参见问题 #242。
e
分配罚款
通过节点的单位流量成本
可选
节点
影响存储量的流入/流出节点列表
必填项
分钟_volum
允许存储器达到的最小容量
可选
的最大容量_卷
存储空间的最大容量
必填项,如果未输入,则默认为 0
初始体积
初始存储量
一个是必填的
因素
节点流量乘以的因素列表。正面因素将水从储藏室中排出,负面因素将其排出。
可选
即将推出...
这个 滚动虚拟存储节点 是一个滚动虚拟 storage node,可用于实施滚动许可证。 API 参考资料。
注意事项:
待办事项:目前不考虑成本属性。参见问题 #242。
e
分配罚款
通过节点的单位流量成本
可选
节点
影响存储量的流入/流出节点列表
必填项
分钟_volum
允许存储器达到的最小容量
可选
的最大容量_卷
存储空间的最大容量
必填项,如果未输入,则默认为 0
初始体积
初始存储量
一个是必填的
因素
节点流量乘以的因素列表。正面因素将水从储藏室中排出,负面因素将其排出。
可选
时间步长
应用于滚动存储的时间步长
必填项
天
应用滚动存储空间的天数。指定天数(而不是时间步长)仅对运行时间步长为每日频率的模型有效
必填项
即将推出...
这个 年度虚拟存储节点 是一种虚拟存储,每年重置一次,可用于许可证。 API 参考资料。
重置
重置_
d
ay 将音量重置为初始值的当月 (0-31) 需要
_月
将音量重置为初始值的一年中的月份 (0-12)
必填项
重置_到_初始体积
将音量重置为初始音量而不是每年的最大音量(默认为 False)
必填项
即将推出...
这个 季节性虚拟存储节点 是一种虚拟的 storage node,仅在一年内的指定时间段内运营。
此节点对于表示仅在指定时间段内强制执行的许可证最有用。这个 重置_天 和 重置_月 参数表示节点何时开始运行以及 结束_天 和 结束_月 当它停止运行时。在节点不运行期间,节点的体积保持不变,并且该节点不对模型施加任何约束。
结束_一天和一天结束_月可以表示重置年份中较早的日期_天和重置_月。这种情况代表许可证的有效期为一年.例如,一个在 10 月到 3 月之间处于活动状态而在 4 月到 9 月之间不处于活动状态的产品。API 参考资料。
。
重置_day
节点开始运行且其音量重置为初始值或最大音量的月中某一天(0-31)
需要
重置_月
一年中节点开始运行且其音量重置为初始值或最大音量的月份(0-12)。
必填项
重置_到_初始的_音量
将音量重置为初始音量而不是每年的最大音量(默认为 False)
必填
结束_天
节点停止运行的月份中的某一天(0-31)
必填项
end_month
节点停止运行的一年中的月份(0-12)
必填项
即将推出...
Loading...
Loading...
Loading...
layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true
水力发电节点类型允许用户定义大坝中涡轮机的相关细节并计算水力发电。
涡轮节点这个 涡轮机节点 可以代表水力发电站的涡轮机。它计算每个时间步生成特定水力发电目标所需的流量。 API 参考资料。
分配罚款
通过节点的单位流量成本
可选
目标
水力发电目标。单位应以每天的能量单位为单位
可选
水_仰角_参数
进入涡轮机的水的海拔。此值与 涡轮机_仰角给出涡轮机的工作头
可选
最大值_流
计算出流量的上限。如果设置,则此参数返回的流量最多为最大值_流量参数
可选
最小值_流
计算出流量的下限。如果设置,则此参数返回的流量至少是最小值的值_流量参数
可选
最小值_头
产生流量的最小扬程。如果实际水头小于此值,则返回零流量
可选
涡轮机_
涡轮机本身的海拔高度。水的区别_仰角 这个值给出了涡轮机的工作头
可选
效率
涡轮机的效率
可选
密度
水的密度
可选
流_单元_转换
用于将流量单位转换为与此处的方程兼容的因子。这应该将流量转换为立方米/天的单位
可选
能源_单元_转换
用于转换总能量单位的因子。默认为 1e-6 以返回 MJ
可选
即将推出...
Loading...
Loading...