Model water quality and chemical transport

Track water age, trace supply blending, and simulate chlorine decay and multi-species reactions through your network using the standard EPANET engine.

Identify the root causes of water quality issues

Taste and odor complaints, depleted chlorine residuals, and discolored water surface at the customer tap, but their root causes lie upstream in oversized mains, dead ends, and poorly mixed storage tanks. Because a calibrated hydraulic model already dictates flow paths and travel times, water quality analysis simply puts those mechanics to work.

epanet-js executes the complete suite of standard EPANET quality analyses: tracking water age to identify stagnation, performing source traces to map supply boundaries, and running chemical routing to monitor constituent concentrations (like chlorine) as they propagate and decay across the distribution system.

Map supply boundaries with source tracing

In multi-source distribution systems, the boundary between different treatment plant supplies fluctuates constantly as diurnal demands rise and fall. A source trace computes the exact percentage of water originating from a designated supply node for every junction at every timestep.

This provides direct operational intelligence: verifying which pressure zones receive specific blended ratios, predicting the propagation of a new supply switchover, and isolating the footprint of a water quality complaint. If a localized taste issue maps perfectly to a single source's trace footprint, you know exactly where to investigate.

Maintain chlorine residuals across the network

Disinfectant residuals decay dynamically through bulk water reactions and pipe wall interactions. By modeling chlorine as a reactive constituent, you can visualize residual concentrations at every node over time—identifying network extremities and low-demand loops that drop below regulatory minimums before physical sampling flags a violation.

Simulate corrective actions before implementation. Adjust the dosing concentration at the treatment works or site a new booster chlorination station mid-network, then re-run the simulation to verify that target residuals are restored without over-dosing upstream customers.

Validate unidirectional flushing (UDF) plans

Effective flushing requires sufficient velocity to scour biofilm and sediment from the pipe wall. Whether a flush succeeds depends entirely on which valves are isolated and which hydrants are opened. Use the model to design a unidirectional flushing sequence and verify that every pipe segment achieves the target scour velocity.

By simulating the exact hydrant and valve operations, you can identify mains that fail to reach scouring velocity, adjust the isolation sequence directly in the software, and generate a validated UDF plan. Field teams get an optimized sequence that minimizes non-revenue water (NRW) while ensuring clean pipes.

Simulate complex chemistry with MSX

Advanced water quality challenges—such as chloramine decay, nitrification, or disinfection byproduct (DBP) formation—involve complex interacting chemistry that cannot be modeled as a simple first-order decay.

epanet-js natively integrates the EPANET Multi-Species Extension (MSX). This allows you to define multiple interacting constituents, specify reaction rate expressions, and simulate complex chemical dynamics reacting with each other and the pipe wall concurrently with network hydraulics.

Core capabilities of water quality analysis

Standard EPANET 2.3 engine

epanet-js runs the official EPANET 2.3.5 toolkit unmodified, ensuring your water quality results match industry-standard calculations exactly.

Comprehensive quality modeling

Simulate water age, source blending, and chemical transport and decay—including full Multi-Species Extension (MSX) support—in one workspace.

Dynamic visual results

Watch water quality propagate across the network map at every timestep, making stagnation zones and low residual boundaries immediately obvious.

Exportable time-series data

Export constituent concentrations, age, and trace percentages as full time-series data to CSV or XLSX for reporting and compliance tracking.

Verify the quality of your network

Run a water age or source trace analysis on your own model in minutes. Launch epanet-js free, or book a demo with our engineering team.

Seamless integration with hydraulic analysis

Water quality in epanet-js utilizes the exact same network file as your hydraulic simulations. There is no secondary software to license, and no need to maintain disconnected model copies. Build your network, calibrate the hydraulics, and execute quality runs directly from the same workspace.

It fits naturally alongside your broader workflow: operational modeling provides the temporal controls and extended period simulations that quality routing depends on, while calibration ensures your velocities and travel times are physically accurate before you superimpose chemistry onto them.

Explore related modeling solutions

See how water quality connects to the rest of the modeling lifecycle.

Frequently asked questions

Frequently asked questions about water quality modeling.

When should I use water age, source tracing, or chemical analysis?
Water age tracks residence time, providing a rapid screen for stagnation risk and disinfectant decay. Source tracing calculates the percentage of water originating from a specific supply node, which is critical for defining blend zones. Chemical analysis simulates the transport and decay of a reactive constituent (like chlorine) over time. Comprehensive quality studies frequently utilize all three.
Does epanet-js support multi-species reactions?
Yes. epanet-js fully integrates the EPANET Multi-Species Extension (MSX). This allows you to model complex interacting chemistry—such as chloramine decay, nitrification, and disinfection byproduct (DBP) formation—where multiple constituents react with each other and the pipe wall simultaneously.
Why do quality simulations require an extended period simulation (EPS)?
Water quality is inherently dynamic. Residence times accumulate, residuals decay, and source blend boundaries shift alongside diurnal demand variations. A single steady-state snapshot cannot capture these propagation mechanics. Quality models must be run over a multi-day EPS to allow constituent profiles to stabilize into a repeating pattern.
What does my model need for accurate quality results?
Verified hydraulics are the prerequisite. Chemical transport and water age are governed entirely by flow velocities and travel times; if the hydraulic calibration is inaccurate, the quality results will be too. For chemical routing, you also require accurate bulk and wall reaction coefficients. If your hydraulics need refinement, start with calibration.
Are quality settings preserved when exporting to .inp?
Yes. Water quality parameters, source nodes, global reaction coefficients, and local pipe modifiers are fully supported by the standard EPANET .inp specification. Moving models between epanet-js and other compliant software preserves your quality configurations completely.
Do the results match EPANET?
Yes. epanet-js executes the official EPANET 2.3 toolkit. Any chemical routing, trace, or age simulation you configure will produce the exact same numerical results as the EPA desktop software.

Answer your next water quality question

Simulate water age, map source traces, and track chlorine residuals directly on your network. Launch epanet-js or schedule a technical walk-through.