Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

EPANET-RTX Library

The real-time extension to the EPANET Hydraulic Toolkit.
https://github.com/OpenWaterAnalytics/epanet-rtx

Category: Natural Resources
Sub Category: Water Supply and Quality

Keywords from Contributors

environmental-engineering hydraulics water-distribution

Last synced: about 20 hours ago
JSON representation

Repository metadata

Real-time extension to the EPANET hydraulic toolkit

README.md

EPANET-RTX Library

Introduction

EPANET-RTX is the real-time extension to the EPANET Hydraulic Toolkit. It provides an interoperable framework for moving data between a SCADA database, various time series analysis methods, and a hydraulic solver.

This project is being developed and maintained by a multidisciplinary team with various affiliations (members listed in alphabetical order):

  • Ernesto Arandia-Perez (developer, University of Cincinnati)
  • Sam Hatchett (lead developer, CitiLogics)
  • Robert Janke (design team, USEPA)
  • Tom Taxon (developer, Argonne National Lab)
  • Jim Uber (design team, CitiLogics / University of Cincinnati)
  • Hyoungmin Woo (developer, University of Cincinnati)

Intended Audience

The intended audience for this software can be divided roughly into two groups:

  • Programmers interested in water distribution system simulation
  • Water distribution simulation engineers interested in programming

The key here is an orientation towards folks who are comfortable with code. The RTX library is not a program per se, but a set of building blocks for constructing your own real-time simulation environment. If you've ever hacked EPANET or built a Matlab script for running hydraulic simulations, this library might be for you.

Find Out More

Get more info from the official documentation and the wiki.

Active Development

We are actively developing features in the following areas:

  • Time Series Forecasting
  • Water Age / Water Quality

Building

# debug
conan install . --profile=x86 -s build_type=Release --build=missing && \
conan install . --profile=x86 -s '&:build_type=Debug' -s 'tsflib*:build_type=Debug' -s 'epanet*:build_type=Debug' -s build_type=Release --build=missing && \
conan build . --profile=x86 -s build_type=Debug && \
conan export-pkg . --profile=x86 -s build_type=Debug

# release
conan install . --profile=x86 --build=missing -s build_type=Release
conan build . --profile=x86 --build=missing -s build_type=Release
conan export-pkg . --profile=x86 -s build_type=Release

# run tests
./build/Release/bin/rtx_test

if you are developing RTX as a dependent package locally, do this instead:

conan editable add .
conan install . --profile=x86 -s build_type=Release --build=missing && \
conan install . --profile=x86 -s '&:build_type=Debug' -s 'tsflib*:build_type=Debug' -s 'epanet*:build_type=Debug' -s build_type=Release --build=missing && \
conan build . --profile=x86 -s build_type=Debug && \
conan export-pkg . --profile=x86 -s build_type=Debug

Docker Build

docker buildx build -t epanetrtx-test -f epanet-rtx.docker --platform linux/amd64 .

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 6 days ago

Total Commits: 1,231
Total Committers: 11
Avg Commits per committer: 111.909
Development Distribution Score (DDS): 0.255

Commits in past year: 22
Committers in past year: 3
Avg Commits per committer in past year: 7.333
Development Distribution Score (DDS) in past year: 0.182

Name Email Commits
Sam Hatchett s****t@g****m 917
Jim Uber j****m@c****m 126
Sam Hatchett s****t@x****m 72
Sam Hatchett s****t@x****m 57
Cameron Devine c****e@x****m 34
samhatchett s****m@c****m 11
Steffen Macke s****n@s****e 6
Stephen Glindmeyer s****r@x****m 3
Hrant Nurijanyan h****n@x****m 3
yuniersoad y****d@g****m 1
Srinivas R Kulkarni s****2@g****m 1

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 90
Total pull requests: 19
Average time to close issues: 5 months
Average time to close pull requests: 22 days
Total issue authors: 11
Total pull request authors: 6
Average comments per issue: 1.26
Average comments per pull request: 0.21
Merged pull request: 15
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 6
Past year average time to close issues: N/A
Past year average time to close pull requests: 2 days
Past year issue authors: 1
Past year pull request authors: 3
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.17
Past year merged pull request: 5
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/OpenWaterAnalytics/epanet-rtx

Top Issue Authors

  • samhatchett (47)
  • jamesuber (29)
  • YangZhang18 (4)
  • dahuacai (2)
  • tafadzwagwena (2)
  • IgorInter (2)
  • bradleyjeck (1)
  • sadaarc (1)
  • Jiadalee (1)
  • atuanek (1)
  • Mark-Wilson-5411 (1)

Top Pull Request Authors

  • cameron-devine (6)
  • samhatchett (6)
  • 0tkl (3)
  • sglindme (2)
  • hrant-nurijanyan (1)
  • srinivasrk (1)

Top Issue Labels

  • enhancement (29)
  • bug (23)
  • question (8)
  • TimeSeries (7)
  • Model (5)
  • PointRecord (3)
  • wontfix (2)
  • cleanup (1)
  • Units (1)

Top Pull Request Labels

Score: 6.804614520062624