Skip to main content

tsnet conducts transient simulation using MOC method for water distribution systems.

Project description

https://img.shields.io/pypi/v/tsnet.svg https://img.shields.io/travis/glorialulu/tsnet.svg Documentation Status PyPI - Downloads GitHub license GitHub (Pre-)Release Date

TSNet performs transient simulation in water networks using Method of Characteristics (MOC).

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

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)

  1. Fixed bugs about dead end and single pipe.

  2. Added plot and change detection methods.

0.2.0 (2020-4-23)

  1. Added quasi-steady and unsteady friction model.

  2. Added open and closed surge tanks.

  3. Added demand-pulse simulation.

  4. Updated docs.

0.2.1 (2020-09-09)

  1. Fixed minor bugs about valve default settings.

  2. Updated documentation.

  3. Updated WNTR compatibility.

0.2.2 (2020-09-24)

  1. Updated WNTR compatibility.

0.2.3 (2021-11-12)

  1. Only support WNTR version up until 0.3.0

0.2.4 (2022-06-17)

  1. fix minor issues regarding reporting messages

  2. Only support WNTR version up until 0.2.3.

0.3.0 (2023-02-22)

  1. Support WNTR version 1.0.0

  2. Test on python 3.10 and 3.11.

  3. Drop supports for Python 3.6 and 3.7

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tsnet-0.3.1.tar.gz (14.1 MB view details)

Uploaded Source

Built Distribution

tsnet-0.3.1-py2.py3-none-any.whl (33.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file tsnet-0.3.1.tar.gz.

File metadata

  • Download URL: tsnet-0.3.1.tar.gz
  • Upload date:
  • Size: 14.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.11

File hashes

Hashes for tsnet-0.3.1.tar.gz
Algorithm Hash digest
SHA256 116e622252285b1a8110f457ea4f3ad6d6a986edad3df0a79db69cbf08d79b3c
MD5 0b22e8861a994ba2921769140e017574
BLAKE2b-256 453ed967bf84bb7531a885f0fe3a1ec91be434d3e7aceb535f0fb14d004f48af

See more details on using hashes here.

File details

Details for the file tsnet-0.3.1-py2.py3-none-any.whl.

File metadata

  • Download URL: tsnet-0.3.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 33.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.11

File hashes

Hashes for tsnet-0.3.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 773a0dfb3911514c924524234c800ec100647051660990422c4420398b6f7fa4
MD5 52938a20a29b29ee3e526214fb040302
BLAKE2b-256 f8b17e288dfeede79988a1dbed39f70d5b22c1cd7390eddb8b40669ed460a12a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page