tsnet conducts transient simulation using MOC method for water distribution systems.
Project description
TSNet performs transient simulation in water networks using Method of Characteristics (MOC).
Free software: MIT license
Documentation: https://tsnet.readthedocs.io.
Overview
A number of commercial software for transient simulation in water distribution systems are available in the market; however, the use of these software for research purposes is limited. The major restriction is due to the fact that the programs are packed as black boxes, and the source code is not visible, thus prohibiting any changes, including modification of existing and implementation of new elements, in the source code. Therefore, the authors find it imperative to develop an open source package rendering easiness for interaction, modification, and extension.
Features
TSNet is a Python package designed to perform transient simulation in water distribution networks. The software includes capabilities to:
Create water network models based on .inp files
Generate transient events by operating valves and pumps
Add disruptive events including pipe bursts and leakages
Add surge protection devices
Choose between steady,quasi-steady, and unsteady friction models
Perform transient simulation using MOC method
Visualize results
For more information, go to https://tsnet.readthedocs.io.
Version
TSNet is a ongoing research project in the University of Texas at Austin. The current version is 0.2.2, which is still a pre-release.
Contact
Lu Xing, the University of Texas at Austin, xinglu@utexas.edu
Lina Sela, the University of Texas at Austin, linasela@utexas.edu
Disclaimer
No warranty, expressed or implied, is made as to the correctness of the results or the suitability of the application.
Cite TSNet
To cite TSNet, use one of the following references:
Xing, Lu, and Lina Sela. “Transient simulations in water distribution networks: TSNet python package.” Advances in Engineering Software 149 (2020): 102884.
License
TSNet is released under the MIT license. See the LICENSE.txt file.
History
0.1.0 (2019-08-15)
First release on PyPI.
0.1.1 (2019-09-21)
0.1.2 (2020-01-20)
Fixed bugs about dead end and single pipe.
Added plot and change detection methods.
0.2.0 (2020-4-23)
Added quasi-steady and unsteady friction model.
Added open and closed surge tanks.
Added demand-pulse simulation.
Updated docs.
0.2.1 (2020-09-09)
Fixed minor bugs about valve default settings.
Updated documentation.
Updated WNTR compatibility.
0.2.2 (2020-09-24)
Updated WNTR compatibility.
0.2.3 (2021-11-12)
Only support WNTR version up until 0.3.0
0.2.4 (2022-06-17)
fix minor issues regarding reporting messages
Only support WNTR version up until 0.2.3.
0.3.0 (2023-02-22)
Support WNTR version 1.0.0
Test on python 3.10 and 3.11.
Drop supports for Python 3.6 and 3.7
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tsnet-0.3.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 773a0dfb3911514c924524234c800ec100647051660990422c4420398b6f7fa4 |
|
MD5 | 52938a20a29b29ee3e526214fb040302 |
|
BLAKE2b-256 | f8b17e288dfeede79988a1dbed39f70d5b22c1cd7390eddb8b40669ed460a12a |