TSNet-ts

Water-hammer & hydraulic transient simulation in TypeScript — Method of Characteristics on EPANET .inp networks, in the browser or as an npm library.

Full clip: docs/demo.mp4

Try it live: tsnet-ts.github.io/TSNet-ts · Install: npm install @tsnet-ts/ts-net

Features

• Load EPANET .inp networks and run MOC transients (no server required for the demo)
• Events: valve closure, pump trip, pipe burst, leaks, demand pulse, surge tank
• Steady / quasi-steady / unsteady friction
• Steady-state init (demand-driven or pressure-dependent demand)
• Browser UI plus a publishable MIT library (@tsnet-ts/ts-net)

Package	Directory	License
@tsnet-ts/ts-net	TSNET-TS/	MIT
react-ts (web app)	React-TS/	PolyForm Noncommercial 1.0.0

TypeScript port of TSNet (Xing & Sela).

Cite TSNet

If you use this work, please cite the original TSNet paper:

Xing, L., & Sela, L. (2020). Transient simulations in water distribution networks: TSNet python package. Advances in Engineering Software, 149, 102884. https://doi.org/10.1016/j.advengsoft.2020.102884

Contact

Questions, commercial licensing for the web app, or collaboration: tsnetts@gmail.com

Getting started

bun install         # install all workspace packages
bun run build       # build library + web app
bun run dev         # start React-TS dev server (port 5173)
bun test            # run ts-net tests

Workspace scripts

Command	Description
bun run --cwd TSNET-TS build	Compile TSNET-TS to dist/
bun run --cwd React-TS build	Build React-TS for production
bun run --cwd TSNET-TS test	Run Vitest tests
bun run --cwd React-TS dev	Vite dev server

License

Package	License
@tsnet-ts/ts-net (TSNET-TS/)	MIT
react-ts (React-TS/)	PolyForm Noncommercial 1.0.0 — commercial use requires approval