🌤️
Cloud Cover Override
Off
100%
New Pipe
Water Quality
Pipe Properties
Water Quality
Control Link Properties
Unit Settings
📝 Edit Note
EPS Summary Report
Cumulative and average metrics for energy, power, fuel, and water across the extended period simulation.
| Category | Metric | Value | Unit |
|---|
Save Project
Open Project
You haven't saved any projects yet.
Component
Select a component to see telemetry.
Chart Properties
A chart can display a maximum of 2 distinct units. Each axis (Y1 or Y2) can only support one unit type.
Selected Metrics
Y1
Y2
Add New Metric
Canvas Properties
#F8FAFC
Pipe Materials Library
Manage pipe materials and their properties for dynamic surge simulation (MOC) and hydraulic friction.
| Material Name | Roughness (C) | Young's Modulus (psi) | Poisson's Ratio | Actions |
|---|
Manage Patterns
Hourly Multipliers (1.0 = Base Value)
Time Period
Multiplier
Select or create a demand pattern
Site Location
Configure the site location to fetch weather data for power generation modeling.
Power Generator Properties
Solar Properties
Wind Properties
Hydropower Properties
Generator Properties
Startup Sequence
Simulation Settings
Coarse
0.01 s
High-Fi
⚠️ DVCM requires a high-fidelity simulation timestep (≤ 0.001 s) to maintain numerical stability during water-column collapse. Coarser timesteps have been reverted to legacy clamping.
Transient Acceptance Criteria
Chart Settings
MOC Summary Report
Peak Pressures tracked at native 10ms resolution during transient mode.
| Node ID | Min Pressure (psi) | Max Pressure (psi) |
|---|
🔔
You're on the Waiting List!
Thank you for your interest in the R-Thym AI Co-pilot Premium Tier. We have added you to our waiting list and will notify you as soon as access is available!
Component & Property Table
Scenario Manager
Add New Scenario
Available Scenarios
Base Scenario
DEFAULT
Global/base layout configurations and parameters. Serves as reference.
Energy Rate Settings
Electric Utility Costs
$
$
$
Fuel Costs ($ / Unit)
$
$
$
$
💬
Provide Feedback
Please describe the issue or suggestion in detail. The more actionable your feedback, the quicker I can address your request. Some helpful information includes:
- Steps to reproduce the issue
- Expected behavior
- Actual behavior
- Any error messages
- Any relevant information
About R-THYM
R-THYM Digital Twin
Version 1.051R-THYM is a next-generation digital twin that unifies water infrastructure and energy management. Optimize your system's energy footprint, evaluate renewables, and pressure-test operations against high-fidelity hydraulic transients, entirely in the browser.
Designed and developed by Jason Lillywhite.
Open Source Libraries & APIs
R-THYM utilizes the following third-party libraries and APIs to deliver robust simulation capabilities:
RTHYM-MOC
Open Source
High-fidelity transient water hammer and dynamic hydraulics simulation engine.
github.com/jlillywh/RTHYM-MOC
EPANET-JS
Pressurized hydraulic simulation engine in WebAssembly.
Chart.js
Dynamic simulation charting tools.
Panzoom
SVG panning and zooming.
TailwindCSS
Utility-first CSS framework.
Open-Meteo
Open-Source Weather API.
End User License Agreement (EULA)
Last Updated: June 9, 2026Please read our terms and conditions of usage before using the software.
1. ACCEPTANCE OF TERMS
By accessing or using R-THYM (the "Software"), provided by Lillywhite Water Solutions LLC, doing business as Lillywhite Water Technology Solutions ("LWTS", "we", or "us"), you agree to be bound by the terms of this End User License Agreement ("Agreement"), as well as our global Terms of Service. If you do not agree to these terms, do not use the Software.
2. PROFESSIONAL DISCLAIMER
The R-THYM platform is a tool for licensed professionals. Your use of this tool does not replace the professional judgment of a licensed engineer. You assume all responsibility for interpreting model results and integrating them into professional engineering work. Use of these tools does not constitute a Professional Engineering relationship, nor does it establish an expert-client privilege. A formal Professional Services Agreement (PSA) must be fully executed before any binding consulting or engineering design services commence.
3. LIMITATION OF LIABILITY & WARRANTIES
LWTS provides cloud-based digital twins and calculators "as is" and without warranties of any kind, whether express or implied. LWTS assumes no liability for the accuracy, completeness, or usefulness of the mathematical outputs. Numerical instability, inherent model approximations, and input errors may lead to inaccurate results. Any direct application of these tools to municipal infrastructure, industrial operations, or life-safety systems without independent, licensed verification is strictly prohibited and at your sole risk. In no event shall LWTS's aggregate liability exceed the total fees actually paid by you to LWTS in the twelve (12) months preceding the claim, or one hundred dollars ($100.00), whichever is greater.
4. INTELLECTUAL PROPERTY RIGHTS
All materials produced, including web applications, dashboard interfaces, API schemas, and underlying source code developed by LWTS remain the exclusive intellectual property of LWTS. Web-enabled access does not grant the user any license to copy, reverse-engineer, mass-scrape, or independently commercialize the mathematical models or the web application code without the prior written permission of LWTS.
5. DATA OWNERSHIP
You retain all rights, title, and interest in and to the data you upload to the Software. You grant LWTS a non-exclusive, worldwide, royalty-free license to host, copy, and display your data solely to provide the services requested by you. This data is handled in strict accordance with our Privacy Policy.
6. INDEMNIFICATION
You agree to indemnify and hold harmless LWTS from any claims, damages, or expenses arising out of your misuse of the Software or your failure to verify model results as required by local engineering standards.
7. SUBSCRIPTION & TERMINATION
LWTS reserves the right to suspend or terminate your access to the Software immediately, without notice, if your subscription payment is not received in full or if your use of the Software violates these terms.
8. GOVERNING LAW
This Agreement shall be governed by the laws of the State of Washington. Any disputes shall be resolved exclusively in the courts located in King County, Washington.
© 2026 Lillywhite Water Technology Solutions.
Release Notes
Stay up-to-date with the latest features, enhancements, and bug fixes for the R-THYM Digital Twin.
Version 1.051
Current Release
Improved
- Performance & Saving: Optimized project saving to make it faster and prevent server timeout errors, especially after running large simulation runs.
- Local Testing: Added more local automated E2E testing to improve application stability.
Version 1.050
Previous
Added
- Discrete Vapor Cavity Model (DVCM): Integrated the advanced DVCM physics solver to model column separation, vapor pocket formation, and collapse surge pressures during severe water hammer transients.
- Timestep & Telemetry Guardrails: Automatically recommends or enforces a smaller timestep ($dt \le 0.001\text{s}$) when DVCM is active to prevent numerical instability, and exposes three new WASM telemetry channels (cavity volume, active state, collapse count) per node.
- New Settings Menu Option: Introduced a new Simulation Settings option enabling users to switch between the default cavitation head-clamping model and the high-fidelity DVCM solver directly.
- Column Separation & Cavitation Plotting: Added a "Plot Vapor Cavity Volume" checkbox in the telemetry panel to plot dynamic vapor cavity volume on the secondary axis (supporting both upstream and downstream pockets for two-sided components) and draw dashed red vertical lines on Chart 1 labeled COLLAPSE to pinpoint water-column collapse events.
- High-Fidelity Cavitation Study Summary: Refined warning callouts and the study summary panel to support DVCM. Added a dedicated DVCM Analysis card for nodes experiencing cavitation, displaying maximum cavity volume (automatically formatted in user units) and the cumulative number of column collapses. When DVCM is active with a stable timestep, cavitation warnings are updated to a positive checkmark confirmation.
- Updated Valve Telemetry: Replaced the static headloss curve on the primary Valve telemetry chart with upstream and downstream pressure curves (right Y2-axis) for better pressure decay visualization, and added a secondary chart below to plot the valve opening setting percentage.
Version 1.018
Previous
Added
- Component & Property Table: Added a comprehensive, interactive table to view and edit all component parameters globally (accessed via the Data menu). Features include ID-based searching, global batch-editing, and direct CSV exporting.
- Bi-directional Value & Selection Sync: Changes made in the property table propagate instantly to canvas labels and active properties dialogs. Clicking the locate crosshair pans, zooms to 2.0x, and selects components directly on the canvas.
- Dynamic Scenario Integration: Edits made within custom scenarios are automatically stored as scenario-isolated overrides (highlighted with blue borders) rather than modifying the base model. The table dynamically refreshes its contents whenever you switch active scenarios.
Version 1.017
Previous
Added
- Component Output Labels on Canvas: Added real-time text displays directly on the canvas, showing pressure values at Junctions, and TDH (Total Dynamic Head) and flows at Pumps and Turbines.
- Speed Bar Indicators: Added dynamic speed bar graphics on pumps and turbines, visually representing current runner/rotational speed.
- Component ID & Output Toggles: Added new menu toggles under "Data" to show/hide component ID labels and real-time simulation outputs on the canvas for a cleaner modeling environment.
Version 1.016
Previous
Added
- Robustness & Form Validation Bounds: Enforced minimum input validation constraints on property forms (minimum diameters of 0.01 in, standpipe areas of 0.0001 ft², and pump/turbine design flow and head limits of 0.1) to guarantee numerical stability and eliminate division-by-zero exceptions in the simulation engine.
- Cavitation Warning Notification: Added a warning callout to the study summary to alert users when first-order head clamping occurs, recommending the Discrete Vapor Cavity Model (DVCM) for collapse surge analysis.
Improved
- Engine & UI Alignment: Cleaned up properties panels by removing the obsolete Check Valve damping field. Fully synchronized dynamic regulating states (Open, Closed, Regulating) for PRVs and PSVs to map directly from output time series data.
- Outage Restoration Restart: Decoupled physical electrical connectivity from commanded ON/OFF pump status on the client. Controlled pumps (PID, Threshold, Deadband) now successfully detect power restoration and reboot automatically using their configured VFD/soft-start ramp time.
Fixed
- Control Loop Outage Suppression: Updated the MOC solver to enforce power availability checks before executing control loop outputs or schedules. Active controllers can no longer override pump speeds to positive settings during blackouts.
Version 1.010
Previous
Added
- Rotational Inertia Integration: Enabled tracking of pump and turbine rotational inertia within the rthym-moc WASM solver, and fully connected the frontend simulation engine to exchange these dynamics.
- Compressible Air Valve Physics: Implemented the Ideal Gas Law relation and orifice venting rates, enabling the simulation of cushioned deceleration (small orifice) versus hard column rejoin slams (large orifice).
- Engineering Acceptance Checks: Integrated automated safety compliance checks into the study summary and report modals, validating transient pressures and cavitation duration against defined pipe design limits.
Improved
- Turbine & Pump Power Outage Modeling: Pumps now automatically trip and decelerate if any upstream power component (switch, grid, or generator) is disconnected. Turbines now accurately simulate electrical load rejection (disconnection from grid loads), triggering runner speed acceleration and runaway dynamics.
- Hydropneumatic Surge Tank Telemetry: Mapped dynamic physical parameters from the WASM solver, displaying real-time water and gas volumes, water level percentage, gas cushion pressure, and connection flow rates.
- Turbine Telemetry Panel: Updated telemetry readouts to display actual runner rotational speed and guide vane settings separately.
Version 1.000
Previous
Added
- Professional Tier Launch: Officially launched the stable 1.0 release, transitioning R-THYM out of beta.
Improved
- Stability & Polish: Applied final UI styling refinements, layout adjustments, and performance optimizations.
Version 0.672
Previous
Added
- Check Valves in MOC: Implemented full support for modeling dynamic check valve closures and reverse flow blocking behavior during transient MOC simulation runs.
- Telemetry Study Summary Tab: Introduced a dedicated Study Summary tab in the live telemetry panel to aggregate key transient results, showing simulation duration, step counts, peak/minimum pressures, and active cavitation warnings.
Version 0.555
Previous
Added
- Grid Customization: Added option to switch between grid lines or dots, or hide the grid entirely.
- Enhanced Zoom: Optimized default zoom scales and added sensible jump intervals in zoom dialog.
Version 0.554
Previous
Added
- WASM Solver Integration: Integrated with the open-source R-THYM MOC Solver engine to model rapid water hammer transients, surge pressures, and dynamic flow decays during pump trips and turbine shutdowns.
Version 0.553
Previous
Added
- Dark Mode Support with dark/light toggle in menu bar
Version 0.552
Previous
Added
- Grid Blackout & Backup Power: Added support for simulating grid outages and backup generator automatic transfer switch (ATS) switchover.
- Utility Grid: Introduced Initial Status (ON/OFF) configuration and interactive grid-status toggling on the canvas during active simulations.
- Power Generator: Enabled a Standby status with custom ATS Delay and Spool-Up times, permitting generators to automatically power on, spool up, and follow pump/battery loads during a blackout.
Improved
- Generator Dialog: Widened the properties dialog container and optimized the column layout grids to display Standby controls and inputs clearly without truncation.
Version 0.551
Previous
Added
- INP Exporter: Added explicit [OPTIONS] section with dynamic UNITS and HEADLOSS settings to the exported INP file for improved downstream tool portability.
Version 0.550
Previous
Added
- Air / Vacuum Valve (AVV): Added Air / Vacuum Valve (AVV) for surge protection.
- Pipe Telemetry: Added pipe minor loss coefficient and headloss to pipe telemetry.
- Surge Tank: Added surge tank telemetry.
Version 0.540
Previous
Improved
- Unit Conversion: Fixed MGD → GPM unit conversion bug that caused massively inflated steady-state flows and near-zero valve resistance in models using non-GPM display units.
Version 0.537
Previous
Added
- Junction Telemetry: Added total inflow and total outflow outputs to the live telemetry for Junction nodes, and updated charts to visualize total inflow and outflow.
Improved
- Junction Control Links: Control links targeting Junction nodes now monitor and regulate based on Pressure, resolving previous control oscillations.
Version 0.532
Previous
Improved
- Production Stability: Confirmed the fix for Variable Speed Pump initial speed and PID controller bias calibration on the live site.
Version 0.531
Previous
Improved
- Production Deployment: Synchronized application version across modules and finalized deployment for pump speed and PID bias improvements.
Version 0.530
Previous
Improved
- Pump Initial Speed & Bias Fix: Resolved issue where Variable Speed Pumps configured with an initial speed setting (e.g., 50%) incorrectly started at 100% speed. Dynamic bias calculation now correctly respects the pump's initial speed settings.
- Simulation State Management: Populated equipment properties on simulation start and corrected the reset snapshot restoration logic to properly map the pump speed `setting` property.
- Test Coverage: Extended the formal verification test suite to cover dynamic PID bias calculations and snapshot resetting.
Version 0.529
Previous
Improved
- PID Control Anti-Windup & State Reset: Resolved issue where adding a non-zero Ki factor to a PID control link caused the pump to fail to turn on and the tank to drain. Implemented conditional anti-windup clamping and cleared transient state variables upon simulation reset.
- Test Coverage: Added a formal unit and verification test suite for the PID controller to automatically test anti-windup limits and simulation level regulation.
Version 0.528
Previous
Improved
- PID Parameter Persistence: Resolved issue where PID parameters (Kp, Ki, Kd), control target values, and deadbands failed to persist when edited or created with values like 0 or 0.0
Version 0.525
Previous
Improved
- Logical Link-Direction Mapping: Replaced quadrant connection requirements for composite nodes (Pumps, Valves, and Turbines) with robust logical link-direction mapping to determine inlet/outlet connections automatically based on the drawn direction of the pipe.
Version 0.524
Previous
Added
- Model Export (JSON): Added support for exporting the entire model configuration as a JSON file.
Improved
- EPANET Composite Export: Improved the EPANET export to correctly convert valves, pumps, and turbines as composite 2-node and link systems.
Version 0.523
Previous
Improved
- Connection Prompts: Updated prompt banners when drawing new links for improved clarity.
- Properties Dialog: Added connecting nodes labels with functional roles to the control link properties dialog.
Version 0.522
Previous
Added
- Expanded Automation Support: Control links can now monitor junctions, inflow nodes, and outflow nodes, allowing tanks, batteries, and grids to operate pumps, turbines, valves, and switches.
Version 0.519
Previous
Improved
- Default Pipe Material: The default pipe material is now explicitly set to PVC instead of "Custom / None", providing explicit friction factor defaults for legacy projects.
Version 0.518
Previous
Improved
- MOC Export: Enhanced JSON metadata (closure timings) and CSV columns (mapped to physical upstream pipes) for C++ cross-engine compatibility.
Fixed
- UI Flow Tracking: Fixed a bug where MOC transient dashboard flows visually stuck at steady-state values.
- Transient Initialization: Fixed flow drops caused by UI state mismatches and Standpipe level persistence.
Version 0.515
Fixed
- TCV Valve State: Fixed an issue where legacy project files incorrectly loaded TCV valves as "Closed" even when an initial opening percentage was specified.
Version 0.514
Previous
Added
- Solar Realism: Added a new 'Mounting Type' property (Fixed, Optimal, Tracking) to Solar Generators, significantly improving the accuracy of modeled panel power generation.
Improved
- Exact Sunshine Data: Replaced generic orbital math approximations with localized, API-driven weather forecasting to ensure exact sunrise and sunset times based on the project's real-world latitude and longitude.
- Telemetry Tooltips: Added automatic time formatting to X-axis tooltips in the charts, translating raw simulation minutes into clear day/hour indicators.
Fixed
- Tank Reset Bug: Fixed a persistent issue where tanks would fail to reset to their initial level after a simulation run, and ensured user-defined initial states are safely preserved when saving projects mid-simulation.
- Location Persistence: Resolved an issue that prevented project Latitude and Longitude properties from correctly saving to the database.
Version 0.513
Previous
Added
- Surge Control Components: Added new Standpipe and Closed Surge Tank components to the digital twin canvas to assist in modeling and mitigating transient water hammer events.
Improved
- Valve Closure Options: Added support for Multi-Stage and Custom schedule valve closures to more accurately model actuator behaviors.
Version 0.510
May 2026
Added
- INP File Import: Added the ability to import EPANET .inp files directly into the R-THYM digital twin canvas.
- Detailed Summary Reports: Added comprehensive MOC and EPS summary reports. Both reports now allow exporting system metadata, cumulative metrics, the simulation warning log, and complete time-series output data directly to a downloadable JSON and CSV archive.
Version 0.509
Previous
Improved
- UI Enhancements: Refreshed the properties dialogs for a more consistent look and feel.
Version 0.508
Previous
Fixed
- Interactive Control Override: Resolved a bug where manually clicking a Valve, Pump, or Turbine to toggle its state was completely ignored during an active simulation. You can now seamlessly toggle component runtime status on the fly without interrupting the transient physics engine.
Version 0.507
Added
- Collapsible Telemetry Panel: Added a new toggle tab to smoothly collapse and dock the live telemetry panel on the right, providing an unobstructed view of the network canvas (automatically collapses on mobile devices).
- Pump Inrush Current Modeling: Simulate electrical inrush current during the pump startup phase to accurately reflect demand spikes on the microgrid.
- Battery Brownout Warnings: Added a new warning threshold that alerts you to potential microgrid brownout risks during rapid battery discharge events.
- User Manual Framework: Built out the foundation and structural framework for the upcoming comprehensive R-THYM User Manual (content is currently in progress!).
Fixed
- INP Export Output: Ensured that junction elevations are correctly written and preserved when exporting models to the standard INP file format.
Version 0.502
Added
- Dynamic Transient Solver: Introduced a Method of Characteristics (MOC) hydraulic engine. This allows you to simulate rapid transients, wave propagation, and surge pressures (water hammer) caused by rapid valve closures or pump trips.
- Surge Control Links: Added a new Pump-to-Valve control link logic specifically designed to model surge anticipation. You can now simulate a pump spinning down while simultaneously coordinating a surge relief valve closure.
- Pipe Materials Library: Added a customizable library (under the Data menu) to manage pipe materials. Selecting a material automatically populates friction factors and computes dynamic wave celerity based on the pipe's Young's Modulus and wall thickness.
Version 0.280
Fixed
- Tank Mass Balance: Corrected an issue where water tanks would fill or drain based on a naive percentage rather than their true volumetric capacity. Tank levels now accurately respect the specified diameter and height to provide realistic fill/drain times.
- Telemetry Charting: Updated the Utility Grid telemetry panel to explicitly show the cumulative cost of importing power, displayed directly alongside export revenue.
Version 0.279
Added
- Utility Grid Control: You can now attach Control Links directly to the Utility Grid. This allows you to automatically control Pumps, Valves, and Turbines based on real-time simulated Energy Price thresholds.
- Multi-Constraint Control: Equipment now supports Multiple Control Links! If a pump is connected to multiple monitoring points (e.g., a Tank and the Utility Grid), it uses a logical AND override (Multi-Input Single-Output) to ensure it only operates when ALL attached rules allow it.
Version 0.278
Changed
- Telemetry Charts: Upgraded the telemetry charts to use a fixed-time sliding window instead of a raw data point buffer, ensuring smoother animations and consistent time intervals across speeds.
- Chart Settings: You can now manually specify the X-axis time window length for your sliding charts via the new Edit → Chart Settings... menu.
Version 0.277
Added
- Hydropower Turbine: Added a new Turbine node to the toolbox. Turbines allow you to model hydropower generation and integrate that power back into the system, store it in batteries, or sell it to the utility grid.
Version 0.276
Added
- Canvas Documentation: Added a new Text Note tool that allows you to drop floating text boxes onto the canvas for documenting your models.
Changed
- Control Link Labels: Control link terminology is now dynamically updated to reflect power or water control based on the component being monitored.
Version 0.275
Added
- Renewable Grid Export: Excess power generated by solar (or other renewable generators) can now be dynamically exported directly back to the utility grid once all batteries reach 100% state of charge.
- Grid Telemetry: Utility Grid components can now be added to the output charts to view live power flow, energy imported, and energy exported over time.
Version 0.274
Changed
- Centralized Fuel Economics: Project-wide fuel costs are now managed globally and directly apply to Fuel Tanks instead of individual Power Generators.
Version 0.273
Added
- Fuel Modeling: Added a new Fuel Tank component and Fuel Link tool to enable connecting fuel storage to power generators for more comprehensive energy modeling.
Fixed
- Power Links: Resolved several interface bugs related to power link routing and connection management.
Version 0.272
Added
- Canvas Interaction: Added drag-and-drop support for re-routing existing connections. You can now grab the endpoints of Pipes, Power Links, and Control Links and snap them to new nodes on the canvas without having to redraw the links. You can also drag the ends around the node quadrants to fine-tune visual alignment.
Improved
- Node Connections: The connection zones for nodes are more accurately scaled, preventing accidental clicks on nodes when attempting to grab link grips.
Version 0.271
Added
- Electrical Modeling: Added a complete electrical grid solver with Solar Generators, Battery Energy Storage Systems, Utility Grid links, and CC/CV non-linear charging logic.
- Power Topologies: You can now connect components using the new Power Link tool to explicitly direct solar energy into batteries or the utility grid.
- Telemetry Hard Stops: Fast-forward and normal simulations now strictly halt at the user-defined simulation duration.
Improved
- System Telemetry: Added Peak Power and Peak Demand tracking to the System Overview and Utility Grid telemetry panels.
- Weather Interpolation: Implemented smooth linear interpolation of hourly local weather data from the Open-Meteo API forecast dataset, ensuring consistent chart rendering under changing simulation speeds.
Version 0.262
Added
- Dynamic Units: Added support for changing system units on the fly.
- Editable Start Time: The start time of day is now editable, making it easier to leverage diurnal patterns without running the entire day first.
- Ultra-Slow Simulation: The simulation speed slider now supports much slower run speeds (down to 0.1 sec/s) for highly detailed observation.
- Visual Upgrades: Improved the bright blue arrow visualization for active flow directions, making it larger and easier to see against varying pipe thicknesses.
Improved
- Simulation Stability: Rewrote the stochastic demand AR(1) logic to be time-step invariant, keeping system dynamics smooth across all simulation speeds.