User Interface (UI) Overview

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 drawing workspace itself — pan and zoom, dropping nodes, drawing links, canvas charts, and the Weather HUD — is on The Canvas.

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.

Drag a node from this toolbar onto the canvas to place it. Click a link tool (Pipe, Power Link, Fuel Link, or Control Link), then click two nodes to connect them. The full placement workflow is on The Canvas.

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.

Collapsing the Panel

You can collapse and expand the panel by clicking on the center tab as shown below.

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 events even after they have resolved.


[!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.