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

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 EPyT-Flow Developers
+Copyright (c) EPyT-Flow Developers
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: epyt-flow
-Version: 0.8.1
+Version: 0.10.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
@@ -17,10 +17,11 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: epyt>=1.2.0
+Requires-Dist: epyt>=1.2.1
 Requires-Dist: requests>=2.31.0
 Requires-Dist: scipy>=1.11.4
 Requires-Dist: u-msgpack-python>=2.8.0
@@ -66,8 +67,8 @@ Unique features of EPyT-Flow that make it superior to other (Python) toolboxes a
 - High- and low-level interface
 - Object-orientated design that is easy to extend and customize
 - Sensor configurations
-- Wide variety of pre-defined events (e.g. leakages, sensor faults, actuator events, cyber-attacks, etc.)
-- Wide variety of pre-defined types of uncertainties (e.g. model uncertainties)
+- Wide variety of pre-defined events (e.g. leakages, sensor faults, actuator events, contamination, cyber-attacks, etc.)
+- Wide variety of pre-defined types of global & local uncertainties (e.g. model uncertainties)
 - Step-wise simulation and environment for training and evaluating control strategies
 - Serialization module for easy exchange of data and (scenario) configurations
 - REST API to make EPyT-Flow accessible in other applications
@@ -76,7 +77,7 @@ Unique features of EPyT-Flow that make it superior to other (Python) toolboxes a
 
 ## Installation
 
-EPyT-Flow supports Python 3.9 - 3.12
+EPyT-Flow supports Python 3.9 - 3.13
 
 Note that [EPANET and EPANET-MSX sources](epyt_flow/EPANET/) are compiled and overwrite the binaries
 shipped by EPyT **IF** EPyT-Flow is installed on a Unix system and the *gcc* compiler is available.

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

@@ -29,8 +29,8 @@ Unique features of EPyT-Flow that make it superior to other (Python) toolboxes a
 - High- and low-level interface
 - Object-orientated design that is easy to extend and customize
 - Sensor configurations
-- Wide variety of pre-defined events (e.g. leakages, sensor faults, actuator events, cyber-attacks, etc.)
-- Wide variety of pre-defined types of uncertainties (e.g. model uncertainties)
+- Wide variety of pre-defined events (e.g. leakages, sensor faults, actuator events, contamination, cyber-attacks, etc.)
+- Wide variety of pre-defined types of global & local uncertainties (e.g. model uncertainties)
 - Step-wise simulation and environment for training and evaluating control strategies
 - Serialization module for easy exchange of data and (scenario) configurations
 - REST API to make EPyT-Flow accessible in other applications
@@ -39,7 +39,7 @@ Unique features of EPyT-Flow that make it superior to other (Python) toolboxes a
 
 ## Installation
 
-EPyT-Flow supports Python 3.9 - 3.12
+EPyT-Flow supports Python 3.9 - 3.13
 
 Note that [EPANET and EPANET-MSX sources](epyt_flow/EPANET/) are compiled and overwrite the binaries
 shipped by EPyT **IF** EPyT-Flow is installed on a Unix system and the *gcc* compiler is available.

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/REQUIREMENTS.txt

@@ -1,4 +1,4 @@
-epyt>=1.2.0
+epyt>=1.2.1
 requests>=2.31.0
 scipy>=1.11.4
 u-msgpack-python>=2.8.0

epyt_flow-0.10.0/epyt_flow/VERSION

@@ -0,0 +1 @@
+0.10.0

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/__init__.py

@@ -6,6 +6,7 @@ import os
 
 with open(os.path.join(os.path.dirname(__file__), 'VERSION'), encoding="utf-8") as f:
     VERSION = f.read().strip()
+    __version__ = VERSION
 
 
 def compile_libraries_unix(lib_epanet_name: str, compile_script_name: str,

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/data/benchmarks/batadal.py

@@ -91,7 +91,7 @@ def load_data(download_dir: str = None, return_X_y: bool = False,
     `dict`
         Dictionary of the loaded benchmark data. The dictionary contains the two training
         data sets ("train_1" and "train_2"), as well as the test data set ("test").
-        If `return_X_y` is False, each dictionary entry is a Pandas dataframe.
+        If `return_X_y` is False, each dictionary entry is a `Pandas dataframe <https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.html>`_.
         Otherwise, it is a tuple of sensor readings and labels (except for the test set) --
         if `return_ground_truth` is True or `return_features_desc` is True, the corresponding
         data is appended to the tuple.

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/data/benchmarks/battledim.py

@@ -286,7 +286,7 @@ def load_data(return_test_scenario: bool, download_dir: str = None, return_X_y:
 
     Returns
     -------
-    Either a `pandas.DataFrame` instance or a tuple of Numpy arrays.
+    Either a `pandas.DataFrame <https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.html>`_ instance or a tuple of `Numpy arrays <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_.
         Benchmark data set.
     """
     # Download data files if necessary
@@ -389,8 +389,9 @@ def load_scada_data(return_test_scenario: bool, download_dir: str = None,
     :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` or `list[tuple[numpy.ndarray, numpy.ndarray]]`
         The simulated benchmark scenario as either a
         :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` instance or as a tuple of
-        (X, y) Numpy arrays. If 'return_leak_locations' is True, the leak locations are included
-        as an instance of `scipy.sparse.bsr_array` as well.
+        (X, y) `Numpy arrays <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_.
+        If 'return_leak_locations' is True, the leak locations are included
+        as an instance of `scipy.sparse.bsr_array <https://docs.scipy.org/doc/scipy/reference/generated/scipy.sparse.bsr_array.html>`_ as well.
     """
     download_dir = download_dir if download_dir is not None else get_temp_folder()
 

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/data/benchmarks/gecco_water_quality.py

@@ -31,9 +31,9 @@ def compute_evaluation_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Event indication prediction over time
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth event indication over time.
 
     Returns
@@ -85,7 +85,7 @@ def load_gecco2017_water_quality_data(download_dir: str = None, return_X_y: bool
 
     Returns
     -------
-    `pandas.DataFrame` or `tuple[numpy.ndarray, numpy.ndarray]`
+    `pandas.DataFrame <https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.html>`_ or `tuple[numpy.ndarray, numpy.ndarray] <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         The benchmark data set as either a Pandas data frame or as a pair of (X, y) Numpy arrays.
     """
     url_data = "https://zenodo.org/records/3884465/files/1_gecco2017_water_quality.csv?download=1"
@@ -154,7 +154,7 @@ def load_gecco2018_water_quality_data(download_dir: str = None, return_X_y: bool
 
     Returns
     -------
-    `pandas.DataFrame` or `tuple[numpy.ndarray, numpy.ndarray]`
+    `pandas.DataFrame <https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.html>`_ or `tuple[numpy.ndarray, numpy.ndarray] <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         The benchmark data set as either a Pandas data frame or as a pair of (X, y) Numpy arrays.
     """
     # Download data if necessary

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/data/benchmarks/leakdb.py

@@ -97,7 +97,7 @@ def compute_evaluation_score(scenarios_id: list[int], use_net1: bool,
         List of scenarios ID that are to be evaluated -- there is a total number of 1000 scenarios.
     use_net1 : `bool`
         If True, Net1 LeakDB will be used for evaluation, otherwise the Hanoi LeakDB will be used.
-    y_pred_labels_per_scenario : `list[numpy.ndarray]`
+    y_pred_labels_per_scenario : `list[numpy.ndarray] <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted binary labels (over time) for each scenario in `scenarios_id`.
 
     Returns
@@ -201,7 +201,7 @@ def load_data(scenarios_id: list[int], use_net1: bool, download_dir: str = None,
         The default is False.
     return_leak_locations : `bool`
         If True and if `return_X_y` is True, the leak locations are returned as well --
-        as an instance of `scipy.sparse.bsr_array`.
+        as an instance of `scipy.sparse.bsr_array <https://docs.scipy.org/doc/scipy/reference/generated/scipy.sparse.bsr_array.html>`_.
 
         The default is False.
     verbose : `bool`, optional
@@ -327,7 +327,7 @@ def load_scada_data(scenarios_id: list[int], use_net1: bool = True, download_dir
         The default is False.
     return_leak_locations : `bool`
         If True, the leak locations are returned as well --
-        as an instance of `scipy.sparse.bsr_array`.
+        as an instance of `scipy.sparse.bsr_array <https://docs.scipy.org/doc/scipy/reference/generated/scipy.sparse.bsr_array.html>`_.
 
         The default is False.
     verbose : `bool`, optional
@@ -341,7 +341,7 @@ def load_scada_data(scenarios_id: list[int], use_net1: bool = True, download_dir
         The simulated benchmark scenarios as either a list of
         :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` instances or as a list of
         (X, y) Numpy arrays. If 'return_leak_locations' is True, the leak locations are included
-        as an instance of `scipy.sparse.bsr_array` as well.
+        as an instance of `scipy.sparse.bsr_array <https://docs.scipy.org/doc/scipy/reference/generated/scipy.sparse.bsr_array.html>`_ as well.
     """
     download_dir = download_dir if download_dir is not None else get_temp_folder()
 
@@ -544,9 +544,9 @@ def load_scenarios(scenarios_id: list[int], use_net1: bool = True,
             upper = data + z
             return lower + np.random.uniform() * (upper - lower)
 
-    my_uncertainties = {"pipe_length_uncertainty": MyUniformUncertainty(low=0, high=0.25),
-                        "pipe_roughness_uncertainty": MyUniformUncertainty(low=0, high=0.25),
-                        "base_demand_uncertainty": MyUniformUncertainty(low=0, high=0.25)}
+    my_uncertainties = {"global_pipe_length_uncertainty": MyUniformUncertainty(low=0, high=0.25),
+                        "global_pipe_roughness_uncertainty": MyUniformUncertainty(low=0, high=0.25),
+                        "global_base_demand_uncertainty": MyUniformUncertainty(low=0, high=0.25)}
     model_uncertainty = ModelUncertainty(**my_uncertainties)
 
     # Create sensor config (place pressure and flow sensors everywhere)

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/data/benchmarks/water_usage.py

@@ -22,9 +22,9 @@ def compute_evaluation_score(y_pred: np.ndarray, y: np.ndarray) -> dict:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Event indication prediction over time
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth event indication over time.
 
     Returns

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

@@ -102,7 +102,7 @@ def load_inp(f_in: str, include_empty_sensor_config: bool = True,
         Scenario configuration for the .inp file.
     """
     if not os.path.isfile(f_in):
-        raise ValueError("Can not find 'f_in'")
+        raise ValueError(f"Can not find {f_in}")
 
     if include_empty_sensor_config is True:
         return ScenarioConfig(f_inp_in=f_in, sensor_config=create_empty_sensor_config(f_inp=f_in),

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

@@ -15,7 +15,7 @@ def register(env_name: str, env: ScenarioControlEnv) -> None:
     ----------
     env_name : `str`
         Name of the environment -- must be unique among all environments.
-    env : :class:`epyt_flow.gym.scenario_control_env.ScenarioControlEnv`
+    env : :class:`~epyt_flow.gym.scenario_control_env.ScenarioControlEnv`
         Environment.
     """
     if env_name in environments:
@@ -38,7 +38,7 @@ def make(env_name: str, **kwds) -> ScenarioControlEnv:
 
     Returns
     -------
-    :class:`epyt_flow.gym.scenario_control_env.ScenarioControlEnv`
+    :class:`~epyt_flow.gym.scenario_control_env.ScenarioControlEnv`
         Environment.
     """
     if env_name not in environments:

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

@@ -107,6 +107,14 @@ class ScenarioControlEnv(ABC):
             Current SCADA data (i.e. sensor readings).
         """
         if self._scenario_sim is not None:
+            # Abort current simulation if any is runing
+            try:
+                next(self._sim_generator)
+                self._sim_generator.send(True)
+            except StopIteration:
+                pass
+
+            # Close scenario
             self._scenario_sim.close()
 
         self._scenario_sim = ScenarioSimulator(
@@ -194,7 +202,7 @@ class ScenarioControlEnv(ABC):
         if pattern_idx == 0:
             warnings.warn(f"No pattern for pump '{pump_id}' found -- a new pattern is created")
             pattern_idx = self._scenario_sim.epanet_api.addPattern(f"pump_speed_{pump_id}")
-            self._scenario_sim.epanet_api.setLinkPumpPatternIndex(pattern_idx)
+            self._scenario_sim.epanet_api.setLinkPumpPatternIndex(pump_idx + 1, pattern_idx)
 
         self._scenario_sim.epanet_api.setPattern(pattern_idx, np.array([speed]))
 

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

@@ -12,9 +12,9 @@ def r2_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
 
     Returns
@@ -31,9 +31,9 @@ def running_r2_score(y_pred: np.ndarray, y: np.ndarray) -> list[float]:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
 
     Returns
@@ -55,9 +55,9 @@ def mean_squared_error(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
 
     Returns
@@ -74,9 +74,9 @@ def running_mse(y_pred: np.ndarray, y: np.ndarray) -> list[float]:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
 
     Returns
@@ -112,9 +112,9 @@ def mape(y_pred: np.ndarray, y: np.ndarray, epsilon: float = .05) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
     epsilon : `float`, optional
         Small number added to predictions and ground truth to avoid division-by-zero.
@@ -153,9 +153,9 @@ def smape(y_pred: np.ndarray, y: np.ndarray, epsilon: float = .05) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
     epsilon : `float`, optional
         Small number added to predictions and ground truth to avoid division-by-zero.
@@ -194,9 +194,9 @@ def mase(y_pred: np.ndarray, y: np.ndarray, epsilon: float = .05) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted outputs.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth outputs.
     epsilon : `float`, optional
         Small number added to predictions and ground truth to avoid division-by-zero.
@@ -242,9 +242,9 @@ def f1_micro_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns
@@ -270,9 +270,9 @@ def roc_auc_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns
@@ -298,9 +298,9 @@ def true_positive_rate(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns
@@ -335,9 +335,9 @@ def true_negative_rate(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns
@@ -372,9 +372,9 @@ def precision_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns
@@ -405,9 +405,9 @@ def accuracy_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns
@@ -434,9 +434,9 @@ def f1_score(y_pred: np.ndarray, y: np.ndarray) -> float:
 
     Parameters
     ----------
-    y_pred : `numpy.ndarray`
+    y_pred : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Predicted labels.
-    y : `numpy.ndarray`
+    y : `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
         Ground truth labels.
 
     Returns

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

@@ -20,7 +20,7 @@ class SensorInterpolationDetector(EventDetector):
         Regressor class that will be used for the sensor interpolation.
         Must implement the usual `fit` and `predict` functions.
 
-        The default is `sklearn.linear_model.LinearRegression`
+        The default is `sklearn.linear_model.LinearRegression <https://scikit-learn.org/dev/modules/generated/sklearn.linear_model.LinearRegression.html>`_
     """
     def __init__(self, regressor_type: Any = LinearRegression, **kwds):
         self.__regressor_type = regressor_type
@@ -63,7 +63,7 @@ class SensorInterpolationDetector(EventDetector):
 
         Parameters
         ----------
-        scada_data : :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` or `numpy.ndarray`
+        scada_data : :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` or `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
             SCADA data to fit this detector.
         """
         if isinstance(scada_data, ScadaData):
@@ -93,7 +93,7 @@ class SensorInterpolationDetector(EventDetector):
 
         Parameters
         ----------
-        scada_data : :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` or `numpy.ndarray`
+        scada_data : :class:`~epyt_flow.simulation.scada.scada_data.ScadaData` or `numpy.ndarray <https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html>`_
             SCADA data in which to look for events/anomalies.
 
         Returns

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/rest_api/base_handler.py

@@ -17,7 +17,7 @@ class BaseHandler():
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         error_msg : `str`
             Error message.
@@ -43,7 +43,7 @@ class BaseHandler():
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         """
         resp.status = falcon.HTTP_BAD_REQUEST
@@ -55,7 +55,7 @@ class BaseHandler():
 
         Parameters
         ----------
-        req : `falcon.Request`
+        req : `falcon.Request <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#request>`_
             Request instance.
 
         Returns
@@ -74,7 +74,7 @@ class BaseHandler():
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data : `Any`
             Data to be sent.

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/rest_api/scada_data/data_handlers.py

@@ -18,7 +18,7 @@ class ScadaDataPressuresHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -45,7 +45,7 @@ class ScadaDataFlowsHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -72,7 +72,7 @@ class ScadaDataDemandsHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -100,7 +100,7 @@ class ScadaDataValveStatesHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -128,7 +128,7 @@ class ScadaDataPumpStatesHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -156,7 +156,7 @@ class ScadaDataTankVolumesHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -184,7 +184,7 @@ class ScadaDataNodesQualityHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -212,7 +212,7 @@ class ScadaDataLinksQualityHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -240,7 +240,7 @@ class ScadaDataNodeBulkSpeciesHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -270,7 +270,7 @@ class ScadaDataLinkBulkSpeciesHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.
@@ -299,7 +299,7 @@ class ScadaDataSurfaceSpeciesHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.

{epyt_flow-0.8.1 → epyt_flow-0.10.0}/epyt_flow/rest_api/scada_data/export_handlers.py

@@ -41,7 +41,7 @@ class ScadaDataBaseExportHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         tmp_file : `str`
             Path to the temporary file to be send.
@@ -71,7 +71,7 @@ class ScadaDataBaseExportHandler(ScadaDataBaseHandler):
 
         Parameters
         ----------
-        resp : `falcon.Response`
+        resp : `falcon.Response <https://falcon.readthedocs.io/en/stable/api/request_and_response_asgi.html#response>`_
             Response instance.
         data_id : `str`
             UUID of the SCADA data.