/epanettools4cv

"Reading the simulating data of control valves from Epanet files into R."

Primary LanguageRGNU General Public License v3.0GPL-3.0

editor_options
markdown
wrap
72

epanettools4cv

epanettools4cv is an R package for reading the data and simulating control valves in Epanet’s .inp and .rpt formats into R.

The goal of epanettools4cv is to …

Installation

You can install the development version of epanettools4cv like so:

# FILL THIS IN! HOW CAN PEOPLE INSTALL YOUR DEV PACKAGE?

Package units

All data are stored in the following SI (International System) units:

  • Length in meter (m)
  • Diameter in millimeter (mm)
  • Water pressure in meter (m this assumes a fluid density of 1.000 (kg/m^3))
  • Elevation in meter (m)
  • Time in seconds s
  • Concentration in kg/m^3
  • Flow in L/s
  • Demand in L/s
  • Velocity in m/s
  • Acceleration g (g = 9.81 m/s^2)
  • Energy in kW-hour
  • Power in kW
  • Volume in m^3

EPANET unit conventions

Parameter US customary units SI-based units
Concentration mass/L where mass can be defined as mg or ug mass /L where mass can be defined as mg or ug
Demand Same as flow Same as flow
Diameter (Pipes) in mm
Diameter (Tanks) ft m
Efficiency (Pumps) percent \% percent \%
Elevation ft m
Emitter coefficient flow / sqrt(psi) flow / sqrt(m)
Energy kW-hours kW-hours
Flow - CFS: ft^3/s
- GPM: gal/min
- MGD: million gal/day
- IMGD: million imperial gal/day
- AFD: acre-feet/day		 - LPS: L/s
- LPM: L/min
- MLD: million L/day
- CMH: m^3/hr
- CMD: m^3/day
Friction factor unitless unitless
Hydraulic head ft m
Length ft m
Minor loss coefficient unitless unitless
Power horsepower kW
Pressure psi m
Reaction coefficient (Bulk) 1/day (1st-order) 1/day (1st-order)
Reaction coefficient (Wall) - mass /ft/day (0-order)
- ft/day (1st-order))		 - mass /mt/day (0-order)
- m/day (1st-order))
Roughness coefficient - 10^{-3} ft (Darcy-Weisbach)
- unitless (otherwise)		 - millimeter (Darcy-Weisbach)
- unitless (otherwise)
Source mass injection rate mass/min mass/min
Velocity ft/s m/s
Volume ft^3 m^3
Water age hours hours

Control valves samples

GPV Curves

Generally, every control valve has a specific curve that describes the relationship between valve opening and the corresponding headloss coefficient (in general, this curve can be provided by the valve supplier).

By analyzing the measured data of flow passing the valve at the corresponding valve openings, you can create a flow to valve opening curve which can be transformed into the flow to headloss curve using the provided headloss to valve opening curve. You can do that in a calculation table or adjust your software to make the post-processing before creating the .inp-file.