Getting Started with R-THYM

What is R-THYM?

Welcome to R-THYM (Real-Time Hydraulic Model), a next-generation Digital Twin designed to simulate water infrastructure and energy management within a single, unified environment.

R-THYM is an interactive and realistic design aid built on the principle that power and hydraulics are inextricably interlinked.

While it is entirely possible to model hydraulics in isolation, understanding the true cost implications of a design is what ultimately drives engineering and operational decisions. Power consumption is often the largest operational cost driver in water infrastructure. R-THYM models this interaction in detail so that designers of systems of all sizes can analyze energy expenditures, evaluate renewable integration, and make informed financial decisions using the tool's components.

By bringing these traditionally isolated worlds together, R-THYM allows you to optimize your system's energy footprint and then instantly pressure-test those operations against high-fidelity hydraulic transients.

To understand how R-THYM achieves this, it is helpful to look at its three fundamental modeling pillars:

  • Water-Energy Nexus
  • Extended Period Simulation (EPS)
  • Method of Characteristics (MOC)

The Water-Energy Nexus

Water distribution is incredibly energy-intensive. R-THYM goes beyond simple pump efficiency curves by integrating a full-scale energy microgrid into your hydraulic model.

R-THYM allows you to drag-and-drop power generation and storage nodes directly onto your canvas, including:

  • Utility Grids with dynamic, time-of-use (diurnal) pricing patterns
  • Renewable Energy sources like Solar Arrays and Wind Turbines.
  • Hydropower Turbines that generate electricity from excess system head.
  • Fuel Generators (Diesel, Natural Gas, Biogas) linked to fuel storage tanks.
  • Power Switches that allow you to sever downstream control and flow, instantly simulating grid failures or rolling blackouts.

By pulling live weather forecasts for your site location, R-THYM accurately predicts solar irradiance and wind speeds to forecast renewable generation. You can use these insights to shift your heavy pumping operations to times when renewable energy is peaking or when utility grid prices are at their lowest—dramatically reducing your operational costs and carbon emissions.

Extended Period Simulation (EPS)

Extended Period Simulation (EPS) is the industry standard for modeling the continuous operations of a water distribution network. In R-THYM, the EPS engine is optimized for high-resolution, daily operational cycles, allowing you to analyze diurnal demand patterns, tank cycling, and energy pricing fluctuations over a 24- to 48-hour window.

Powered by the robust, time-tested EPANET calculation engine, EPS assumes that water is an incompressible fluid, calculating a stable, steady state at each sequential time step. Unlike traditional EPS software that often limits you to rigid 1-hour intervals, R-THYM features a dynamic simulation speed slider with high-resolution time steps. You can slow the simulation down to an exact real-time pace (1 sec/s) to carefully monitor filling operations, or accelerate it to watch a full 24-hour cycle unfold in seconds.

When to use EPS:

  • Operational Planning: Tracking reservoir levels and energy usage over a continuous 24-hour cycle.
  • Economic Optimization: Running simulations to find the most cost-effective times to fill tanks based on dynamic utility pricing and renewable energy availability.
  • General Hydraulics: Verifying that pipe diameters and pump curves can safely meet peak consumer demands under normal conditions.
  • Interactive System Design: Uniquely in R-THYM, the EPS environment acts as a live, interactive design aid. While the simulation is running, you can manually toggle pumps and turbines, open and close valves, switch power sources, or smoothly ramp variable speed drives. This real-time interaction lets you "fly" your system and visualize the direct impact of operational decisions, revealing insights that static, traditional modeling often misses.

EPS is computationally lightweight and perfect for understanding the operational "big picture" of how your system behaves throughout the day. It excels at modeling the steady, macro-level movement of water to help you optimize standard operations. However, to analyze the rapid, split-second pressure waves that occur the exact moment you interact with the system. such as tripping a pump or rapidly closing a valve. R-THYM shifts from this steady-state view into the high-speed physics of our third pillar: the Method of Characteristics (MOC).

Method of Characteristics (MOC)

When a valve slams shut or a pump suddenly loses power, the water in the pipe compresses. The kinetic energy of the moving water is converted into a high-pressure shockwave (water hammer) that travels through the pipe at the speed of sound.

To simulate these extreme events, R-THYM engages its custom, browser-native Method of Characteristics (MOC) transient engine.

Because transparency and scientific accuracy are critical in hydraulic modeling, our core MOC solver is open-source. This ensures that the engine is never a "black box," allowing engineers, researchers, and students to review the underlying physics, verify the numerical methods, and independently validate their surge results.

MOC is a numerical method that treats water as a compressible fluid and accounts for the elasticity of the pipe walls. Instead of advancing the simulation in hours or minutes, the MOC engine tracks physics frame-by-frame, calculating the changing pressures and velocities every 10 milliseconds.

Features of the R-THYM MOC Engine:

  • Real-Time Execution: The MOC engine solves complex characteristic equations at 60 frames per second directly in your browser. Because it utilizes dedicated background processing, your interface remains completely smooth and responsive, even during heavy physics calculations.
  • Acoustic Tracking: Accurately models the propagation, reflection, and super-positioning of acoustic pressure waves.
  • Unsteady Friction (USF): Utilizes an Infinite Impulse Response (IIR) filter to model frequency-dependent boundary layer shear stress, ensuring that wave decay and physical damping match real-world transducer data.
  • Surge Protection Design: Allows you to test the effectiveness of relief valves, surge tanks, and PID control schemes under emergency scenarios.

The Best of All Worlds

The true power of R-THYM lies in its interconnected nature. You don't need to rebuild your model in a separate software package to test for transients, nor do you need to export your pump flows to a spreadsheet to calculate your power bill.

You can run an EPS simulation to optimize your pumping schedule around weather forecasts and diurnal energy rates. Then, at the exact moment a critical flow state is reached, you can engage the dynamic MOC mode. R-THYM automatically passes the steady-state velocities and pressures directly into the MOC engine, allowing you to instantly trigger a valve closure or a catastrophic grid-power failure and watch the transient physics unfold in real time.

R-THYM gives you the macro-level insight to plan your operations economically, and the micro-level physics to protect your infrastructure.

Next Building Your First Model