epyt-flow 0.1.0__tar.gz → 0.2.0__tar.gz

{epyt_flow-0.1.0/epyt_flow.egg-info → epyt_flow-0.2.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.1
 Name: epyt-flow
-Version: 0.1.0
+Version: 0.2.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
 Project-URL: Homepage, https://github.com/WaterFutures/EPyT-Flow
-Project-URL: Documentation, https://epytflow.readthedocs.io/en/latest/
+Project-URL: Documentation, https://epyt-flow.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/WaterFutures/EPyT-Flow.git
 Project-URL: Issues, https://github.com/WaterFutures/EPyT-Flow/issues
 Keywords: epanet,water,networks,hydraulics,quality,simulations
@@ -20,7 +20,7 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: epyt>=1.1.3
+Requires-Dist: epyt>=1.1.6
 Requires-Dist: requests>=2.31.0
 Requires-Dist: scipy>=1.11.4
 Requires-Dist: u-msgpack-python>=2.8.0
@@ -32,6 +32,13 @@ Requires-Dist: falcon>=3.1.3
 Requires-Dist: multiprocess>=0.70.16
 Requires-Dist: psutil
 
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![pypi](https://img.shields.io/pypi/v/epyt-flow.svg)](https://pypi.org/project/epyt-flow/)
+[![build](https://github.com/WaterFutures/EPyT-Flow/actions/workflows/build_tests.yml/badge.svg)](https://github.com/WaterFutures/EPyT-Flow/actions/workflows/build_tests.yml)
+[![Documentation Status](https://readthedocs.org/projects/epyt-flow/badge/?version=stable)](https://epyt-flow.readthedocs.io/en/stable/?badge=stable)
+[![Downloads](https://static.pepy.tech/badge/epyt-flow)](https://pepy.tech/project/epyt-flow)
+[![Downloads](https://static.pepy.tech/badge/epyt-flow/month)](https://pepy.tech/project/epyt-flow)
+
 # EPyT-Flow -- EPANET Python Toolkit - Flow
 
 EPyT-Flow is a Python package building on top of [EPyT](https://github.com/OpenWaterAnalytics/EPyT) 
@@ -45,11 +52,28 @@ Furthermore, it also provides an environment for developing and testing control
 
 ![](https://github.com/WaterFutures/EPyT-Flow/blob/main/docs/_static/net1_plot.png?raw=true)
 
+
+## Unique Features
+
+Unique features of EPyT-Flow that make it superior to other (Python) toolboxes are the following:
+
+- High-performance hydraulic and (advanced) water quality simulation
+- 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)
+- 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
+- Access to many WDNs and popular benchmarks (incl. their evaluation)
+
+
 ## Installation
 
 EPyT-Flow supports Python 3.9 - 3.12
 
-Note that [EPANET and EPANET-MSX sources](epyt_flow/EPANET/) are compiled and overrite the binaries
+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 Linux system. By this we not only aim to achieve
 a better performance of the simulations but also avoid any compatibility problems of pre-compiled binaries.
 
@@ -113,7 +137,7 @@ if __name__ == "__main__":
 
 ## Documentation
 
-Documentation is available on readthedocs: [https://epytflow.readthedocs.io/en/latest/](https://epytflow.readthedocs.io/en/latest/)
+Documentation is available on readthedocs:[https://epyt-flow.readthedocs.io/en/latest/](https://epyt-flow.readthedocs.io/en/stable)
 
 ## License
 

{epyt_flow-0.1.0 → epyt_flow-0.2.0}/README.md

@@ -1,3 +1,10 @@
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![pypi](https://img.shields.io/pypi/v/epyt-flow.svg)](https://pypi.org/project/epyt-flow/)
+[![build](https://github.com/WaterFutures/EPyT-Flow/actions/workflows/build_tests.yml/badge.svg)](https://github.com/WaterFutures/EPyT-Flow/actions/workflows/build_tests.yml)
+[![Documentation Status](https://readthedocs.org/projects/epyt-flow/badge/?version=stable)](https://epyt-flow.readthedocs.io/en/stable/?badge=stable)
+[![Downloads](https://static.pepy.tech/badge/epyt-flow)](https://pepy.tech/project/epyt-flow)
+[![Downloads](https://static.pepy.tech/badge/epyt-flow/month)](https://pepy.tech/project/epyt-flow)
+
 # EPyT-Flow -- EPANET Python Toolkit - Flow
 
 EPyT-Flow is a Python package building on top of [EPyT](https://github.com/OpenWaterAnalytics/EPyT) 
@@ -11,11 +18,28 @@ Furthermore, it also provides an environment for developing and testing control
 
 ![](https://github.com/WaterFutures/EPyT-Flow/blob/main/docs/_static/net1_plot.png?raw=true)
 
+
+## Unique Features
+
+Unique features of EPyT-Flow that make it superior to other (Python) toolboxes are the following:
+
+- High-performance hydraulic and (advanced) water quality simulation
+- 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)
+- 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
+- Access to many WDNs and popular benchmarks (incl. their evaluation)
+
+
 ## Installation
 
 EPyT-Flow supports Python 3.9 - 3.12
 
-Note that [EPANET and EPANET-MSX sources](epyt_flow/EPANET/) are compiled and overrite the binaries
+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 Linux system. By this we not only aim to achieve
 a better performance of the simulations but also avoid any compatibility problems of pre-compiled binaries.
 
@@ -79,7 +103,7 @@ if __name__ == "__main__":
 
 ## Documentation
 
-Documentation is available on readthedocs: [https://epytflow.readthedocs.io/en/latest/](https://epytflow.readthedocs.io/en/latest/)
+Documentation is available on readthedocs:[https://epyt-flow.readthedocs.io/en/latest/](https://epyt-flow.readthedocs.io/en/stable)
 
 ## License
 

{epyt_flow-0.1.0 → epyt_flow-0.2.0}/REQUIREMENTS.txt

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

epyt_flow-0.2.0/epyt_flow/EPANET/compile_linux.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+mkdir -p "../customlibs/"
+gcc -w -O3 -march=native -shared -Wl,-soname,libepanet2_2.so -fPIC -o "../customlibs/libepanet2_2.so" EPANET/SRC_engines/*.c -IEPANET/SRC_engines/include -lc -lm -pthread
+gcc -w -O3 -march=native -fPIC -shared -Wl,-soname,libepanetmsx2_2_0.so -o "../customlibs/libepanetmsx2_2_0.so" -fopenmp -Depanetmsx_EXPORTS -IEPANET-MSX/Src/include -IEPANET/SRC_engines/include EPANET-MSX/Src/*.c -Wl,-rpath=. "../customlibs/libepanet2_2.so" -lm -lgomp -lpthread

epyt_flow-0.2.0/epyt_flow/VERSION

@@ -0,0 +1 @@
+0.2.0

epyt_flow-0.2.0/epyt_flow/__init__.py

@@ -0,0 +1,37 @@
+import subprocess
+import warnings
+import shutil
+import sys
+import os
+
+with open(os.path.join(os.path.dirname(__file__), 'VERSION'), encoding="utf-8") as f:
+    VERSION = f.read().strip()
+
+
+def compile_libraries_unix(lib_epanet_name, compile_script_name):
+    """Compile EPANET and EPANET-MSX libraries if needed."""
+    path_to_custom_libs = os.path.join(os.path.dirname(__file__), "customlibs")
+    path_to_lib_epanet = os.path.join(path_to_custom_libs, lib_epanet_name)
+    path_to_epanet = os.path.join(os.path.dirname(__file__), "EPANET")
+
+    update = False
+    if os.path.isfile(path_to_lib_epanet):
+        if os.path.getmtime(__file__) > os.path.getmtime(path_to_lib_epanet):
+            update = True
+
+    if not os.path.isfile(path_to_lib_epanet) or update:
+        if shutil.which("gcc") is not None:
+            print("Compiling EPANET and EPANET-MSX...")
+            try:
+                subprocess.check_call(f"cd \"{path_to_epanet}\"; bash {compile_script_name}",
+                                      shell=True)
+                print("Done")
+            except subprocess.CalledProcessError as ex:
+                print(f"Compilation failed\n{ex}")
+        else:
+            warnings.warn("GCC is not available to compile the required libraries.\n" +
+                          "Falling back to pre-compiled library shipped by EPyT.")
+
+
+if sys.platform.startswith("linux"):
+    compile_libraries_unix("libepanet2_2.so", "compile_linux.sh")

epyt_flow-0.1.0/epyt_flow/rest_api/scada_data_handler.py → epyt_flow-0.2.0/epyt_flow/rest_api/scada_data/data_handlers.py

@@ -1,170 +1,11 @@
 """
-The module provides all handlers for SCADA data requests.
+This module provides REST API handlers for accessing the final sensor readings
+(e.g. pressure, flow rate, etc.).
 """
 import warnings
 import falcon
 
-from .base_handler import BaseHandler
-from .res_manager import ResourceManager
-from ..simulation import SensorConfig, SensorFault
-
-
-class ScadaDataManager(ResourceManager):
-    """
-    Class for managing SCADA data.
-    """
-
-
-class ScadaDataBaseHandler(BaseHandler):
-    """
-    Base class for all handlers concerning SCADA data.
-
-    Parameters
-    ----------
-    scada_data_mgr : `~epyt_flow.rest_api.scenario_handler.ScadaDataBaseHandler`
-        SCADA data manager.
-    """
-    def __init__(self, scada_data_mgr: ScadaDataManager):
-        self.scada_data_mgr = scada_data_mgr
-
-
-class ScadaDataRemoveHandler(ScadaDataBaseHandler):
-    """
-    Class for handling a DELETE request for a given SCADA data instance.
-    """
-    def on_delete(self, _, resp: falcon.Response, data_id: str) -> None:
-        """
-        Deletes a given SCADA data instance.
-
-        Parameters
-        ----------
-        resp : `falcon.Response`
-            Response instance.
-        data_id : `str`
-            UUID of the SCADA data instance.
-        """
-        try:
-            if self.scada_data_mgr.validate_uuid(data_id) is False:
-                self.send_invalid_resource_id_error(resp)
-                return
-
-            self.scada_data_mgr.remove(data_id)
-        except Exception as ex:
-            warnings.warn(str(ex))
-            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
-
-
-class ScadaDataSensorConfigHandler(ScadaDataBaseHandler):
-    """
-    Class for handling GET and POST requests for the sensor configuration
-    of a given SCADA data instance.
-    """
-    def on_get(self, _, resp: falcon.Response, data_id: str) -> None:
-        """
-        Gets the sensor configuration of a given SCADA data instance.
-
-        Parameters
-        ----------
-        resp : `falcon.Response`
-            Response instance.
-        data_id : `str`
-            UUID of the SCADA data.
-        """
-        try:
-            if self.scada_data_mgr.validate_uuid(data_id) is False:
-                self.send_invalid_resource_id_error(resp)
-                return
-
-            my_sensor_config = self.scada_data_mgr.get(data_id).sensor_config
-            self.send_json_response(resp, my_sensor_config)
-        except Exception as ex:
-            warnings.warn(str(ex))
-            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
-
-    def on_post(self, req: falcon.Request, resp: falcon.Response, data_id: str) -> None:
-        """
-        Sets the sensor configuration of a given SCADA data instance.
-
-        Parameters
-        ----------
-        req : `falcon.Request`
-            Request instance.
-        resp : `falcon.Response`
-            Response instance.
-        data_id : `str`
-            UUID of the SCADA data.
-        """
-        try:
-            if self.scada_data_mgr.validate_uuid(data_id) is False:
-                self.send_invalid_resource_id_error(resp)
-                return
-
-            sensor_config = self.load_json_data_from_request(req)
-            if not isinstance(sensor_config, SensorConfig):
-                self.send_json_parsing_error(resp)
-                return
-
-            self.scada_data_mgr.get(data_id).sensor_config = sensor_config
-        except Exception as ex:
-            warnings.warn(str(ex))
-            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
-
-
-class ScadaDataSensorFaultsHandler(ScadaDataBaseHandler):
-    """
-    Class for handling GET and POST requests concerning sensor faults in a
-    given SCADA data instance.
-    """
-    def on_get(self, _, resp: falcon.Response, data_id: str) -> None:
-        """
-        Gets all sensor faults of a given SCADA data instance.
-
-        Parameters
-        ----------
-        resp : `falcon.Response`
-            Response instance.
-        data_id : `str`
-            UUID of the SCADA data.
-        """
-        try:
-            if self.scada_data_mgr.validate_uuid(data_id) is False:
-                self.send_invalid_resource_id_error(resp)
-                return
-
-            sensor_faults = self.scada_data_mgr.get(data_id).sensor_faults
-            self.send_json_response(resp, sensor_faults)
-        except Exception as ex:
-            warnings.warn(str(ex))
-            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
-
-    def on_post(self, req: falcon.Request, resp: falcon.Response, data_id: str) -> None:
-        """
-        Sets (i.e. overrides) the sensor faults in a given SCADA data instance.
-
-        Parameters
-        ----------
-        req : `falcon.Request`
-            Request instance.
-        resp : `falcon.Response`
-            Response instance.
-        data_id : `str`
-            UUID of the SCADA data.
-        """
-        try:
-            if self.scada_data_mgr.validate_uuid(data_id) is False:
-                self.send_invalid_resource_id_error(resp)
-                return
-
-            sensor_faults = self.load_json_data_from_request(req)
-            if not isinstance(sensor_faults, list) or \
-                    any(not isinstance(e, SensorFault) for e in sensor_faults):
-                self.send_json_parsing_error(resp)
-                return
-
-            self.scada_data_mgr.get(data_id).sensor_faults = sensor_faults
-        except Exception as ex:
-            warnings.warn(str(ex))
-            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
+from .handlers import ScadaDataBaseHandler
 
 
 class ScadaDataPressuresHandler(ScadaDataBaseHandler):

epyt_flow-0.2.0/epyt_flow/rest_api/scada_data/export_handlers.py

@@ -0,0 +1,140 @@
+"""
+This module provides REST API handlers for exporting a given SCADA data instance.
+"""
+import os
+from abc import abstractmethod
+import warnings
+import falcon
+
+from .handlers import ScadaDataBaseHandler
+from ...utils import get_temp_folder
+from ...simulation.scada import ScadaData, ScadaDataNumpyExport, ScadaDataMatlabExport, \
+    ScadaDataXlsxExport
+
+
+class ScadaDataBaseExportHandler(ScadaDataBaseHandler):
+    """
+    Base handler for exporting a given SCADA data instance.
+    """
+    def __init__(self, file_ext: str, **kwds):
+        self.__file_ext = file_ext
+
+        super().__init__(**kwds)
+
+    def create_temp_file_path(self, data_id: str, file_ext: str) -> None:
+        """
+        Returns a path to a temporary file for storing the SCADA data instance.
+
+        Parameters
+        ----------
+        data_id : `str`
+            UUID of the SCADA data.
+        file_ext : `str`
+            File extension.
+        """
+        return os.path.join(get_temp_folder(), f"{data_id}.{file_ext}")
+
+    def send_temp_file(self, resp: falcon.Response, tmp_file: str,
+                       content_type: str = "application/octet-stream") -> None:
+        """
+        Sends a given file (`tmp_file`) to the the client.
+
+        Parameters
+        ----------
+        resp : `falcon.Response`
+            Response instance.
+        tmp_file : `str`
+            Path to the temporary file to be send.
+        """
+        resp.status = falcon.HTTP_200
+        resp.content_type = content_type
+        with open(tmp_file, 'rb') as f:
+            resp.text = f.read()
+
+    @abstractmethod
+    def export(self, scada_data: ScadaData, tmp_file: str) -> None:
+        """
+        Exports a given SCADA data instance to a temporary file.
+
+        Parameters
+        ----------
+        scada_data : :class:`~epyt_flow.simulation.scada.scada_data.ScadaData`
+            SCADA data instance to be exported.
+        tmp_file : `str`
+            Path to temporary file.
+        """
+        raise NotImplementedError()
+
+    def on_get(self, _, resp: falcon.Response, data_id: str) -> None:
+        """
+        Gets the given SCADA data instance.
+
+        Parameters
+        ----------
+        resp : `falcon.Response`
+            Response instance.
+        data_id : `str`
+            UUID of the SCADA data.
+        """
+        try:
+            if self.scada_data_mgr.validate_uuid(data_id) is False:
+                self.send_invalid_resource_id_error(resp)
+                return
+
+            my_scada_data = self.scada_data_mgr.get(data_id)
+
+            tmp_file = self.create_temp_file_path(data_id, self.__file_ext)
+            self.export(my_scada_data, tmp_file)
+
+            self.send_temp_file(resp, tmp_file)
+
+            os.remove(tmp_file)
+        except Exception as ex:
+            warnings.warn(str(ex))
+            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
+
+
+class ScadaDataExportHandler(ScadaDataBaseExportHandler):
+    """
+    Class for handling a GET requests for exporting a given SCADA data instance
+    to an .epytflow_scada_data file.
+    """
+    def __init__(self, **kwds):
+        super().__init__(file_ext=".epytflow_scada_data", **kwds)
+
+    def export(self, scada_data: ScadaData, tmp_file: str) -> None:
+        scada_data.save_to_file(tmp_file)
+
+
+class ScadaDataXlsxExportHandler(ScadaDataBaseExportHandler):
+    """
+    Class for handling a GET requests for exporting a given SCADA data instance to a .xlsx file.
+    """
+    def __init__(self, **kwds):
+        super().__init__(file_ext=".xlsx", **kwds)
+
+    def export(self, scada_data: ScadaData, tmp_file: str) -> None:
+        ScadaDataXlsxExport(tmp_file).export(scada_data)
+
+
+class ScadaDataNumpyExportHandler(ScadaDataBaseExportHandler):
+    """
+    Class for handling a GET requests for exporting a given SCADA data instance to Numpy data file.
+    """
+    def __init__(self, **kwds):
+        super().__init__(file_ext=".npz", **kwds)
+
+    def export(self, scada_data: ScadaData, tmp_file: str) -> None:
+        ScadaDataNumpyExport(tmp_file).export(scada_data)
+
+
+class ScadaDataMatlabExportHandler(ScadaDataBaseExportHandler):
+    """
+    Class for handling a GET requests for exporting a given SCADA data instance
+    to a Matlab data file.
+    """
+    def __init__(self, **kwds):
+        super().__init__(file_ext=".mat", **kwds)
+
+    def export(self, scada_data: ScadaData, tmp_file: str) -> None:
+        ScadaDataMatlabExport(tmp_file).export(scada_data)

epyt_flow-0.2.0/epyt_flow/rest_api/scada_data/handlers.py

@@ -0,0 +1,167 @@
+"""
+The module provides REST API handlers for some SCADA data requests.
+"""
+import warnings
+import falcon
+
+from ..base_handler import BaseHandler
+from ..res_manager import ResourceManager
+from ...simulation import SensorConfig, SensorFault
+
+
+class ScadaDataManager(ResourceManager):
+    """
+    Class for managing SCADA data.
+    """
+
+
+class ScadaDataBaseHandler(BaseHandler):
+    """
+    Base class for all handlers concerning SCADA data.
+
+    Parameters
+    ----------
+    scada_data_mgr : :class:`~epyt_flow.rest_api.scada_data.handlers.ScadaDataManager`
+        SCADA data manager.
+    """
+    def __init__(self, scada_data_mgr: ScadaDataManager):
+        self.scada_data_mgr = scada_data_mgr
+
+
+class ScadaDataRemoveHandler(ScadaDataBaseHandler):
+    """
+    Class for handling a DELETE request for a given SCADA data instance.
+    """
+    def on_delete(self, _, resp: falcon.Response, data_id: str) -> None:
+        """
+        Deletes a given SCADA data instance.
+
+        Parameters
+        ----------
+        resp : `falcon.Response`
+            Response instance.
+        data_id : `str`
+            UUID of the SCADA data instance.
+        """
+        try:
+            if self.scada_data_mgr.validate_uuid(data_id) is False:
+                self.send_invalid_resource_id_error(resp)
+                return
+
+            self.scada_data_mgr.remove(data_id)
+        except Exception as ex:
+            warnings.warn(str(ex))
+            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
+
+
+class ScadaDataSensorConfigHandler(ScadaDataBaseHandler):
+    """
+    Class for handling GET and POST requests for the sensor configuration
+    of a given SCADA data instance.
+    """
+    def on_get(self, _, resp: falcon.Response, data_id: str) -> None:
+        """
+        Gets the sensor configuration of a given SCADA data instance.
+
+        Parameters
+        ----------
+        resp : `falcon.Response`
+            Response instance.
+        data_id : `str`
+            UUID of the SCADA data.
+        """
+        try:
+            if self.scada_data_mgr.validate_uuid(data_id) is False:
+                self.send_invalid_resource_id_error(resp)
+                return
+
+            my_sensor_config = self.scada_data_mgr.get(data_id).sensor_config
+            self.send_json_response(resp, my_sensor_config)
+        except Exception as ex:
+            warnings.warn(str(ex))
+            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
+
+    def on_post(self, req: falcon.Request, resp: falcon.Response, data_id: str) -> None:
+        """
+        Sets the sensor configuration of a given SCADA data instance.
+
+        Parameters
+        ----------
+        req : `falcon.Request`
+            Request instance.
+        resp : `falcon.Response`
+            Response instance.
+        data_id : `str`
+            UUID of the SCADA data.
+        """
+        try:
+            if self.scada_data_mgr.validate_uuid(data_id) is False:
+                self.send_invalid_resource_id_error(resp)
+                return
+
+            sensor_config = self.load_json_data_from_request(req)
+            if not isinstance(sensor_config, SensorConfig):
+                self.send_json_parsing_error(resp)
+                return
+
+            self.scada_data_mgr.get(data_id).sensor_config = sensor_config
+        except Exception as ex:
+            warnings.warn(str(ex))
+            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
+
+
+class ScadaDataSensorFaultsHandler(ScadaDataBaseHandler):
+    """
+    Class for handling GET and POST requests concerning sensor faults in a
+    given SCADA data instance.
+    """
+    def on_get(self, _, resp: falcon.Response, data_id: str) -> None:
+        """
+        Gets all sensor faults of a given SCADA data instance.
+
+        Parameters
+        ----------
+        resp : `falcon.Response`
+            Response instance.
+        data_id : `str`
+            UUID of the SCADA data.
+        """
+        try:
+            if self.scada_data_mgr.validate_uuid(data_id) is False:
+                self.send_invalid_resource_id_error(resp)
+                return
+
+            sensor_faults = self.scada_data_mgr.get(data_id).sensor_faults
+            self.send_json_response(resp, sensor_faults)
+        except Exception as ex:
+            warnings.warn(str(ex))
+            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR
+
+    def on_post(self, req: falcon.Request, resp: falcon.Response, data_id: str) -> None:
+        """
+        Sets (i.e. overrides) the sensor faults in a given SCADA data instance.
+
+        Parameters
+        ----------
+        req : `falcon.Request`
+            Request instance.
+        resp : `falcon.Response`
+            Response instance.
+        data_id : `str`
+            UUID of the SCADA data.
+        """
+        try:
+            if self.scada_data_mgr.validate_uuid(data_id) is False:
+                self.send_invalid_resource_id_error(resp)
+                return
+
+            sensor_faults = self.load_json_data_from_request(req)
+            if not isinstance(sensor_faults, list) or \
+                    any(not isinstance(e, SensorFault) for e in sensor_faults):
+                self.send_json_parsing_error(resp)
+                return
+
+            self.scada_data_mgr.get(data_id).sensor_faults = sensor_faults
+        except Exception as ex:
+            warnings.warn(str(ex))
+            resp.status = falcon.HTTP_INTERNAL_SERVER_ERROR