epyt-flow 0.10.0__tar.gz → 0.11.0__tar.gz

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: epyt-flow
-Version: 0.10.0
+Version: 0.11.0
 Summary: EPyT-Flow -- EPANET Python Toolkit - Flow
 Author-email: André Artelt <aartelt@techfak.uni-bielefeld.de>, "Marios S. Kyriakou" <kiriakou.marios@ucy.ac.cy>, "Stelios G. Vrachimis" <vrachimis.stelios@ucy.ac.cy>
 License: MIT License
@@ -184,6 +184,17 @@ Besides that, you can read in-depth about the different functionalities of EPyT-
 we recommend reading the chapters in the order in which they are presented;
 you might decide to skip some of the last chapters if their content is not relevant to you.
 
+## More Networks and Benchmarks
+
+More Water Distribution Networks (WDNs) and benchmarks are available on the
+[WaterBenchmarkHub](https://waterfutures.github.io/WaterBenchmarkHub) platform.
+
+## More on Control
+
+We recommend checking out [EPyT-Control](https://github.com/WaterFutures/EPyT-Control)
+if you are intersted in (data-driven) control and relates tasks such as state estimation
+and event diagnosis in Water Distribution Networks.
+
 ## License
 
 MIT license -- see [LICENSE](LICENSE)

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/README.md

@@ -146,6 +146,17 @@ Besides that, you can read in-depth about the different functionalities of EPyT-
 we recommend reading the chapters in the order in which they are presented;
 you might decide to skip some of the last chapters if their content is not relevant to you.
 
+## More Networks and Benchmarks
+
+More Water Distribution Networks (WDNs) and benchmarks are available on the
+[WaterBenchmarkHub](https://waterfutures.github.io/WaterBenchmarkHub) platform.
+
+## More on Control
+
+We recommend checking out [EPyT-Control](https://github.com/WaterFutures/EPyT-Control)
+if you are intersted in (data-driven) control and relates tasks such as state estimation
+and event diagnosis in Water Distribution Networks.
+
 ## License
 
 MIT license -- see [LICENSE](LICENSE)

epyt_flow-0.11.0/epyt_flow/VERSION

@@ -0,0 +1 @@
+0.11.0

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/data/networks.py

@@ -154,8 +154,9 @@ def load_net1(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "Net1.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Net1.inp"
+    backup_urls = ["https://raw.githubusercontent.com/OpenWaterAnalytics/EPyT/refs/heads/dev/epyt/networks/asce-tf-wdst/Net1.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -201,8 +202,9 @@ def load_net2(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "Net2.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Net2.inp"
+    backup_urls = ["https://raw.githubusercontent.com/OpenWaterAnalytics/EPyT/refs/heads/dev/epyt/networks/asce-tf-wdst/Net2.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -248,8 +250,9 @@ def load_net3(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "Net3.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Net3.inp"
+    backup_urls = ["https://raw.githubusercontent.com/OpenWaterAnalytics/EPyT/refs/heads/dev/epyt/networks/asce-tf-wdst/Net3.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -342,8 +345,9 @@ def load_richmond(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "Richmond_standard.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Richmond_standard.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/Richmond_standard.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -389,8 +393,9 @@ def load_micropolis(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "MICROPOLIS_v1.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/MICROPOLIS_v1.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/MICROPOLIS_v1.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -436,8 +441,9 @@ def load_balerma(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "Balerma.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Balerma.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/Balerma.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -483,8 +489,9 @@ def load_rural(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "RuralNetwork.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/RuralNetwork.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/RuralNetwork.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -530,8 +537,9 @@ def load_bwsn1(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "BWSN_Network_1.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/BWSN_Network_1.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/BWSN_Network_1.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -577,8 +585,9 @@ def load_bwsn2(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "BWSN_Network_2.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/BWSN_Network_2.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/BWSN_Network_2.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -624,8 +633,9 @@ def load_anytown(download_dir: str = get_temp_folder(), verbose: bool = True,
     """
     f_in = os.path.join(download_dir, "Anytown.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Anytown.inp"
+    backup_urls = ["https://raw.githubusercontent.com/OpenWaterAnalytics/EPyT/refs/heads/dev/epyt/networks/asce-tf-wdst/Anytown.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -670,9 +680,10 @@ def load_dtown(download_dir: str = get_temp_folder(), verbose: bool = True,
         :class:`~epyt_flow.simulation.scenario_simulator.ScenarioSimulator`.
     """
     f_in = os.path.join(download_dir, "d-town.inp")
-    url = "https://www.exeter.ac.uk/media/universityofexeter/emps/research/cws/downloads/d-town.inp"
+    url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/d-town.inp"
+    backup_urls = ["https://raw.githubusercontent.com/KIOS-Research/EPANET-Benchmarks/refs/heads/master/collect-epanet-inp/d-town.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -774,8 +785,9 @@ def load_kentucky(wdn_id: int = 1, download_dir: str = get_temp_folder(),
 
     f_in = os.path.join(download_dir, f"ky{wdn_id}.inp")
     url = f"https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/ky{wdn_id}.inp"
+    backup_urls = [f"https://raw.githubusercontent.com/OpenWaterAnalytics/EPyT/refs/heads/dev/epyt/networks/asce-tf-wdst/ky{wdn_id}.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     return load_inp(f_in, flow_units_id=flow_units_id)
 
 
@@ -826,8 +838,9 @@ def load_hanoi(download_dir: str = get_temp_folder(),
     """
     f_in = os.path.join(download_dir, "Hanoi.inp")
     url = "https://filedn.com/lumBFq2P9S74PNoLPWtzxG4/EPyT-Flow/Networks/Hanoi.inp"
+    backup_urls = ["https://raw.githubusercontent.com/OpenWaterAnalytics/EPyT/refs/heads/dev/epyt/networks/asce-tf-wdst/Hanoi.inp"]
 
-    download_if_necessary(f_in, url, verbose)
+    download_if_necessary(f_in, url, verbose, backup_urls)
     config = load_inp(f_in, flow_units_id=flow_units_id)
 
     if include_default_sensor_placement is True:

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/gym/control_gyms.py

@@ -1,6 +1,8 @@
 """
 Module provides functions for registering and creating control environments.
 """
+import warnings
+
 from .scenario_control_env import ScenarioControlEnv
 
 
@@ -18,6 +20,9 @@ def register(env_name: str, env: ScenarioControlEnv) -> None:
     env : :class:`~epyt_flow.gym.scenario_control_env.ScenarioControlEnv`
         Environment.
     """
+    warnings.warn("'register()' is deprecated and will be removed in future releases -- " +
+                  "please consider switching to the EPyT-Control package")
+
     if env_name in environments:
         raise ValueError(f"Environment '{env_name}' already exists.")
     if not issubclass(env, ScenarioControlEnv):
@@ -41,6 +46,9 @@ def make(env_name: str, **kwds) -> ScenarioControlEnv:
     :class:`~epyt_flow.gym.scenario_control_env.ScenarioControlEnv`
         Environment.
     """
+    warnings.warn("'make()' is deprecated and will be removed in future releases -- " +
+                  "please consider switching to the EPyT-Control package")
+
     if env_name not in environments:
         raise ValueError(f"Unknown environment '{env_name}'.")
 

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/gym/scenario_control_env.py

@@ -177,9 +177,14 @@ class ScenarioControlEnv(ABC):
             raise RuntimeError("Can not execute actions affecting the hydraulics "+
                                "when running EPANET-MSX")
 
-        pump_idx = self._scenario_sim.epanet_api.getLinkPumpNameID().index(pump_id)
-        pump_link_idx = self._scenario_sim.epanet_api.getLinkPumpIndex(pump_idx + 1)
-        self._scenario_sim.epanet_api.setLinkStatus(pump_link_idx, status)
+        pump_idx = self._scenario_sim.epanet_api.getLinkPumpNameID().index(pump_id) + 1
+        pump_link_idx = self._scenario_sim.epanet_api.getLinkPumpIndex(pump_idx)
+
+        pattern_idx = self._scenario_sim.epanet_api.getLinkPumpPatternIndex(pump_idx)
+        if pattern_idx != 0:
+            warnings.warn(f"Can not set pump state of pump {pump_id} because a pump pattern exists")
+        else:
+            self._scenario_sim.epanet_api.setLinkStatus(pump_link_idx, status)
 
     def set_pump_speed(self, pump_id: str, speed: float) -> None:
         """

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/metrics.py

@@ -1,11 +1,16 @@
 """
 This module provides different metrics for evaluation.
 """
+import warnings
 import numpy as np
 from sklearn.metrics import roc_auc_score as skelarn_roc_auc_score, f1_score as skelarn_f1_scpre, \
     mean_absolute_error, root_mean_squared_error, r2_score as sklearn_r2_score
 
 
+warnings.warn("'epyt_flow.metrics' is deprecated in favor of EPyT-Control " +
+              "and will be removed in future releases.")
+
+
 def r2_score(y_pred: np.ndarray, y: np.ndarray) -> float:
     """
     Computes the R^2 score (also called the coefficient of determination).

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/models/event_detector.py

@@ -1,11 +1,16 @@
 """
 Module provides a base class for event detectors.
 """
+import warnings
 from abc import abstractmethod, ABC
 
 from ..simulation.scada import ScadaData
 
 
+warnings.warn("'epyt_flow.models' is deprecated in favor of EPyT-Control " +
+              "and will be removed in future releases.")
+
+
 class EventDetector(ABC):
     """
     Base class for event detectors.

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/models/sensor_interpolation_detector.py

@@ -1,6 +1,7 @@
 """
 Module provides a simple residual-based event detector that performs sensor interpolation.
 """
+import warnings
 from typing import Any, Union
 from copy import deepcopy
 import numpy as np
@@ -10,6 +11,10 @@ from .event_detector import EventDetector
 from ..simulation.scada import ScadaData
 
 
+warnings.warn("'epyt_flow.models' is deprecated in favor of EPyT-Control " +
+              "and will be removed in future releases.")
+
+
 class SensorInterpolationDetector(EventDetector):
     """
     Class implementing a residual-based event detector based on sensor interpolation.

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/serialization.py

@@ -52,6 +52,7 @@ SIMPLE_CONTROL_ID                       = 32
 COMPLEX_CONTROL_ID                      = 33
 COMPLEX_CONTROL_CONDITION_ID            = 34
 COMPLEX_CONTROL_ACTION_ID               = 35
+COLOR_SCHEMES_ID                        = 36
 
 
 def my_packb(data: Any) -> bytes:

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/simulation/__init__.py

@@ -1,5 +1,4 @@
 from .scenario_config import *
 from .sensor_config import *
 from .scenario_simulator import *
-from .scenario_visualizer import *
 from .parallel_simulation import *

{epyt_flow-0.10.0 → epyt_flow-0.11.0}/epyt_flow/simulation/events/actuator_events.py

@@ -134,7 +134,13 @@ class PumpStateEvent(PumpEvent, JsonSerializable):
     def apply(self, cur_time: int) -> None:
         pump_idx = self._epanet_api.getLinkPumpNameID().index(self.pump_id) + 1
         pump_link_idx = self._epanet_api.getLinkPumpIndex(pump_idx)
-        self._epanet_api.setLinkStatus(pump_link_idx, self.__pump_state)
+
+        pattern_idx = self._epanet_api.getLinkPumpPatternIndex(pump_idx)
+        if pattern_idx != 0:
+            warnings.warn(f"Can not set pump state of pump {self.pump_id} " +
+                          "because a pump pattern exists")
+        else:
+            self._epanet_api.setLinkStatus(pump_link_idx, self.__pump_state)
 
 
 @serializable(PUMP_SPEED_EVENT_ID, ".epytflow_pump_speed_event")