Code Monkey home page Code Monkey logo

epanet2.2's Introduction

EPANET 2.2

image37

Build Status

Build and Test

Introduction

EPANET is used to perform extended-period simulation of the hydraulic and water quality behavior within drinking water distribution systems (e.g., pressurized pipe networks), which consist of pipes, nodes (junctions), pumps, valves, storage tanks, and reservoirs. It can be used to track the flow of water in each pipe, the pressure at each node, the height of the water in each tank, a chemical concentration, the age of the water, and source tracing throughout the network during a simulation period.

EPANET was developed as a tool for understanding the movement and fate of drinking water constituents within distribution systems, and can be used for many different kinds of applications in distribution systems analysis. Today, engineers and consultants use EPANET to design and size new water infrastructure, retrofit existing aging infrastructure, optimize operations of tanks and pumps, reduce energy usage, investigate water quality problems, and prepare for emergencies. EPANET can also be used to model contamination threats and evaluate resilience to security threats or natural disasters.

Description

This repository was established to provide U.S. EPA’s official release of 2.2.0. The last official release of EPANET was version 2.00.12, dated 2008. The release of EPANET 2.2.0 represents a significant step forward in two important ways. First, the EPANET 2.2.0 release represents a new, open source software project in collaboration with the community at OpenWaterAnalytics (https://github.com/OpenWaterAnalytics/EPANET) to maintain and extend EPANET. The EPANET developers’ community at OWA (http://community.wateranalytics.org) is composed of dedicated volunteers from around the world who have a passion for EPANET. Second, EPANET 2.2.0 includes major updates to the hydraulic and water quality engines of EPANET 2.00.12.

This repository is being set up to bring together the EPANET engine contributions from the EPA/OWA’s release of EPANET 2.2.0 (https://github.com/OpenWaterAnalytics/EPANET/releases/tag/v2.2) along with U.S. EPA’s effort to update the Delphi-based user interface, user’s manual, and the integrated Help manual, which resides within the Delphi-based EPANET graphical user interface.

This repository is for archiving the source code and document files associated with the EPA/OWA EPANET 2.2.0 release. Anyone interested in examining these files can peruse the appropriate folder in this repository.

Intended Audience

The intended audience for this repository is anyone working on water distribution system modeling and interested in knowing more about the source code and documentation associated with the official release of EPANET 2.2.0.

License

EPANET is released under the MIT license. See the LICENSE.txt file.

Contributing

EPANET has an active open source software community including consulting engineers, students, researchers, software companies, professional organizations, other interested members of the public, and EPA partners. An Open Source EPANET Initiative is at http://community.wateranalytics.org. Anyone wanting to contribute to the open source, collaborative project for EPANET should go to https://github.com/OpenWaterAnalytics/EPANET. Everyone is welcome to participate in the EPANET project. Whether you are helping others to resolve issues, reporting a new unknown issue, suggesting a new feature that would benefit your workflow, or writing code, we value and appreciate your time and effort. The path for contribution starts with entering an issue at https://github.com/OpenWaterAnalytics/EPANET/issues. Examine the open issues at this link and the conversation around them, and then get engaged!

Finally, the issues identified and resolved here were the result of U.S. EPA's efforts to coordinate beta testing of the EPA/OWA EPANET version 2.2.0.

Documentation

The "Read-the-Docs" version of the EPANET User's Manual is available here at https://epanet22.readthedocs.io/en/latest/. Alternatively, an Acrobat PDF version is available for download within the User Manual folder https://github.com/USEPA/EPANET2.2/tree/master/User_Manual.

Contact

[email protected]

EPA Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity, confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.

epanet2.2's People

Contributors

andychase avatar cbuahin avatar fengshang1972 avatar rjanke20 avatar rwashing523 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

epanet2.2's Issues

Suggestions for future releases of EPANET about profile plots and backdrop formats

Hello
As a master degree engineer I have used EPANET since early 1990s. Mostly it works superb, but I have some wishes for future releases.

Profile plots.

  1. I would like to make profiles showing both elevation and head in one single plot. In my opinion this would be an essential function for epanet; to visualize elevation, pressure and head is what it is all about.
  2. The horizontal axes on profile plots seems to be connected with the graphical distance between junctions on screen. I think it would be better if it was linked to the actual length of links between junctions. Then the profile plot would be correct even if the junctions are placed on the map/screen as a system sketch.
  3. If max , min and increment for axes are set manually, it resets every time I run calculations. This I find rather annoying. I want to keep the changes.

Backdrop
4) My fourth wish is that online maps could be used as backdrop, not just bmp-, emf- and wmf-files. Then I would never need any other software for these type of calculations.

Best wishes
FINN HARALD ELIASSEN
Sivilingeniør, seksjon VA

(+47) 98 23 44 28 |55 62 33 56|[email protected]
www.multiconsult.no

Menu and Registry enhancements

I wish to recommend the following easy to implement user-friendly improvements. It is quite frustrating for me to reset these every time I open the program.

There are things which a user may select like:

File>Preferences>Formats. Setting decimals for various parameters. The choice of the user can be saved in the Windows Registry. I use SaveSettings in VB6 , but C will have a different statement. Each time the user opens the program, these setting can be read from the Registry and applied to the Preferences (I use GetSettings in VB6). It now jumps back to the hard coded settings.

View>Options>Map Options>Notation. The font size the user works with can also be saved and read from the registry, as presently, when the program is opened, it jumps back to the hard coded settings.

On the Browser, the selection a user makes, can also be saved and read again. I am referring to what is normally selected by the user. In my case it is pressure at nodes and flow in pipes, Presently it jumps back to no selection when the program is opened.

The options a user has, are all over the menus. One single main menu item could be 'Options' which can include the following in submenus or one large frame with all the settings will be even better.

File>Preferences
View>Dimensions
View>Legends>Modify
Project>Defaults
Project>Analysis options

Thanks

PK

Beta Tester - LICENSE File

License question with the EPA’s release of v2.2.0 from the website. Is copyright holder OWA or contributing authors?

wrong documentation reg. the binary output

in types.h the pressure units are ordered like so:
enum PressUnitsType /* Pressure units: */ {PSI, /* pounds per square inch */ KPA, /* kiloPascals */ METERS}; /* meters */
But in the manual (Appendix C4) they are ordered:
Pressure Units Option
0 = psi
1 = meters
2 = kPa

Beta Tester - RECOMMENDATION

It is recommended that the pressure dependent demand (PDD) features be included into epanetmsx.exe to allow a user to perform multi-species water quality analysis based on pressure-driven hydraulic analysis. In the current version, Wagner’s equation is used to perform PDA. It would be beneficial if users could also integrate other types of pressure-demand relationships in the model and various minimum/required pressures at the nodes.

Beta Tester - INSTALLER

Installation issues with “.msi” file. [Conflicts with Windows Defender in some situations and requires a work-around.]

Efficiency curves not read into EPANET GUI from .inp file

Based on the [Curves] section of the Input File Format page (https://epanet22.readthedocs.io/en/latest/back_matter.html#command-line), I tried to create an efficiency curve in the input file but it does not read into the EPANET GUI when I import the .inp file. Is it possible that the section linked above is not complete and there is another step to make sure the curve editor shows this curve as an efficiency curve? I tried referencing the efficiency curve in the [pump] section but that did not work.

image

image

Results differ between GUI and command line version

Hi. I have a network file for which I'm performing a hydraulic analysis. Some result differ between EPANET GUI version and epanet command line file provided with the package. The results between command line and DLL that I exported from source code, downloaded from the ebsite is consistent. So, it's not clear if the results from EPANET GUI is the correct one or the result from command line version.
I'm using Pressure-Demand Analysis

Beta Tester - RESULTS

[For my network model] Note that “maximum trials are exceeded several times and the system flow balance numbers can't be trusted. It is not a large network (10K pipes) but there are quite few PRV's.”

Beta Tester Comments

First, this issue is a Thank-You to all the Beta Testers that helped us review the EPA/OWA Beta Test Release of EPANET 2.2.0 and for providing comments. As a component of EPA’s review process, EPA conducted this peer review of a beta version of EPANET 2.2.0 (dated July 25, 2019) and received several comments from a group of volunteer reviewers (Beta Testers). These Beta Testers provided comments in four areas: (1) needed edits and corrections to the updated, Delphi user interface (UI), (2) needed corrections to the license file (LICENSE), (3) problem with the installer (INSTALLER), and (4) comparability or differences in results with v2.00.12 (RESULTS). These Beta Tester comments will be documented here in subsequent issues. Beta Tester comments will be grouped and entered by area, along with an appropriate label, e.g., “EPA_Beta_Tester_UI”. This issue will be closed when the EPANET 2.2.0 is posted to our website.

thermal losses in pipes & demand pattern for valve setting

Hi everyone

I am not sure if some already faced with this issues.
For simulations of district heating networks with Epanet it would be very useful if the thermal losses of the pipes (change of fluid temperature in a pipe due to surrounding --> constant temperature or temperature pattern) can be considered and if there would be a posibility to set time patterns for the valve setting.
Did someone face with that or has something similar been done yet (the physical knowledge I have but my programming skills are limited)?

Thanks much and regards!

Beta Testers - RESULTS

Several Beta Testers reported:
ISSUE #1: Evidence of a model running in 2.00.12 but not in v2.2.
ISSUE #2: Differences observed between v2.2 and v2.00.12.
ISSUE #3: Tank overflow feature did not run with a model selected for testing. Error received, “Error 206: undefined curve -16s in (TANKS) section: …”

join PRV and Tank

Hello
I need to put a PRV next to a water Tank to simulate a water supply network. In the epanet software help and in the error message number 219, it is mentioned that the tank and the PRV must be separated from each other. Please guide me to fix this error.
Thank you

Beta Tester - RESULTS

[For my network model] Note that “maximum trials are exceeded several times and the system flow balance numbers can't be trusted. It is not a large network (10K pipes) but there are quite few PRV's.”

Beta Tester - UI

[Within the GUI] EPANET header should be 2.2 rather than 2.0.

Beta Tester - QUESTION

For near-zero flows, a simple network with a base demand of 0.005 GPM has an actual demand (flow) rounding up to 0.01 GPM. The same for 0.004 GPM, and it rounds down to 0 GPM. Is it possible to increase the significant figure by one more decimal place?

Handle Descriptions the same as EPASWMM to allow multiline

Descriptions for network elements are very useful to keep track of data sources, changes, tasks to be completed, etc.

In EPANET, descriptions are currently saved in the input file by adding a semicolon and writing them after, on the same line of the entity. This means it cannot support multi-line comments (either reading or writing).

In EPASWMM, descriptions are saved in the input file by adding separate comment lines (starting with semicolon) ABOVE the entity line. This allows for multi-line comments.

Is there any interest in adapting EPANET to support multi-line comments by following a similar approach to EPASWMM?

Beta Tester - RESULTS

Multiple reviewers note some minor differences between v2.00.12 and the beta release of v2.2.0.

The valve properties

Hello, how to add the'Setting' option of the PRV valve in EPANET2.2? Should it be set to the pre-valve pressure or the post-valve pressure?

value

Hello,how to understand the "setting" option in the valve?

Beta Tester UI

Graphical User Interface Edits and Corrections:
Setup screen - License term didn’t align properly.
Graph Options - The GUI has default values, but one option. Graph label needs to set a default value.
Copy-paste option - Copy to Meta file captures larger screen than the actual plot window size. Copy to Bitmap is fine.
Windows display scale compatibility - Conflict to windows scale option

Recommendations:
Change to new organization name in the “About EPANET” dialogue box.
Addition of a section “What’s New in 2.2” in the Help file.
Set to default High DPI Scaling Option - With the High DPI scaling override option.
Manual - Addition of PDA simulation example (e.g. a simple NET1 example with PDA simulation option).

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.