Welcome to epanet-js! This guide will walk you through the basic steps of using the application, from creating a new project to running simulations and analyzing results. If you are familiar with the classic desktop EPANET, you'll find many features similar, with some modern enhancements designed to make your workflow more efficient.
https://www.youtube.com/watch?v=c1FPUm8osuc
epanet-js is a web-based version of EPANET that allows users to build, edit, and simulate water distribution networks directly in the browser. Unlike traditional cloud-based applications, epanet-js is local-first, meaning that your projects are saved directly to your computer, not the cloud.
<aside> ⭐
Local-first file saving – Your work is stored on your computer.
Interactive map-based editing – Draw and modify networks visually.
Quick shortcuts – Undo/redo, automatic junction placement, satellite mode.
Familiar EPANET tools – Similar structure to the desktop GUI.
Simulation & analysis tools – Run hydraulic simulations and visualize results. </aside>
Understanding the interface is the first step in using epanet-js efficiently. The application consists of four main sections:
Toolbar
Map
Panels
Status bar
The toolbar in epanet-js is your main control center, giving you quick access to essential functions for building, editing, and running simulations.
It provides project management tools, allowing you to create, open, and save your work, ensuring that changes are tracked and stored locally on your computer.
Editing actions like undo and redo help you quickly correct mistakes or experiment with different configurations without worrying about losing progress.
For building your network, the toolbar includes map tools, such as adding junctions, pipes, and reservoirs — key elements for constructing a water distribution model. These tools are designed to streamline the process, letting you place elements efficiently and connect them with minimal clicks.
Once your network is set up, the simulation and report options let you run hydraulic calculations and review the results.
<aside>
Project Actions:
New Project, Open INP, Save, Save As.
Edit Actions:
Undo, Redo.
Map Tools:
Select, Add Junction, Add Pipe, Add Reservoir.
Simulation & Report:
Run simulation, View report.
</aside>
The map view is where you build and interact with your water distribution network. This is where you’ll draw new elements, modify existing ones, and visualize simulation results.
Selecting an asset — such as a junction, pipe, or reservoir — will display its properties in the Assets Tab on the side panel, allowing you to review and adjust key parameters.
Navigation is intuitive, with standard map controls that should feel familiar. You can zoom in and out using the mouse wheel and pan by clicking and dragging. The toolbar provides tools to add network elements, while the Select tool lets you interact with specific assets.
A satellite toggle is available for switching between a standard map view and real-world imagery, helping you align your model with actual infrastructure. These features make it easy to navigate, edit, and refine your network efficiently.