Line Charts
Evaluate time series of the dynamic network simulation as line charts: add, filter and export plots for energy centers, consumers, pipes and pumps
VICUS Districts Page 2 of 4 in this chapter
Overview
The plots view displays the time series of the dynamic simulation as line charts. The plots are organized by the categories energy center, consumers, pipes and pumps. Every plot has a diagram type that defines the displayed quantity, and shows one curve per network element. Combined plots, in contrast, show several quantities of a single element, for example the supply and return temperature of a substation. The plots appear one below the other in the plot matrix next to the 3D scene. The energy balance of the network is shown in the overview.
Opening
Button Results in the main toolbar, then
Plots in the vertical toolbar to the right of the 3D scene. If the workspaces for buildings and networks are both active, the button is called Plots Networks. A completed simulation is a prerequisite; the result files are located in the folder
<projectname>/results/ next to the project file.
The status bar sits above all result pages:
| Element | Meaning |
|---|---|
| Network: | Selection of the active network. All result views show the results of this network, and the next simulation run uses it. The results of several networks are kept side by side. |
| Status message | Summary of simulation, project and data cache, e.g. Results up-to-date, Project changed since last run or Result files changed on disk |
| Re-reads all result files that changed on disk. Until then, the plots keep showing the data already loaded. | |
| Details | Expandable: status of Simulation:, Project: and Data cache: as well as the Result directory: with a button to open it in the file manager |
Managing Plots
On the left, the categories Energy center, Consumers, Pipes and Pumps are collapsible pages. Each page lists its plots in a table with visibility (light bulb), data status, Type and Description. A click on the light bulb shows or hides the plot in the matrix; selecting a row highlights the corresponding plot in the matrix.
| Element | Meaning |
|---|---|
| Create a new plot via the dialog Add network line plot | |
| Edit | Change name and element selection of the selected plot (dialog Edit network line plot). Combined plots and pump characteristic curves cannot be edited, only removed and added again. |
| Remove the selected plots | |
| Show / Hide | Make the selected plots visible or hide them |
| Filter plots by name… | Text filter for the plot table |
| Required output files | Expandable: the result files the selected plot reads, with a note whether they are present |
Above the categories there are two more elements:
- Show only diagrams of the active category restricts the plot matrix to the plots of the expanded category.
- Create default plots adds the missing default plots for the active network. If the option Generate default network-related outputs is switched off in the outputs, a note points out that the result files of these plots will be missing.
Default Plots
At the first simulation start of a network, VICUS Districts creates the default plots automatically – provided the default network-related outputs are active and no plots exist for the network yet. Only what the components of the network support is created:
| Category | Default plots |
|---|---|
| Energy center | Heating/cooling power (ideal), heating power, source power, COP and electrical power of the heat pump, source heat flux; one plot Supply/return temperatures (combined) per heat generator |
| Consumers | Heat flux, temperature difference, relative heat deficit; Pressure difference across consumer (total) only with a pump under index point control |
| Pipes | Heat loss (supply / return / all) |
| Pumps | Pressure head, electrical power; one Pump characteristic curve per pump component |
Adding a Plot
The dialog Add network line plot asks for three things:
| Field | Meaning |
|---|---|
| Diagram type: | The displayed quantity. Only types for which the network contains matching components are offered. |
| Name: | Proposed as diagram type - network name; with exactly one selected node, the node name is used instead of the network name. The name must be unique within the category. |
| Elements | All eligible elements or Current selection. The second option is only active when network nodes are selected in the scene, and is then preselected – this creates a plot for the selected consumers or generators only. |
For combined plots and the pump characteristic curve, you instead pick the consumers, heat generators or pump components from a list (with the filter Filter by name…). One plot is created for each selected entry.
Diagram Types per Category
All time series are plotted over the simulation time. The simulation writes powers and heat fluxes as mean values over the output interval.
Energy Center
| Diagram type | Unit |
|---|---|
| Source heat flux (heat input into the network) | kW |
| COP (heat pump) | – |
| Heating power (heat pump) | kW |
| Source power (heat pump) | kW |
| Electrical power (heat pump) | kW |
| Heating/cooling power (ideal) | kW |
| Ground temperature (with ground heat collectors) | °C |
| Inlet temperature / outlet temperature | °C |
| Volume flow rate | m³/h |
| Pressure drop | bar |
| Temperature difference | K |
| Supply/return temperatures (combined) – supply and return temperature of one heat generator | °C |
Consumers
| Diagram type | Unit |
|---|---|
| Heat flux | kW |
| Temperature difference between inlet and outlet | K |
| Relative heat deficit (0 = demand fully covered) | % |
| Absolute heat deficit | kW |
| Inlet temperature / outlet temperature | °C |
| Volume flow rate | m³/h |
| Heat exchanger pressure drop | bar |
| Pressure difference across consumer (total) – sum over all elements of the substation, i.e. the pressure difference an index point control sees | bar |
| For substations: secondary inlet and outlet temperature, secondary outlet temperature setpoint (°C), heat flux required by building (kW), valve base pressure drop and valve controlled pressure drop (bar) | |
| For decentralized heat pumps: COP (–), electrical power, heating power, source power (kW) | |
| Supply/return temperatures (combined) – supply and return temperature of one consumer | °C |
| Substation temperatures (combined) – inlet and outlet temperatures on the primary and secondary side including setpoint | °C |
| Substation heat fluxes (combined) – heat flux required by the building and delivered by the substation | kW |
In practice
Whether your network reliably supplies every consumer is most quickly seen from the relative heat deficit: 0 % means full coverage, higher values indicate undersupply. Select the affected consumer in the scene and add the plots Substation heat fluxes (combined) and Substation temperatures (combined) for it. There you compare requested with delivered heat flux, as well as the secondary-side temperature against the setpoint. This tells you whether too low a supply temperature or a hydraulic bottleneck is the cause.
Pipes
| Diagram type | Unit | Curves |
|---|---|---|
| Heat loss (supply / return / all) – sum over all pipe segments; negative values = heat gains | kW | Supply pipes, Return pipes, All pipes |
Pumps
| Diagram type | Unit |
|---|---|
| Electrical power | W |
| Pressure head | bar |
| Volume flow rate | m³/h |
| Pump efficiency | % |
| Volume flow rate limit exceedance (for controlled pumps) | m³/h |
| Pump characteristic curve | pressure head [bar] over volume flow rate [m³/h] |
The Pump characteristic curve plots the operating points of the simulation for all pumps of one pump component as a point cloud in the map. If operating limits are stored, the permissible operating range is drawn as an area; it is scaled by the number of parallel pumps of the component. The outputs PressureHead and FluidVolumeFlow are a prerequisite.

Plot Matrix
By default, the plots are stacked in a single column. Above the matrix you find:
| Element | Default | Meaning |
|---|---|---|
| Stack plots in a single column | on | Off: the plots are arranged automatically in a grid |
| Sync x-axis zoom across plots | off | Zooming in one plot, or undoing the zoom, applies the same time range to all other plots |
| Undock | – | Detaches the whole matrix as a separate window Result diagrams, e.g. for a second screen; closing the window docks it back |
The plots are only loaded and drawn when the plots view is opened.
Legend and Selection in the Scene
Every plot has a legend with line color, light bulb and name:
- A click on the light bulb shows or hides the line; a double-click shows only this line, another double-click shows all lines again.
or a click on a line in the plot selects the associated object in the scene.
- The field Filter lines by name… hides all lines whose name does not contain the text.
- If network nodes are selected in the scene, their lines are highlighted (thicker, in the foreground) and the other lines are drawn in grey.
The plot clicked last colors the scene: the nodes of its lines appear in the line color, all others in grey. Hidden lines, or lines removed by the filter, leave their nodes grey.
Tools per Plot
| Button | Function |
|---|---|
| Export the plot as an image: dialog Export chart with Show title and Show legend, format Bitmap or Vector graphics, output via Copy to clipboard or Export to file… | |
| Copy the plot data as a tab-separated table to the clipboard – ready to paste into Excel. If a range is selected in the table view, only that range is copied (always including the time column). | |
| Diagram / data table | Toggles between plot and table view. The table shows the values in the display units of the plot. |
| Undock | Detaches the single plot as a free-floating window |
| Hide the plot |
You zoom into any plot by dragging a rectangle with the left mouse button. A right-click undoes one zoom level, Ctrl + right-click shows the full range again.