Skip to content

Latest commit

 

History

History
44 lines (42 loc) · 5.12 KB

ReleaseNotes2_3.md

File metadata and controls

44 lines (42 loc) · 5.12 KB
Raw

Release Notes for EPANET 2.3

This document describes the changes and updates that have been made in version 2.3 of EPANET.

  • The check for at least two nodes, one tank/reservoir and no unconnected junction nodes was moved from EN_open to EN_openH and EN_openQ so that partial network data files could be opened by the toolkit.
  • A EN_setcurvetype function was added to allow API clients to set a curve's type (e.g., EN_PUMP_CURVE, EN_VOLUME_CURVE, etc.).
  • A EN_setvertex function was added to allow API clients to change the coordinates of a single link vertex.
  • The index of a General Purpose Valve's (GPV's) head loss curve was added to the list of editable Link Properties using the symbolic constant name EN_GPV_CURVE.
  • The EN_getlinkvalue and EN_setlinkvalue functions were updated to get and set the value of EN_GPV_CURVE.
  • Negative pressure values for EN_SETTING are now permitted in the EN_setlinkvalue function.
  • The EN_STARTTIME parameter was added into the EN_settimeparam function.
  • A EN_DEMANDPATTERN parameter was added as the index of the default time pattern used by demands with no specific pattern assigned. It can be set or retrieved with the EN_setoption and EN_getoption functions, respectively, and is saved to file when the EN_saveinpfile function is called.
  • The EN_getaveragepatternvalue function will now accept a pattern index of 0 which represents the constant pattern assigned to junction demands by default.
  • The adjustment of a tank's minimum volume (Vmin) when its parameters are changed using EN_setnodevalue or EN_settankdata has been corrected.
  • A pump whose status is set to CLOSED in the input file now also has its speed setting set to 0 which fixes having a simple pressure control activate the pump correctly.
  • A failure to raise an error condition for a pipe roughness <= 0 in the input file has been fixed.
  • The calculation of head loss gradient for low flow conditions was corrected.
  • Improved updating and convergence tests were added to pressure dependent demand analysis.
  • Improved checks to prevent outflow from empty tanks or inflow to full (non-overflow) tanks, including the case where a link is connected to a pair of tanks.
  • The CI regression test protocol was modified by:
    • changing the absolute tolerance used to compare the closeness of test results to benchmark values from 0 to 0.0001
    • dropping the "correct decimal digits" test
    • dropping the check for identical status report content since it prevents accepting code changes that produce more accurate solutions in fewer iterations.
  • A possible loss of network connectivity when evaluating a Pressure Sustaining Valve was prevented.
  • Having the implied loss coefficient for an active Flow Control Valve be less than its fully opened value was prevented.
  • A new type of valve, a Positional Control Valve (PCV), was added that uses a valve characteristic curve to relate its loss coefficient to its fraction open setting.
  • A new set of functions have been added to get information about upcoming time step events. Users will now see what type of event is going to cause the end of a time step to occur. See ENtimetonextevent and EN_timetonextevent.
  • A new set of functions have been added to allow users to set a reporting callback function. The user-supplied function will recieve all output normally directed to the report file.
  • A EN_EMITBACKFLOW option was added that either allows emitters to have reverse flow through them (the default) or not.
  • Elevation was not set correctly when using EN_settankdata with SI units, this has been fixed.
  • The EN_INITSETTING option in function EN_getlinkvalue will return 0 if the setting equals MISSING due to a fixed OPEN/CLOSED status.
  • The functions EN_getnodevalue and EN_getlinkvalue now includes options EN_NODE_INCONTROL and EN_LINK_INCONTROL to determine whether a node or link participates in a simple or rule-based control.
  • Setting a minor loss of zero with EN_setlinkvalue(ph, index, EN_MINORLOSS, 0) would raise an error, this has been fixed.
  • The reporting of unconnected nodes was not displaying correctly, this has been fixed.
  • A header file for C# has been added.
  • A new error code 263 - node is not a tank is returned for when passing a non-tank node index to EN_settankdata or EN_setnodevalue with option EN_TANKLEVEL, EN_TANKDIAM, EN_MINVOLUME, EN_VOLCURVE, EN_MINLEVEL, EN_MAXLEVEL, EN_MIXMODEL, EN_MIXFRACTION, EN_TANK_KBULK or EN_CANOVERFLOW.
  • The function EN_saveinpfile was incorrectly setting simple controls using GPV with the index of their head loss curve instead of their status, this has been fixed.
  • Added support for Conan dependency manager.
  • Fix silent Qualflag reset when QUALITY is not NONE and simulation duration is 0 in EPANET input file.
  • Added support for cubic meters per second flow units.
  • A simple control with more than 9 input tokens would set the incorrect hour, this has been fixed.
  • When reading an EPANET inp file, errors in node and link vertex coordinates are ignored.
  • Non-zero demands are now not included in [DEMANDS] when running EN_saveinpfile.