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
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
Add New Metric
Canvas Properties
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
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
Chart Settings
MOC Summary Report
Peak Pressures tracked at native 10ms resolution during transient mode.
| Node ID | Min Pressure (psi) | Max Pressure (psi) |
|---|
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
R-THYM
Version 0.518 (beta)
A real-time hydraulic digital twin.
Designed and developed by Jason Lillywhite.
Open Source & Commercial Libraries
R-THYM utilizes the following third-party libraries and APIs to deliver robust simulation capabilities:
End User License Agreement (EULA)
Last Updated: May 18, 2026
1. ACCEPTANCE OF TERMS
By accessing or using R-THYM (the "Software"), provided by Lillywhite Water Solutions LLC ("LWS", "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. EDUCATIONAL USE & NO PROFESSIONAL-CLIENT RELATIONSHIP
The calculators, models, cloud-hosted engines, and interactive tools provided are for conceptual, educational, and informational purposes only. Use of these tools does not constitute a Professional Engineering relationship, nor does it establish an attorney-client or 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
LWS provides cloud-based digital twins and calculators "as is" and without warranties of any kind, whether express or implied. LWS 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 LWS's aggregate liability exceed the total fees actually paid by you to LWS 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 LWS remain the exclusive intellectual property of LWS. 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 LWS.
Release Notes
Stay up-to-date with the latest features, enhancements, and bug fixes for the R-THYM Digital Twin.
Version 0.518
Current Release- MOC Export: Enhanced JSON metadata (closure timings) and CSV columns (mapped to physical upstream pipes) for C++ cross-engine compatibility.
- 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
- 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- Solar Realism: Added a new 'Mounting Type' property (Fixed, Optimal, Tracking) to Solar Generators, significantly improving the accuracy of modeled panel power generation.
- 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.
- 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- 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.
- Valve Closure Options: Added support for Multi-Stage and Custom schedule valve closures to more accurately model actuator behaviors.
Version 0.510
May 2026- 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- UI Enhancements: Refreshed the properties dialogs for a more consistent look and feel.
Version 0.508
Previous- 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
- 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!).
- INP Export Output: Ensured that junction elevations are correctly written and preserved when exporting models to the standard INP file format.
Version 0.502
- 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
- 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
- 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
- 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
- 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
- Canvas Documentation: Added a new Text Note tool that allows you to drop floating text boxes onto the canvas for documenting your models.
- 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
- 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
- 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
- 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.
- Power Links: Resolved several interface bugs related to power link routing and connection management.
Version 0.272
- 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.
- 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
- 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.
- 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
- 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.
- Simulation Stability: Rewrote the stochastic demand AR(1) logic to be time-step invariant, keeping system dynamics smooth across all simulation speeds.