Panels and Toolbars

While subsequent chapters will dive deeply into the specifics of building and analyzing your models, it is helpful to first establish a spatial orientation of the R-THYM digital twin interface. This chapter provides a high-level overview of the primary panels and toolbars you will use to interact with your system.

The Component Toolbar (Left)

Located along the left edge of the screen, the Component Toolbar is your primary palette for building hydraulic and energy models. It contains all the available physical components (such as Junctions, Tanks, Pumps, Batteries, and Solar Arrays) required to construct your digital twin.

To add a component to your project, simply click its icon in the toolbar, and then click anywhere on the canvas to place it. As your model grows, you will frequently return to this toolbar to expand your infrastructure.

The Telemetry Panel (Right)

The Telemetry Panel, located on the right side of the interface, is the main dashboard for viewing live simulation results, historical charts, and critical system warnings. Its contents dynamically change depending on what you have selected on the canvas.

Component Telemetry

When you left-click on any specific component (e.g., a Pump or a Junction), the Telemetry Panel updates to display its unique data:

• Header: The top section displays the component's name, type, and its most critical real-time outputs (such as Flow, Head, or Power).
• Charts: Below the main outputs, you will find one or more live charts tracking the component's performance over time. Complex components may display multiple charts (for example, a pump might show both hydraulic flow and electrical power draw).
• Component Warnings: At the bottom of the panel, any active warnings specifically related to the selected component (such as cavitation or low pressure) will be displayed.

System-Wide Telemetry

If you left-click anywhere on the blank canvas (deselecting all components), the Telemetry Panel switches to a System-Wide Overview:

• Summary Results: Displays high-level aggregated metrics for the entire project, such as total system demand or total energy consumption.
• Active Warnings: Highlights all currently active warnings across the entire network, ensuring you never miss a critical failure.
• Warning Log: A historical log of all warnings that have occurred during the current simulation run, allowing you to trace past transient events even after they have resolved.

The Weather HUD (Top Right)

In the top right corner of the canvas sits the Weather HUD (Heads-Up Display). This compact overlay provides at-a-glance atmospheric conditions that influence the energy physics of your model (such as solar radiation and temperature).

• Weather Telemetry: Clicking on the Weather HUD will populate the right-side Telemetry Panel with comprehensive atmospheric data, including Temperature, Solar Radiation, Wind Speed, Cloud Cover, and Precipitation.
• Cloudiness Override: Within this panel, you also have the ability to impose a manual "Cloudiness Override." This powerful feature allows you to simulate sudden cloud cover to test how your solar power generation and battery storage systems respond to a sudden drop in solar irradiance.

[!NOTE] This overview provides a basic map of the interface. In the upcoming "Building Your First Model" and "Running Simulations" categories, we will cover exactly how to configure these components and interpret the telemetry data in depth.