epyt-flow 0.13.1__py3-none-any.whl → 0.14.1__py3-none-any.whl

epyt_flow/EPANET/EPANET/SRC_engines/validate.c

@@ -0,0 +1,408 @@
+/*
+ ******************************************************************************
+ Project:      OWA EPANET
+ Version:      2.3
+ Module:       validate.c
+ Description:  validates project data
+ Authors:      see AUTHORS
+ Copyright:    see AUTHORS
+ License:      see LICENSE
+ Last Updated: 03/18/2024
+ ******************************************************************************
+*/
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+#include <math.h> 
+
+#include "types.h"
+#include "funcs.h"
+#include "text.h"
+
+// Exported functions
+int  validateproject(Project *);
+void reindextanks(Project *);
+
+int validatetanks(Project *pr)
+/*
+**-------------------------------------------------------------------
+**  Input:   none
+**  Output:  returns 1 if successful, 0 if not
+**  Purpose: checks for valid tank levels.
+**-------------------------------------------------------------------
+*/
+{
+    Network *net = &pr->network;
+    int i, j, n, result = 1, levelerr;
+    char errmsg[MAXMSG+1] = "";
+    Stank *tank;
+    Scurve *curve;
+    double elev;
+    
+    for (j = 1; j <= net->Ntanks; j++)
+    {
+        tank = &net->Tank[j];
+        if (tank->A == 0.0) continue;  // Skip reservoirs
+
+        // Check for valid lower/upper tank levels
+        levelerr = 0;
+        if (tank->H0 > tank->Hmax ||
+            tank->Hmin > tank->Hmax ||
+            tank->H0 < tank->Hmin
+        ) levelerr = 1;
+
+        // Check that tank heights are within volume curve
+        elev = net->Node[tank->Node].El;
+        i = tank->Vcurve;
+        if (i > 0)
+        {
+            curve = &net->Curve[i];
+            n = curve->Npts - 1;
+            if ((tank->Hmin - elev) * pr->Ucf[ELEV] < curve->X[0] - TINY ||
+                (tank->Hmax - elev) * pr->Ucf[ELEV] > curve->X[n] + TINY)
+            {
+                levelerr = 1;
+            }
+        }
+        
+        // Report error in levels if found
+        if (levelerr)
+        {
+            sprintf(pr->Msg, "Error 225: %s node %s", geterrmsg(225, errmsg),
+                    net->Node[tank->Node].ID);
+            writeline(pr, pr->Msg);
+            result = 0;
+        }
+    }
+    return result;
+}
+
+int validatepatterns(Project *pr)
+/*
+**-------------------------------------------------------------------
+**  Input:   none
+**  Output:  returns 1 if successful, 0 if not
+**  Purpose: checks if time patterns have data.
+**-------------------------------------------------------------------
+*/
+{
+    Network *net = &pr->network;
+    int j, result = 1;
+    char errmsg[MAXMSG+1] = "";
+
+    if (pr->network.Pattern != NULL)
+    {
+        for (j = 0; j <= pr->network.Npats; j++)
+        {
+            if (pr->network.Pattern[j].Length == 0)
+            {
+                sprintf(pr->Msg, "Error 232: %s %s", geterrmsg(232, errmsg),
+                    pr->network.Pattern[j].ID);
+                writeline(pr, pr->Msg);
+                result = 0;
+            }
+        }
+    }
+    return result;            
+}
+
+int validatecurves(Project *pr)
+/*
+**-------------------------------------------------------------------
+**  Input:   none
+**  Output:  returns 1 if successful, 0 if not
+**  Purpose: checks if data curves have data.
+**-------------------------------------------------------------------
+*/
+{
+    int i, j, npts, result = 1;
+    char errmsg[MAXMSG+1] = "";
+    Scurve *curve;
+
+    if (pr->network.Curve != NULL)
+    {
+        for (j = 1; j <= pr->network.Ncurves; j++)
+        {
+            // Check that curve has data
+            curve = &pr->network.Curve[j];
+            npts = curve->Npts;
+            if (npts == 0)
+            {
+                sprintf(pr->Msg, "Error 231: %s %s", geterrmsg(231, errmsg),
+                    curve->ID);
+                writeline(pr, pr->Msg);
+                result = 0;
+            }
+            
+            // Check that x values are increasing
+            for (i = 1; i < npts; i++)
+            {
+                if (curve->X[i-1] >= curve->X[i])
+                {
+                    sprintf(pr->Msg, "Error 230: %s %s", geterrmsg(230, errmsg),
+                        curve->ID);
+                    writeline(pr, pr->Msg);
+                    result = 0;
+                    break;
+                }
+            }       
+        }
+    }
+    return result;
+}
+
+int powerfuncpump(double h0, double h1, double h2, double q1, double q2,
+                  double *a, double *b, double *c)
+/*
+**---------------------------------------------------------
+**  Input:   h0 = shutoff head
+**           h1 = design head
+**           h2 = head at max. flow
+**           q1 = design flow
+**           q2 = max. flow
+**  Output:  *a, *b, *c = pump curve coeffs. (H = a-bQ^c),
+**           Returns 1 if successful, 0 otherwise.
+**  Purpose: computes coeffs. for a power function pump curve
+**----------------------------------------------------------
+*/
+{
+    double h4, h5;
+
+    if (h0 < TINY || h0 - h1 < TINY || h1 - h2 < TINY ||
+        q1 < TINY || q2 - q1 < TINY
+       ) return 0;
+    *a = h0;
+    h4 = h0 - h1;
+    h5 = h0 - h2;
+    *c = log(h5 / h4) / log(q2 / q1);
+    if (*c <= 0.0 || *c > 20.0) return 0;
+    *b = -h4 / pow(q1, *c);
+    if (*b >= 0.0) return 0;
+    return 1;
+}
+
+int customcurvepump(Project *pr, Spump *pump, Scurve *curve)
+/*
+**-------------------------------------------------------------------
+**  Input:   pump = a pump object
+**           curve = a data curve object
+**  Output:  returns an error code
+**  Purpose: computes properties for a pump with a custom pump curve.
+**-------------------------------------------------------------------
+*/
+{
+    int m, npts = curve->Npts;
+    pump->Ptype = CUSTOM;
+    for (m = 1; m < npts; m++)
+    {
+        // Curve must have continuously decreasing head (the Y value)
+        if (curve->Y[m] >= curve->Y[m - 1])
+        {
+            pump->Ptype = NOCURVE;
+            return 227;
+        }
+    }
+    pump->Qmax = curve->X[npts - 1];
+    pump->Q0 = (curve->X[0] + pump->Qmax) / 2.0 / pr->Ucf[FLOW];
+    pump->Qmax /= pr->Ucf[FLOW];
+    pump->Hmax = curve->Y[0] / pr->Ucf[HEAD];
+    return 0;
+}
+
+int pumpcurvepump(Project *pr, Spump *pump, Scurve *curve)
+/*
+**-------------------------------------------------------------------
+**  Input:   pump = a pump object
+**           curve = a data curve object
+**  Output:  returns an error code
+**  Purpose: computes properties for a pump assigned a pump curve.
+**-------------------------------------------------------------------
+*/
+{
+    double a, b, c, h0 = 0.0, h1 = 0.0, h2 = 0.0, q1 = 0.0, q2 = 0.0;
+    int npts = curve->Npts;
+
+    curve->Type = PUMP_CURVE;
+
+    // Generic power function curve
+    if (npts == 1)
+    {
+        pump->Ptype = POWER_FUNC;
+        q1 = curve->X[0];
+        h1 = curve->Y[0];
+        h0 = 1.33334 * h1;
+        q2 = 2.0 * q1;
+        h2 = 0.0;
+    }
+
+    // 3 point curve with shutoff head
+    else if (npts == 3 && curve->X[0] == 0.0)
+    {
+        pump->Ptype = POWER_FUNC;
+        h0 = curve->Y[0];
+        q1 = curve->X[1];
+        h1 = curve->Y[1];
+        q2 = curve->X[2];
+        h2 = curve->Y[2];
+    }
+    else return customcurvepump(pr, pump, curve);
+
+    // Compute shape factors & limits of power function curves
+    if (!powerfuncpump(h0, h1, h2, q1, q2, &a, &b, &c))
+    {
+        pump->Ptype = NOCURVE;
+        return 227;
+    }
+    else
+    {
+        pump->H0 = -a / pr->Ucf[HEAD];
+        pump->R = -b * (pow(pr->Ucf[FLOW], c) / pr->Ucf[HEAD]);
+        pump->N = c;
+        pump->Q0 = q1 / pr->Ucf[FLOW];
+        pump->Qmax = pow((-a / b), (1.0 / c)) / pr->Ucf[FLOW];
+        pump->Hmax = h0 / pr->Ucf[HEAD];
+    }
+    return 0;
+}
+   
+int constpowerpump(Project *pr, Spump *pump)
+/*
+**-------------------------------------------------------------------
+**  Input:   pump = a pump object
+**  Output:  returns an error code
+**  Purpose: computes properties for a constant power pump.
+**-------------------------------------------------------------------
+*/
+{
+    pump->Ptype = CONST_HP;
+    pump->H0 = 0.0;
+    pump->R = -8.814 * pr->network.Link[pump->Link].Km / pr->Ucf[POWER];
+    pump->N = -1.0;
+    pump->Hmax = BIG; // No head limit
+    pump->Qmax = BIG; // No flow limit
+    pump->Q0 = 1.0;   // Init. flow = 1 cfs
+    return 0;
+}
+ 
+int validatepumps(Project *pr)
+/*
+**-------------------------------------------------------------------
+**  Input:   none
+**  Output:  returns 1 if successful, 0 if not
+**  Purpose: checks if pumps are assigned valid pump curve data.
+**-------------------------------------------------------------------
+*/
+{
+    Network *net = &pr->network;
+    int i, errcode, result = 1;
+    char errmsg[MAXMSG+1] = "";
+    Spump  *pump;
+    
+    for (i = 1; i <= net->Npumps; i++)
+    {
+        // Pump has a designated pump curve
+        pump = &net->Pump[i];
+        if (pump->Hcurve > 0)
+            errcode = pumpcurvepump(pr, pump, &net->Curve[pump->Hcurve]);
+        
+        // Pump has a constant power setting
+        else if (net->Link[pump->Link].Km > 0.0)
+            errcode = constpowerpump(pr, pump);
+        
+        // Pump has no pump curve info assigned
+        else
+        {
+            pump->Ptype = NOCURVE;
+            errcode = 226;
+        }
+        
+        if (errcode)
+        {
+            sprintf(pr->Msg, "Error %d: %s %s",
+                errcode, geterrmsg(errcode, errmsg), net->Link[pump->Link].ID);
+            writeline(pr, pr->Msg);
+            result = 0;
+        }
+    }
+    return result;
+}
+        
+int validateproject(Project *pr)
+/*
+ *--------------------------------------------------------------
+ *  Input:   none
+ *  Output:  returns error code
+ *  Purpose: checks for valid network data.
+ *--------------------------------------------------------------
+*/
+{
+    int errcode = 0;
+    if (pr->network.Nnodes < 2) return 223;
+    if (pr->network.Ntanks == 0) return 224;
+    if (!validatetanks(pr)) errcode = 110;
+    if (!validatepumps(pr)) errcode = 110;
+    if (!validatepatterns(pr)) errcode = 110;
+    if (!validatecurves(pr)) errcode = 110;
+    return errcode;
+}
+
+void reindextanks(Project *pr)
+/*
+ *--------------------------------------------------------------
+ *  Input:   none
+ *  Output:  none
+ *  Purpose: adjusts tank node indexes when the number of
+ *           junctions created from an input file is less than
+ *           the total number of junction lines in the file.
+ *--------------------------------------------------------------
+*/
+{
+    Network *net = &pr->network;
+    Parser  *parser = &pr->parser;
+    Quality *qual   = &pr->quality;
+    Scontrol *control;
+    int i, j, ndiff, n1, n2, size;
+    
+    // ndiff = # unused entries in Node array before first tank node
+    ndiff = parser->MaxJuncs - net->Njuncs;
+    if (ndiff > 0)
+    {   
+        for (i = 1; i <= net->Ntanks; ++i)
+        {
+            // n1 is current tank index in Node array, n2 is adjusted index
+            n1 = net->Tank[i].Node;
+            n2 = n1 - ndiff;
+            
+            // Update the tank node's hash table entry
+            hashtable_update(net->NodeHashTable, net->Node[n1].ID, n2);
+            
+            // Update the tank's node index
+            net->Tank[i].Node = n2;
+            
+            // Re-position tank node in Node array
+            net->Node[n2] = net->Node[n1];
+            
+            // Replace all references to old tank node index with new one
+            for (j = 1; j <= net->Nlinks; ++j)
+            {
+                if (net->Link[j].N1 == n1) net->Link[j].N1 = n2;
+                if (net->Link[j].N2 == n1) net->Link[j].N2 = n2;
+            }
+            for (j = 1; j <= net->Ncontrols; ++j)
+            {
+                control = &net->Control[j];
+                if (control->Node == n1) control->Node = n2;
+            }
+            adjusttankrules(pr, -ndiff);
+            if (qual->TraceNode == n1) qual->TraceNode = n2;
+        }
+        
+        // Reallocate the Node array (shouldn't fail as new size < old size)
+        parser->MaxJuncs = net->Njuncs;
+        parser->MaxNodes = net->Njuncs + net->Ntanks;
+        size = (net->Nnodes + 2) * sizeof(Snode);
+        net->Node = (Snode *)realloc(net->Node, size);
+    }
+}    
+    

epyt_flow/EPANET/compile_linux.sh

@@ -1,4 +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 -shared -Wl,-soname,libepanet2_2.so -fPIC -o "../customlibs/libepanet2_2.so" EPANET/SRC_engines/*.c -IEPANET/SRC_engines/include EPANET/SRC_engines/util/*.c -IEPANET/SRC_engines/util/ -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/EPANET/compile_macos.sh

@@ -1,4 +1,4 @@
 #!/bin/bash
 mkdir -p "../customlibs/"
-gcc-12 -w -O3 -march=native -dynamiclib -fPIC -install_name libepanet2_2.dylib -o "../customlibs/libepanet2_2.dylib" EPANET/SRC_engines/*.c -IEPANET/SRC_engines/include -lc -lm -pthread
-gcc-12 -w -O3 -march=native -dynamiclib -fPIC -install_name libepanetmsx2_2_0.dylib -o "../customlibs/libepanetmsx2_2_0.dylib" -fopenmp -Depanetmsx_EXPORTS -IEPANET-MSX/Src/include -IEPANET/SRC_engines/include EPANET-MSX/Src/*.c -L'../customlibs' -lepanet2_2 -lm -lgomp -lpthread
+gcc-15 -w -O3 -march=native -dynamiclib -fPIC -install_name libepanet2_2.dylib -o "../customlibs/libepanet2_2.dylib" EPANET/SRC_engines/*.c -IEPANET/SRC_engines/include EPANET/SRC_engines/util/*.c -IEPANET/SRC_engines/util/ -lc -lm -pthread
+gcc-15 -w -O3 -march=native -dynamiclib -fPIC -install_name libepanetmsx2_2_0.dylib -o "../customlibs/libepanetmsx2_2_0.dylib" -fopenmp -Depanetmsx_EXPORTS -IEPANET-MSX/Src/include -IEPANET/SRC_engines/include EPANET-MSX/Src/*.c -L'../customlibs' -lepanet2_2 -lm -lgomp -lpthread

epyt_flow/VERSION

@@ -1 +1 @@
-0.13.1
+0.14.1

epyt_flow/__init__.py

@@ -39,4 +39,4 @@ def compile_libraries_unix(lib_epanet_name: str, compile_script_name: str,
 if sys.platform.startswith("linux"):
     compile_libraries_unix("libepanet2_2.so", "compile_linux.sh")
 elif sys.platform.startswith("darwin"):
-    compile_libraries_unix("libepanet2_2.dylib", "compile_macos.sh", gcc_name="gcc-12")
+    compile_libraries_unix("libepanet2_2.dylib", "compile_macos.sh", gcc_name="gcc-15")

epyt_flow/gym/scenario_control_env.py

@@ -23,6 +23,10 @@ class ScenarioControlEnv(ABC):
     autoreset : `bool`, optional
         If True, environment is automatically reset if terminated.
 
+        The default is False.
+    reapply_uncertainties_at_reset : `bool`, optional
+        If True, the uncertainties are re-applied to the original properties at each reset.
+
         The default is False.
 
     Attributes
@@ -36,7 +40,9 @@ class ScenarioControlEnv(ABC):
     _hydraulic_scada_data : :class:`~epyt_flow.simulation.scada.scada_data.ScadaData`, protected
         SCADA data from the hydraulic simulation -- only used if EPANET-MSX is used in the control scenario.
     """
-    def __init__(self, scenario_config: ScenarioConfig, autoreset: bool = False, **kwds):
+    def __init__(self, scenario_config: ScenarioConfig, autoreset: bool = False,
+                 reapply_uncertainties_at_reset: bool = False,
+                 **kwds):
         if not isinstance(scenario_config, ScenarioConfig):
             raise TypeError("'scenario_config' must be an instance of " +
                             "'epyt_flow.simulation.ScenarioConfig' " +
@@ -44,12 +50,15 @@ class ScenarioControlEnv(ABC):
         if not isinstance(autoreset, bool):
             raise TypeError("'autoreset' must be an instance of 'bool' " +
                             f"but not of '{type(autoreset)}'")
+        if not isinstance(reapply_uncertainties_at_reset, bool):
+            raise TypeError("")
 
         self._scenario_config = scenario_config
         self._scenario_sim = None
         self._sim_generator = None
         self.__autoreset = autoreset
         self._hydraulic_scada_data = None
+        self.__reapply_uncertainties_at_reset = reapply_uncertainties_at_reset
 
         super().__init__(**kwds)
 
@@ -65,6 +74,18 @@ class ScenarioControlEnv(ABC):
         """
         return self.__autoreset
 
+    @property
+    def reapply_uncertainties_at_reset(self) -> bool:
+        """
+        True, if the uncertainties are re-applied to the original properties at each reset.
+
+        Returns
+        -------
+        `bool`
+            True, if the uncertainties are re-applied to the original properties at each reset.
+        """
+        return self.__reapply_uncertainties_at_reset
+
     def __enter__(self):
         return self
 
@@ -117,14 +138,16 @@ class ScenarioControlEnv(ABC):
             # Run hydraulic simulation first
             hyd_export = os.path.join(get_temp_folder(), f"epytflow_env_MSX_{uuid.uuid4()}.hyd")
             sim = self._scenario_sim.run_hydraulic_simulation
-            self._hydraulic_scada_data = sim(hyd_export=hyd_export)
+            self._hydraulic_scada_data = sim(hyd_export=hyd_export,
+                                             reapply_uncertainties=self.__reapply_uncertainties_at_reset)
 
             # Run advanced quality analysis (EPANET-MSX) on top of the computed hydraulics
             gen = self._scenario_sim.run_advanced_quality_simulation_as_generator
             self._sim_generator = gen(hyd_export, support_abort=True)
         else:
             gen = self._scenario_sim.run_hydraulic_simulation_as_generator
-            self._sim_generator = gen(support_abort=True)
+            self._sim_generator = gen(support_abort=True,
+                                      reapply_uncertainties=self.__reapply_uncertainties_at_reset)
 
         return self._next_sim_itr()
 

epyt_flow/simulation/backend/my_epyt.py

@@ -1,6 +1,7 @@
 """
 This module contains a wrapper for EPyT that allows a better error/warning handling.
 """
+import warnings
 from ctypes import byref, create_string_buffer
 from epyt import epanet
 from epyt.epanet import epanetapi, epanetmsxapi
@@ -30,6 +31,10 @@ class EPyT(epanet):
         self.LibEPANETpath = self.api.LibEPANETpath
         self.LibEPANET = self.api.LibEPANET
 
+    def _logFunctionError(self, function_name):
+        # Do not print warnings.
+        pass
+
     def loadMSXFile(self, msxname, customMSXlib=None, ignore_properties=False):
         super().loadMSXFile(msxname, customMSXlib, ignore_properties)
 
@@ -40,17 +45,25 @@ class EPyT(epanet):
                                   msxrealfile=self.MSXFile)
         return self.msx
 
-    def set_error_handling(self, raise_exception_on_error: bool) -> None:
+    def set_error_handling(self, raise_exception_on_error: bool, warn_on_error: bool,
+                           ignore_error_codes: list[int]) -> None:
         """
         Specifies the behavior in the case of an error/warning --
-        i.e. should an exception be raised or not?
+        i.e. should an exception or warning be raised or not?
 
         Parameters
         ----------
         raise_exception_on_error : `bool`
             True if an exception should be raise, False otherwise.
+        warn_on_error : `bool`
+            True if a warning should be generated, False otherwise.
+        ignore_error_codes : `list[int]`
+            List of error codes that should be ignored -- i.e., no exception or
+            warning will be generated.
         """
-        self.api.set_error_handling(raise_exception_on_error)
+        self.api.set_error_handling(raise_exception_on_error, warn_on_error, ignore_error_codes)
+        if self.msx is not None:
+            self.msx.set_error_handling(raise_exception_on_error, warn_on_error, ignore_error_codes)
 
     def was_last_func_successful(self) -> bool:
         """
@@ -96,24 +109,39 @@ class MyEpanetMsxAPI(epanetmsxapi):
     Wrapper for the `epyt.epanet.epanetmsxapi <https://epanet-python-toolkit-epyt.readthedocs.io/en/latest/api.html#epyt.epanet.epanetmsxapi>`_
     class adding error/warning storage functionalities.
     """
-    def __init__(self, raise_on_error: bool = True, **kwds):
+    def __init__(self, raise_on_error: bool = True, warn_on_error: bool = False,
+                 ignore_error_codes: list[int] = [], **kwds):
         self.__raise_on_error = raise_on_error
+        self.__warn_on_error = warn_on_error
+        self.__ignore_error_codes = ignore_error_codes
         self.__last_error_code = None
         self.__last_error_desc = None
 
         super().__init__(**kwds)
 
-    def set_error_handling(self, raise_on_error: bool) -> None:
+    def _logFunctionError(self, function_name):
+        # Do not print warnings.
+        pass
+
+    def set_error_handling(self, raise_on_error: bool, warn_on_error: bool,
+                           ignore_error_codes: list[int] = []) -> None:
         """
         Specifies the behavior in the case of an error/warning --
-        i.e. should an exception be raised or not?
+        i.e. should an exception or warning be raised or not?
 
         Parameters
         ----------
         raise_exception_on_error : `bool`
             True if an exception should be raise, False otherwise.
+        warn_on_error : `bool`
+            True if a warning should be generated, False otherwise.
+        ignore_error_codes : `list[int]`
+            List of error codes that should be ignored -- i.e., no exception or
+            warning will be generated.
         """
         self.__raise_on_error = raise_on_error
+        self.__warn_on_error = warn_on_error
+        self.__ignore_error_codes = ignore_error_codes
 
     def get_last_error_desc(self) -> str:
         """
@@ -161,8 +189,11 @@ class MyEpanetMsxAPI(epanetmsxapi):
         self.__last_error_code = err_code
         self.__last_error_desc = error_desc.value.decode()
 
-        if self.__raise_on_error:
-            raise RuntimeError(self.__last_error_desc)
+        if self.__last_error_code not in self.__ignore_error_codes:
+            if self.__warn_on_error:
+                warnings.warn(self.__last_error_desc, RuntimeWarning)
+            if self.__raise_on_error:
+                raise RuntimeError(self.__last_error_desc)
 
     def MSXopen(self, msxfile, msxrealfile):
         self._reset_error()
@@ -286,24 +317,35 @@ class MyEpanetAPI(epanetapi):
     Wrapper for the `epyt.epanet.epanetapi <https://epanet-python-toolkit-epyt.readthedocs.io/en/latest/api.html#epyt.epanet.epanetapi>`_
     class adding error/warning storage functionalities.
     """
-    def __init__(self, raise_on_error: bool = True, **kwds):
+    def __init__(self, raise_on_error: bool = True, warn_on_error: bool = False,
+                 ignore_error_codes: list[int] = [], **kwds):
         self.__raise_on_error = raise_on_error
+        self.__warn_on_error = warn_on_error
+        self.__ignore_error_codes = ignore_error_codes
         self.__last_error_code = None
         self.__last_error_desc = None
 
         super().__init__(**kwds)
 
-    def set_error_handling(self, raise_on_error: bool) -> None:
+    def set_error_handling(self, raise_on_error: bool, warn_on_error: bool,
+                           ignore_error_codes: list[int] = []) -> None:
         """
         Specifies the behavior in the case of an error/warning --
-        i.e. should an exception be raised or not?
+        i.e. should an exception or warning be raised or not?
 
         Parameters
         ----------
         raise_exception_on_error : `bool`
             True if an exception should be raise, False otherwise.
+        warn_on_error : `bool`
+            True if a warning should be generated, False otherwise.
+        ignore_error_codes : `list[int]`
+            List of error codes that should be ignored -- i.e., no exception or
+            warning will be generated.
         """
         self.__raise_on_error = raise_on_error
+        self.__warn_on_error = warn_on_error
+        self.__ignore_error_codes = ignore_error_codes
 
     def get_last_error_desc(self) -> str:
         """
@@ -353,8 +395,11 @@ class MyEpanetAPI(epanetapi):
             self.__last_error_code = self.errcode
             self.__last_error_desc = error_desc.value.decode()
 
-            if self.__raise_on_error:
-                raise RuntimeError(self.__last_error_desc)
+            if self.__last_error_code not in self.__ignore_error_codes:
+                if self.__warn_on_error:
+                    warnings.warn(self.__last_error_desc, RuntimeWarning)
+                if self.__raise_on_error:
+                    raise RuntimeError(self.__last_error_desc)
 
     def ENepanet(self, inpfile="", rptfile="", binfile=""):
         self._reset_error()