From 61b03b8539e26001b69ed59e602226b9818d3d13 Mon Sep 17 00:00:00 2001 From: Lew Rossman Date: Tue, 7 Feb 2023 22:59:18 -0500 Subject: [PATCH] Updating the docs --- ReleaseNotes2_3.md | 5 +++-- doc/input-file.dox | 3 +++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/ReleaseNotes2_3.md b/ReleaseNotes2_3.md index 2a51cd6..a706923 100644 --- a/ReleaseNotes2_3.md +++ b/ReleaseNotes2_3.md @@ -1,4 +1,4 @@ -> +> ## Release Notes for EPANET 2.3 This document describes the changes and updates that have been made in version 2.3 of EPANET. @@ -17,7 +17,7 @@ This document describes the changes and updates that have been made in version 2 - 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. *(Still needs more work).* + - 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 @@ -27,5 +27,6 @@ This document describes the changes and updates that have been made in version 2 - 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. diff --git a/doc/input-file.dox b/doc/input-file.dox index f4d36ce..758b847 100644 --- a/doc/input-file.dox +++ b/doc/input-file.dox @@ -298,6 +298,7 @@ __Formats:__ PATTERNid DEMAND MULTIPLIERvalue EMITTER EXPONENTvalue +EMITTER BACKFLOWYES / NO QUALITYNONE / CHEMICAL / AGE / TRACE   nodeID DIFFUSIVITYvalue TOLERANCEvalue @@ -357,6 +358,8 @@ The DEMAND MULTIPLIER is used to adjust the values of baseline demands fo EMITTER EXPONENT specifies the power to which the pressure at a junction is raised when computing the flow issuing from an emitter. The default is 0.5. +EMITTER BACKFLOW specifies if back flow through an emitter (i.e., flow into the network) is allowed. The default is YES. + \b QUALITY selects the type of water quality analysis to perform. The choices are NONE, CHEMICAL, AGE, and \b TRACE. In place of \b CHEMICAL the actual name of the chemical can be used followed by its concentration units (e.g., CHLORINE mg/L). If \b TRACE is selected it must be followed by the ID label of the node being traced. The default selection is \b NONE (no water quality analysis). \b DIFFUSIVITY is the molecular diffusivity of the chemical being analyzed relative to that of chlorine in water. The default value is 1.0. Diffusivity is only used when mass transfer limitations are considered in pipe wall reactions. A value of 0 will cause EPANET to ignore mass transfer limitations.