description: 如何与其他 WaterStrategy 用户共享项目或网络

共享项目和网络

项目：这些就像对子项目和网络进行分组的文件夹。

网络：在 WaterStrategy 中，每个具有唯一网络的模型都被称为 “网络”。

人物图标：表示您只能访问项目或网络。

人物图标：表示多人有权访问一个项目或网络。

创建者：创建了项目或网络。

直接共享：项目或网络是专门共享给用户的。

继承自：（“项目名称”）：用户可以通过共享包含该子项目或网络的项目来访问该子项目或网络。

1。要共享项目，请输入项目并单击 “成员” 选项卡。

2。输入您想与之共享的收件人账户的电子邮件。

您可以选择向收件人授予两种权限。

允许用户重新共享？: 允许他们与他人共享项目和内部的项目/网络。

允许用户编辑项目？: 允许他们编辑项目内部的项目/网络。

3.选择权限后选择 “邀请”。

下面，您可以查看与谁共享项目、管理与谁共享、查看他们的权限以及他们如何获得访问权限。

您可以选择向收件人授予一些权限。

允许用户重新共享？: 允许他们与他人共享网络。

允许用户编辑项目？：允许他们编辑网络。

Clone 网络：创建重复网络。防止更改先前存在的网络。如果选择 “克隆网络”，则有以下选项。

在新网络中包含结果？：将运行结果包含在克隆网络中。

是否包括所有场景？：将创建的场景包括在克隆网络中。

网络名称：创建克隆网络的名称。

5。输入您想与之共享的收件人账户的电子邮件。 6。选择权限后单击 “共享”。

运行 Pywr 模型不需要 WaterStrategy；它可以帮助用户更轻松地使用 Pywr 模型。如果你有 Pywr 模型输入文件（它们被称为 “JSON” 文件），并且你的计算机上安装了所需的 Python 和 Pywr 库，则可以在没有 WaterStrategy 的情况下运行 Pywr 模型（注意：需要 Python 技能）。同样，如果你有 Pywr 模型（一个 JSON 文件），你可以将其导入到 1234567890__ 中。

本页介绍如何将模型从 WaterStrategy 导出到 Pywr JSON 文件中，以及如何将现有 Pywr 模型（JSON 文件）导入到 WaterStrategy

导出和导入模型

导出 Pywr 文件

本节使用创建账户时提供的 “演示网络”。

首先点击下载按钮。

然后，我们将选择我们的格式。

首先选择 Hydra JSON 格式。如果你想启用换行符，让你的代码或文本更易于阅读。如果它是一个大文件，你可以压缩它。

提交。

接下来，下载 Pywr JSON 格式。

然后，你可以在你选择保存它们的文件夹中找到这两个文件。

导入 Pywr 文件

让我们看看如何导入 Pywr 文件。

首先，点击 “创建项目”，在你的 Water Strategy 账户中创建一个项目文件夹。

为项目命名，然后单击 “添加”。

点击创建的项目。

点击 “创建网络”。

选择 “Hydra JSON”。

点击 “选择文件”。

选择 Hydra JSON 文件。

选择模板。

点击 “提交”。

然后，你可以发现网络已导入。

要导入 Pywr JSON 文件，您可以按照以下步骤操作。

再次点击 “创建网络”。

选择 “Pywr JSON”。

点击 “选择文件”。

选择 Pywr JSON 文件。

选择模板。

对于投影，您可以选择 “无”、“英国” 或 “世界”。在这种情况下，我们将选择 “世界”。

点击 “提交”。

最后，你可以在这里查看导入的网络。

description: 如何在 WaterStrategy 中创建免费账户

创建账户

观看视频或关注以下文字。 WaterStrategy 账户是在上创建的 https://hydra.org.uk/register （“Hydra” 是我们的网络服务器的名称）。

创建账户

1。在 WaterStrategy 网页选择右上角的 “登录”。

1。在 “登录” 带您进入的网页底部选择 “创建帐户”。 2。在注册页面中，输入您的电子邮件、名字、姓氏、组织类型、组织、国家或地区，创建密码，选择 “我不是机器人”，然后选中三个复选框。 3.然后选择 “注册”。 4。将向您发送一封确认电子邮件以确认您的帐户。请务必同时检查您的垃圾邮件文件夹。 5。您的账户已创建。

登录

1。要登录，请访问 https://hydra.org.uk/login 或者使用 WaterStrategy 网页 “登录”

1。输入您的电子邮件和密码，然后再次选中底部的三个方框。如果你愿意，选择 “记住我”。 2。然后选择 “登录”。 3.您将进入 Water Strategy 接口主页。

description: 此页面显示如何登录 WaterStrategy

登录

1。要登录，请前往 （Hydra 是我们目前托管 WaterStrategy 的安全服务器） 2。输入你的 WaterStrategy 用户名和密码 3.点击 “登录”

如果你忘记了密码，请点击 ''link.

请注意：出现提示时允许使用 cookie。

description: 有不同的方法可以申请对 WaterStrategy 的支持。

支持

WaterStrategy 的 Discord 频道受到定期监控，为开发者和用户提供支持。你可以在那里报告错误或申请新功能。通过此链接注册：

或者，你可以发电子邮件 support@waterstrategy.org

创建新项目和网络

1。在界面主页中，点击右上角的 “创建项目”。 2。键入您的项目名称，然后选择 “添加”。 3.输入您的新项目。 4。点击右侧的 “创建网络”。 5。选择 “手动” 选项卡。 6。输入网络名称。 7。选择这两个 pywr 模板中的任何一个。

-其他模板适用于其他建模系统，例如电力系统。

8。选择 “使用地图” 以显示用于构建模型的世界地图。 9。点击 “提交”。 10。输入创建的网络。 11。切换并缩放到尼罗河沿岸的某个区域。

12。选择 “构建” 下拉列表。

13。将集水区、连接线和两个输出节点拖到模型中，如下所示。

-第二个输出节点（河外）将用作抽水节点。

-注意集水节点在上游，输出节点在下游。

（尼罗河在这部分和整体上都向北流动）

14。使用 “链接” 功能，沿流向连接节点。

-这是通过先单击上流节点，然后单击下流节点来完成的。

description: 观看 WaterStrategy 界面的概述；以下是文字摘要。

界面之旅

项目：包含相关网络的文件夹，也可以包含其他项目文件夹（子项目）。

-每个项目文件夹都显示其中的网络和子项目文件夹的数量。

网络：模型。

1。在界面主页上，选择 “培训材料” 项目。 2。选择 Demo 1 网络。

-在网络内部，在页面的顶部，你将在下面看到一个看起来像这样的栏。

-“主页” 和 “我的项目” 选项卡将带你回到界面主页。

-“文档和培训” 将带您进入界面教程视频和书面说明页面。

-“收藏夹” 选项卡允许您为项目、网络和场景添加书签。它还允许访问最近访问和最近修改的项目和网络。

-“返回'培训材料'” 将带你回到培训材料项目文件夹。

-绿色播放按钮运行模型。

-扳手按钮提供对高级网络实用程序的访问，例如导入或导出网络数据。

-矩形按钮的向下箭头用于下载模型，用于离线运行或发送给某人。

-三行是 “查看网络数据”。

3.单击 “查看网络数据”。

\ 在 “详细信息” 中，你可以更改网络的名称。

-有时需要退出网络才能更新。

\ 在 “输入” 中，您可以更改模型的开始、结束和时间步。

-d=天，m=月，Y=年表示时间步。

4。点击扳手图标进入 “设置”。

显示标签-显示节点名称

链接方向-显示链接的流向

Show Tooltips-将鼠标悬停在节点上方时显示节点信息

自动隐藏侧边栏-不使用时隐藏侧边栏

始终按类型对属性进行分类-在节点内，会将属性分组为标量、描述符等。

5。单击 “i” 转到 “信息”。

-你可以看到你的 “网络 ID” 和其他信息。

6。关闭侧边栏并转到页面左侧的场景部分。

-场景是模型中输入数据、水文等的变体。

-在模型中制作多个场景时很常见。

Button 1（左）-克隆场景

Button 2-编辑场景

Button 3-删除场景

Button 4-刷新场景列表

Button 5-书签场景

Button 6（右）-比较场景

-要创建新场景，请在创建后根据需要更改模型输入数据后，克隆一个先前存在的场景，为其命名。

7。单击 “运行模型” 按钮。

-保留基准情景。

-保留所有其他默认值。

8。点击 “提交”。

\ 在页面左侧的 “跑步” 部分中，您将看到新的跑步和过去的跑步。

-Yellow=在队列中运行

-Blue=正在运行

-Green=成功运行

-Red=运行失败

9。单击 “运行” 部分下方的 “构建”。

-这提供了构建模型所需的所有节点和链接。

-插入节点后，需要输入数据。

10。单击 “构建” 部分下方的 “搜索”。

-这使您可以轻松地在大型模型中找到节点和链接。

地图左上角的炸弹按钮允许您在需要时扩展模型以减少其拥挤程度。

地图-显示模型

资源-可以查看您的节点、链接和群组

Metrics-提供聚合模型输出的功能

自定义规则-自定义操作规则

参数-添加 pywr 中未包含的参数

Recorders-添加不包含在 pywr 中的录音机

Members-显示必须访问模型的成员及其拥有的权限，也可以在此选项卡中添加成员并选择他们拥有的权限

分析-比较场景中的节点和链接

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

处理模型错误

如果存在技术故障或模型配置不正确，WaterStrategy 会报告错误。学习如何理解和使用模型错误报告来发现模型中的问题是一项重要而必不可少的建模技能。

本章举例说明如何阅读错误报告以查找模型中导致错误的部分。

如何获取错误报告

当运行失败时，您将在运行部分看到运行变为红色。

点击红色的运行栏，您将获得运行概览，包括错误报告。

滚动到报告的末尾。 运行将在此处报告其错误。

在这次运行中，可以发现月度配置文件输入不正确。

在某些情况下，将提供有关运行报告中错误的更多详细信息。请务必回顾运行日志，看看是否有任何与该问题相关的线索。

向上滚动时，我们会看到 “关键”。这表示已识别出错误。在同一行中，它指出了错误在哪里。

“示例储层” 节点的输入 “蒸发” 不正确。

我们可以编辑 “蒸发” 参数来解决这个问题。

每月资料中有 13 个值，我们需要删除不属于的值。在这种情况下，“3.1234567890__” 不应该出现在月度简介中。

保存参数并再次运行此模型。

现在模型已成功运行。

一般描述

这个 集水节点 是另一种具有固定流入量的输入节点。集水节点通常用于表示流入系统的河流或其他类型的流入。在其上定义的任何流量都必须流入系统。

流入时间序列（例如 Pywr 数据框）通常定义在 流 属性表示集水流入量，但也可以使用其他参数（例如常量、月度概况等...）。

API 参考资料。

主要属性

例子

即将推出...

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

水上运输

水运节点类型允许用户根据实际条件定义水如何流经不同节点。以下是最常用的水路运输节点：

description: 它是如何运作的？它输出什么？以及它是如何使用的？

水资源系统建模？

为了了解水系统当今的表现并评估未来变化的影响，规划人员建立了水资源系统模型。

水资源系统可以是小型的，例如城市及其供水来源，也可以是大型的，例如拥有许多不同河流、水基础设施资产和用水者的国家。无论你是想评估当前水源的可靠性，还是在合理的未来条件下评估新的干预措施，这样的计算机模型都有助于跟踪整个系统（空间）和一段时间内的水资源。

给定有关水文流量和气候、用水需求和使用以及水资源管理规则和分配的数据，水系统模型会输出每个建模位置和时间步的水流量和体积。汇总这些结果后，它们可以准确地反映出不同的水资源干预措施（水政策或基础设施的变化）可能会如何发挥作用。

description: WaterStrategy 帮助个人和组织了解他们的供水系统并评估未来的计划。WaterStrategy 的文档可帮助你建造、完善和使用水系统的数字双胞胎。 layout: description: visible: true outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

WaterStrategy 文档

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

水输入

水输入节点是水进入系统的机制。在这里，我们介绍三个最常用的水输入节点。

description: 为了建立 “数字双胞胎”（计算机模拟器），WaterStrategy 使用 Pywr（“Python 水资源”）。

什么是 Pywr？

Pywr 是一个免费的开源 Python 语言软件库，允许构建高质量（详细和准确）的水资源系统仿真模型。

Pywr 模型可以在您的计算机上快速运行，如果是 WaterStrategy，则可以在云端快速运行。它们可以代表小型水资源系统，例如城市的供水系统，也可以代表非常大的水资源系统，例如横跨多个国家的河流流域，拥有数百名用水者和基础设施资产。Pywr 可以在不同的时间步长（从每天到每月）模拟短期（例如几个月）或更长的周期（如 100 年）。

以下是 Pywr 建模过程的摘要：

1\。设置模型

首先，需要空间水系地图以及相关的水文和用水需求数据。WaterStrategy 可帮助您创建此网络地图，其中包含水进入系统（“流入”）、用水地点（“用水需求”）以及水资源管理地点（基础设施位置）的所有地点（“节点”）。这些节点形成由河流、运河或管道连接的网络（Pywr 称这些为 “链接” 或 “边缘”）。设置网络地图后，即可提供供水和需求数据（通常为时间序列）。

2\。运行模拟

输入所有数据（包括时间步长和时间范围）后，模型就可以进行仿真了（即逐步穿越时间并在整个系统中进行水资源核算）。在每个时间步开始时，计算机首先向所有流入地点注水，然后将这些水输送到管网并分配到不同的用水需求和基础设施位置。该分配过程使用一种称为线性编程的计算技术来执行。一个时间步完成后，模型会更新存储空间，记录哪些地点有多少水，然后继续到下一个时间步长，直到模拟时间跨度结束。

每个用水需求节点都被分配了一个优先级，以表示模型中的水资源分配。每个节点都有相关的惩罚，分配算法在整个网络中分配水，以最大限度地减少总体损失。这种简单的方法允许进行快速且可维护的模拟，可以灵活地表示详细而现实的水管理规则。

3\。查看结果

模型输出包括有多少水进入每个地点（节点），以及每个时间步中有多少水储存、消耗或流过该地点（节点）。这可以跟踪基础设施的使用情况，以及城市、生态系统、灌溉区、发电厂等是否有足够的水。研究结果详细说明了水资源管理系统的运作方式以及水资源收益的分配情况。

最初，模型的参数化很差，产生的预测不准确（“垃圾进入，垃圾流出” 阶段）。但是，随着时间的推移，随着模型的改进（“校准”），它可以成为帮助运营或规划供水系统的有价值的数字双胞胎。该工具可帮助您的组织快速而廉价地评估未来潜在水资源变化和干预措施的影响，并做出正确的决策。

祝你好运！

在 WaterStrategy 中，用户可以通过将外部文件中的数据加载为，灵活地更有效地管理大型复杂的数据集 DataFrame参数 使用 “url” 关键字，而不是将所有数据直接嵌入到接口中。文件格式包括：

• CSV

• Excel

• HDF5

注意： 在前面的选项中，Excel 文件性能最慢，而 HDF5 文件性能最好，是大型数据集的首选。

要在 WaterStrategy 中上传文件，请导航到您的 项目 然后单击 “文件” 选项卡。从那里，单击 选择文件 然后选择你要上传的文件，然后单击 .

这会将文件添加到您的项目中，使其可用于项目内的所有网络。

文件上传后，它们将显示在 档案 项目中的选项卡。从那里，您可以轻松地在项目中的所有网络中查看、管理和共享它们。

一般描述

输入节点代表系统中的水输入。

在每个时间步中，输入节点可以提供尽可能多的水 最大流量 属性。但是，不像 集水节点 它们需要释放在 Flow 属性中定义的水量，除非输入节点的水量为非零，否则不需要释放任何水 最小流量。

输入节点通常用于表示由收益率定义的来源。它们通常用于表示地下水产量。

API 参考资料。

主要属性

例子

即将推出...

description: Pywr 中使用的关键术语。

Pywr 概念

Pywr 是 WaterStrategy 使用的 Python 库，它通过使用 “节点” 和 “边缘” 将资源系统表示为网络来模拟资源分配。资源分配由使用 “分配惩罚”、“约束” 和 “参数” 的操作规则驱动，使用 “记录器” 捕获和保存模型输出。可以使用 “场景” 指定模型输入的变体并行运行。

虽然在 Pywr 中创建资源分配模拟模型所用的一般概念与其他工具的概念类似，但术语的用法可能有所不同。在本节中，我们定义了关键 Pywr 术语及其在仿真模型中的作用。

节点

节点表示模拟水系统中添加、储存、使用、消耗或输送水的位置。Pywr 中有不同的节点类型可以帮助您构建水系统模型；您可以在 Pywr 中了解有关它们的更多信息 部分。定义节点物理特征和行为的数据可以直接添加到节点中，也可以通过引用参数间接添加数据（如下所述）。

边缘

为了形成网络，使用代表水路输送的连接线连接节点。Pywr 称这些为 “边缘”。边缘有起点和终点节点，水从起始节点流向终点节点。Pywr 不会为这些连接（边缘）分配信息，而是将数据分配给源节点和目标节点。模拟水管理所需的所有数据都存储在节点上，边缘仅决定水流方向。Pywr 建模者会说 “Pywr 边缘决定网络拓扑”，这意味着 “节点之间的连接决定了计算机模型中水的移动方式”。

约束

可以在各种节点类型上设置约束条件以帮助表示系统行为。例如，河流节点可以具有最大和/或最小流量值来表示输送能力。在 Pywr 中，许多节点都有 'max_流量'和'最小值_flow' 属性，用于在需要时设置流经节点的流量的上限和下限。'max\ _flow'属性不要求通过该节点的流量达到这个值，但是如果水量和优先级足够，模型将尝试满足 “最大流量”。应谨慎使用最小流量约束，因为如果无法满足最小流量约束，它们可能会导致模型不可行。

分配罚款或 “成本”

分配惩罚是控制水资源分配优先级的节点属性。这些通常以罚款或 “成本” 表示，该模型首先将水分配给罚款最低的节点。如果您更愿意按福利进行分配，首先将水输送到收益最高的地方，则需要在Pywr中将优先级表示为负成本（即使用负数）。实际上，两者可以一起使用，例如，如果 3 个节点受到惩罚-10、2、6，则它们将按该顺序获得水（惩罚为-10 的节点先获得水，分配惩罚为 6 的节点最后获得水）。

参数

Pywr 中的参数为向节点提供输入提供灵活便捷的方式。例如，特定参数类型可用于从微软 Excel 文件加载流入或要求数据。参数还为定义系统的运行规则（例如，管理储层释放的规则）提供了一种灵活且可定制的方式。大多数模型输入数据可以使用参数提供。

录音机

Pywr 记录器用于对结果进行后期处理。通过创建记录器，您可以观察和保存仿真结果。一些记录器可以汇总一段时间（例如，从每天到每年）和空间（例如，分配给一组节点的水）的结果。

场景

在 Pywr 中，您可以使用不同的供应、需求或其他变化输入数据创建和模拟场景。水资源规划者越来越多地使用具有多种情景的长期模拟来评估未来的变化或测试可能的干预措施。能够快速模拟许多合理的未来场景是 Pywr 的主要优势之一。

注意：

一般描述

这个 比例输入节点 适用于需要将固定比例的流量分配给多条下游路径的简单案例。 API 参考资料。

主要属性

例子

即将推出...

下表介绍了最常用的 Pywr 节点类型：

Pywr 节点类型还可以进一步细分为 6 个类别： 水输入， 水上运输， 储水， 水产量， 水电，以及 其他。您可以在 “节点类型” 部分的子部分中找到有关这些节点和节点类型分组的更多详细信息。

更多细节

可以找到 Pywr 中节点的概述 这里。可以找到 Pywr 中内置节点的完整列表 这里。

一般描述

这个 link node 代表水系统或其他兴趣点中的一个环节，其中分配了最大或最小流量限制或分配优先级。请注意，在 Pywr 中，不能为边（链接）分配流量限制，因此链接节点通常用于此目的。 API 参考资料。

主要属性

flow

例子

即将推出...

一般描述

这个 河流节点 是河流网络中的一个节点，可能有多个上游节点（即汇合点），但只有一个下游节点。 API 参考资料。

主要属性

flow

例子

即将推出...

一般描述

这个 延迟节点 是一个将流量延迟给定时间步长或天数的节点。与所选时间尺度相比，当水传播时间不可忽略时，将使用此节点。 API 参考资料。

主要属性

例子

即将推出...

一般描述

这个 RiverSplitWithGauge node 是河网中残留流量 (MRF) 最小的分裂。按照 Riversplit 但默认情况下，在底层对象中创建另一条路径来建模 MRF。这条路径使得MRF不是强制比率的一部分。该对象的目的是模拟可以在MRF上方抽取一定比例的流量（例如，900__% 的流量高于MRF）的情况。 API 参考资料。

主要属性

成本成本本

例子

即将推出...

一般描述

这个 RiverSplit node 是河流网络的分裂。它适用于需要将固定比例的流量分配给多条下游路径的简单案例。 API 参考资料。

主要属性

litLink 文档）。

例子

即将推出...

一般描述

这个 RiverGaug 是一个河流测量站，残留流量（MRF）最小。 API 参考资料。

主要属性

例子

即将推出...

一般描述

这个 BreakLink node 可用于减少模型中的路径数量。

例如，在具有形式 (3、1、3)，即 3 个（A、B、C）输入通过瓶颈 (X) 连接到 3 个输出（D、E、F）的模型中，有 3 个\ *3 条路线 = 9 条路线。

一个 -->\/--> D
B --> X --> E
C -->/\--> F

如果 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 参考资料。

主要属性

值

例子

一般描述

这个 水库节点 是 storage node 的子类，具有表示蒸发和降水的附加功能。 API 参考资料。

主要属性

长度/天）可选单位

例子

即将推出...

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

储水

水 storage node 类型允许用户使用不同的运行模式建造不同的水库。以下是最常用的储水节点：

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

水产量

输出节点是水离开系统的位置。以下是最常用的出水节点：

一般描述

这个 聚合存储节点 是其他的总和 节点

这个对象的行为应该像 存储 通过返回电流 流， 卷 和 当前_pc。但是，此对象无法连接到网络中的其他对象。 。

注意：此节点无法连接到网络中的其他节点。

主要属性

例子

即将推出...

一般描述

这个 PiecewiseLink node 是 Node 的扩展，表示非线性 链接 使用逐件成本函数。该对象旨在模拟提供特定流速有好处，但超过固定限值会发生变化（或零）成本的情况。 API 参考资料。

这个节点是使用复合节点结构实现的，如下所示：

        | 单独的域名         |
输出-> 子链接 0-> 子输出-> 输入
       -> 子链接 1 ---^
       ...             |
       -> 子链接 n ---|

这意味着路由不会直接穿过此节点，因为中间有单独的域。取而代之的是，为每个子链接和输出/输入节点的连接创建了几条新路由。路径中断的原因是为了避免在同一条路径中存在多个 PieceWiseLinks 时路径数量几何增加。

主要属性

flow

例子

即将推出...

一般描述

这个 涡轮机节点 可以代表水力发电站的涡轮机。它计算每个时间步生成特定水力发电目标所需的流量。 。

主要属性

例子

即将推出...

一般描述

这个 滚动虚拟存储节点 是一个滚动虚拟 storage node，可用于实施滚动许可证。 API 参考资料。

注意事项：

待办事项：目前不考虑成本属性。参见问题 #242。

主要属性

e

例子

即将推出...

一般描述

一个 丢失链接 允许定义流经此节点的固定比例流量损失。损失链接通常用来表示 饮用水处理工程 这会造成一些过程损失。

定义的最大和最小流量属性应用于损失后的净输出。

节点本身在其 flow 属性中记录净输出（任何连接的记录器都将使用该属性）。

主要属性

示例

在此示例中，10流入节点的总水量中有百分比流失。

一般描述

这个 聚合节点节点 是其他的总和 节点 节点。

这个对象的行为应该像 节点 通过返回电流 流。但是，此对象无法连接到网络中的其他对象。 API 参考资料。

注意：此节点无法连接到网络中的其他节点。

主要属性

例子

即将推出...

一般描述

这个 VirtualStorage node 是一个虚拟存储单元。 API 参考资料。

注意事项：

待办事项：目前不考虑成本属性。参见问题 #242。

主要属性

e

例子

即将推出...

一般描述

这个 storage node 是可以储存水的通用节点，水有最小和最大体积限制。 API 参考资料。

主要属性

例子

即将推出...

一般描述

这个 输出节点 （) 是网络任意点的通用输出。输出节点将水从系统中移除。

河流尽头需要输出节点，在此用例中，通常不会分配分配惩罚或最大\ _flow。

输出节点还用于表示消耗用水需求。在此用例中，它们往往会分配负的分配罚款，因此线性程序会向他们分配水，并给出最大流量，可以是常量或代表用水需求的参数。

主要属性

flow

例子

即将推出...

WaterStrategy 中的场景允许用户通过调整模型的不同元素来模拟和探索各种水管理策略。它们为理解输入、假设或数据的变化如何影响不同条件下的结果提供了一个框架。

WaterStrategy 提供两种类型的场景来满足水管理建模中的各种需求：

1。 WaterStrategy 场景： 当用户需要在本地化或较小范围内调整特定行为、参数或数据时，可使用此类型。这些场景非常适合只需要调整模型的某些元素而不更改整个数据集的情况。它允许进行有针对性的修改，从而更容易测试系统内单个变更的影响。 2。 PyWR 场景： 这种情景类型旨在处理更复杂的案例，尤其是那些涉及不确定性的案例。它专门合并多个尺度的数据，允许对不同的变量进行全面评估。这种方法在处理不确定输入或对未来条件进行建模时特别有用，因为它使您能够探索不同的数据和假设组合会如何影响结果。

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

其他

其他节点类型允许用户获得专门设计的水资源系统的计算结果。

pywr 场景与以下参数兼容：

• DataFrame参数

• 常量场景参数

• 常量场景索引参数

• ScenarioDailyProfile参数

• 场景每周配置文件参数

• 场景月度配置文件参数

• 数组索引场景参数

• 数组索引场景MonthlyFactors参数

• ScenarioWrapper参数

一般描述

这个 年度虚拟存储节点 是一种虚拟存储，每年重置一次，可用于许可证。 API 参考资料。

主要属性

重置

例子

即将推出...

description: WaterStrategy 支持的 Pywr 参数概述

参数

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

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

1。创建参数

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

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

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

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

2。WaterStrategy 中的参数编辑器

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

参数编辑器示例

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

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

这些更改会自动更新 JSON：

一般描述

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

属性

示例

即将推出...

``json {

}

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

一般描述

这个 季节性虚拟存储节点 是一种虚拟的 storage node，仅在一年内的指定时间段内运营。

此节点对于表示仅在指定时间段内强制执行的许可证最有用。这个 重置_天 和 重置_月 参数表示节点何时开始运行以及 结束_天 和 结束_月 当它停止运行时。在节点不运行期间，节点的体积保持不变，并且该节点不对模型施加任何约束。

结束_一天和一天结束_月可以表示重置年份中较早的日期_天和重置_月。这种情况代表许可证的有效期为一年.例如，一个在 10 月到 3 月之间处于活动状态而在 4 月到 9 月之间不处于活动状态的产品。API 参考资料。

主要属性

。

例子

即将推出...

一般描述

这个 MultiSplitLink node 是的扩展 PieceWiseLink 其中包括其他可供连接的插槽。

从概念上讲，这个节点在内部看起来像下面这样，

         / -->-- X0 -->-- \
一个 -->-- Xo -->-- X1 -->-- Xi -->-- C
         \ -->-- X2 -->-- /
                 |
                 Bo -->-- Bi --> D

每个额外的插槽都会在 PieceWiseLink（即上面的 X2）和该类中的节点（即 Bo 和 Bi）中添加一个额外的子链接。

最后，提供了一种机制来（可选）固定最后一个非分割子链接（即 X1）和每个额外子链接（即 X2）之间的比率。该机制使用 聚合节点 内部。 API 参考资料。

注意：用户在使用因子机制时必须小心。因子使用最后一个非分割子链接（即 X1 但不是 X0）。如果此连接受最大或最小流量约束，或者如果它存在另一个不受约束的链接（即 X0 不受约束），则整个节点的比率可能无法按预期强制执行。

主要属性

flow

例子

即将推出...

一般描述

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

属性

示例

即将推出...

``json {

}

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

水电

水力发电节点类型允许用户定义大坝中涡轮机的相关细节并计算水力发电。

一般描述

索引参数的集合

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

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

Pywr 场景为水管理建模提供了一种更先进、更全面的方法，尤其是在处理不确定性以及评估数据和系统行为及数据输入的各种组合时。与侧重于本地调整的 WaterStrategy 场景不同，Pywr 场景允许您通过同时改变多个输入和组合来尝试各种可能性。

在 Pywr 场景中：

• 用户可以定义多个场景，每个场景包含多个变体（或大小）。

• 除非选择了特定的组合进行模拟，否则系统将模拟这些变体的所有组合。

例如，如果定义了两个 Pywr 场景，每个场景都有三个变体（大小 = 3），则模拟总数将为 9（3 x 3）。这种方法使用户能够探索模型中不同因素之间的各种潜在结果和相互作用。

1。激活 Pywr 场景

在网络中，单击 查看网络数据 图标

这将打开右侧面板。在本节中 输入，键入”场景” 然后点击 添加输入 图标

将显示一个窗口，键入”场景”，选择 场景 属性并单击 保存 如下图所示

将弹出一个新窗口，选择 PYWR_场景 然后点击 保存

2。创建 pywr 场景

场景自定义面板打开后，您可以根据需要定义任意数量的 Pywr 场景。要创建新的 Pywr 场景，请执行以下步骤：

输入 姓名 对于 Pywr 场景并指定 大小 （变体数量）。

这个 合奏 属性是可选的，有助于跟踪 Pywr 场景中的特定索引场景

创建 pywr-scenaion 后，系统将显示以下信息：

点击 JSON 选项卡将显示的自动 JSON 版本 Pywr-Scenario 定义

分配惩罚是允许 Pywr 模拟水资源分配的节点属性。它们也可以被称为 “分配优先级” 或 “成本”。

低罚款将具有最高的分配优先级，较高的数字具有最低的分配优先级。

因此，例如，如果三个节点的优先级为 100、3 和 -2，则值为 -2 的节点首先获得水，然后是 3，然后是 100。

以下是一些关于水资源分配罚款的问题，以及一些简短的答案：

1。Pywr 为什么以及如何分配这样的水资源？在每个时间步中，Pywr 的分配算法（线性程序）都将整个系统的分配损失降至最低。流经节点的流量乘以其各自的分配罚款。自1950年代以来，能源、运输和水资源规划人员以及物流公司一直在使用这种技术。他们都想要廉价运行的系统，因此他们通常使用财务运营成本作为罚款。这是有道理的，它允许使用该模型以最低的成本平衡供需网络。 2。你觉得负数罚款的想法令人困惑吗？如果是这样，可以将负数罚款视为负成本，那是什么？一个好处！因此，如果你想在 Pywr 模型中将水资源分配到能产生最大效益的地方，你将使用负数罚款。在这种情况下，与其将这些节点属性称为分配惩罚或成本，不如将它们称为分配优先级。在这种情况下，分配优先级为-1234567890__ 的节点早在-1234567890__ 之前就会获得水。如上面第三句中的示例所示，负分配罚款和正数分配罚款都可以在同一个模型中使用。 3.分配罚款有特殊含义吗？不，他们没有。它们只是为了帮助你的模型以对你、水资源管理者和规划者来说合理的方式分配水资源。 4。我怎么知道我设定的水资源分配罚款是否正确？如果您的模型在正常条件下，以及在洪水和干旱期间都适当地分配了水资源，那么您已经设置了适当的惩罚。恭喜！您的模型即将变得 “校准良好”。 5。如果我对模型进行了重大更改，例如添加大型新基础设施或添加新的用水用户类型，我是否需要更改模型中的处罚？是的，模型中的一些处罚可能需要细化，具体取决于变化的重要性。试着看看。 6。我可以用任何数字作为罚款吗？比如，如果我的模型有 2 个节点，我能否使用负一百万和正一百万作为惩罚？是的，但这是个坏主意。使用尽可能接近的数字。否则，随着模型的增长，你可能会用尽可用的惩罚，你的模型将开始出现舍入错误。但是，如果您使用的惩罚过于相似，则您的模型可能对其不敏感（即，在模拟分配时未充分考虑它们）。通过一点经验，你将学会设定行之有效的点球。要获得这种经验，请尝试更改惩罚，看看它如何影响模型的输出。

最后，我们提供了更多有关罚款的技术细节：

• 水库和存储节点都有分配罚款。负值意味着水库往往会积水，除非另一个节点的罚款较低会导致水库存储的优先级降低。

• 分配惩罚可以是常量（恒定参数）或随时间变化的剖面图（每月、每天、每周）。此外，分配罚款可以根据储层容量的不同控制曲线来定义不同的水平。尽管水库和储量分配处罚会影响水储量，但由于算法试图将每个时间步的总体系统损失降至最低，因此考虑到下游的分配惩罚，这些节点的释放将由系统的惩罚平衡导致。

WaterStrategy 情景为对水资源管理模型中的特定要素进行有针对性的调整提供了工具。当您想以灵活可控的方式尝试对参数、行为或数据进行局部更改时，这些场景特别有用。

创建 WaterStrategy 场景时，它充当一个 叉子 现有网络模型的。原始网络分配给基线方案，该场景代表系统的默认或启动条件。从这个基准来看，WaterStrategy 场景允许进行精确的修改，无论是更改数据输入还是调整定义系统中关键元素行为的参数。

这种修改模型某些方面而保持其余部分不变的能力使 WaterStrategy 场景非常适合测试单个变更的影响。例如，您可以更改水库运行规则或修改需求预测，而无需重建整个模型。这种有针对性的方法可以帮助用户快速评估具体的修改如何影响完善水管理策略的结果。

创建 WaterStrategy 场景

首先单击 “克隆场景” 图标。

选择要克隆的场景并命名您的场景

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

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

一般描述

取另一个的负数的参数 参数。

属性

示例

即将推出...

``json {

}

一般描述

取最小值 a 的负数的参数 参数 和常量值（阈值）。 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 {

}

一般描述

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

属性

示例

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

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

提供每日概况的参数。

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

属性

示例

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

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

是上限

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

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

一般描述

场景变化的参数。

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

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

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

属性

示例

{
	“类型”：“indexedarrayparameter”，
	“索引_参数”：“水库控制曲线”，
	“参数”：[
		1,
		0.9，
		0.8，
		0.5
	]
}

上面的代码使用名为 “水库控制曲线” 的参数提供的索引，该参数是 控制曲线索引参数。 索引 0 返回 1，索引 2 返回 0.9 等...

在此示例中，此参数用于根据储层控制曲线减少需求。请前往 聚合参数示例 看看这是怎么做的。

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

一般描述

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

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

通过以 “固定” 格式存储 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 {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

根据参数的值返回两个值中的一个。

属性

示例

即将推出...

``json {

}

一般描述

根据当前时间步长的年份返回两个值之一。 API 参考资料

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

根据当前时间步的序数返回两个值中的一个。 API 参考资料

属性

示例

即将推出...

``json {

}

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

插值参数

一般描述

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

属性

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

示例

即将推出...

``json {

}

一般描述

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

属性

示例

即将推出...

``json {

}

一般描述

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

属性