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.

Line charts of the time series of a network simulation (heating power, temperature difference)
Line charts of the time series – here heating power and temperature difference of the consumers over the simulation time

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:

ElementMeaning
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 messageSummary of simulation, project and data cache, e.g. Results up-to-date, Project changed since last run or Result files changed on disk
Reload resultsRe-reads all result files that changed on disk. Until then, the plots keep showing the data already loaded.
DetailsExpandable: 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.

ElementMeaning
Create a new plot via the dialog Add network line plot
EditChange 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 / HideMake the selected plots visible or hide them
Filter plots by name…Text filter for the plot table
Required output filesExpandable: 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:

CategoryDefault plots
Energy centerHeating/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
ConsumersHeat flux, temperature difference, relative heat deficit; Pressure difference across consumer (total) only with a pump under index point control
PipesHeat loss (supply / return / all)
PumpsPressure head, electrical power; one Pump characteristic curve per pump component

Adding a Plot

The dialog Add network line plot asks for three things:

FieldMeaning
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.
ElementsAll 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 typeUnit
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 ratem³/h
Pressure dropbar
Temperature differenceK
Supply/return temperatures (combined) – supply and return temperature of one heat generator°C

Consumers

Diagram typeUnit
Heat fluxkW
Temperature difference between inlet and outletK
Relative heat deficit (0 = demand fully covered)%
Absolute heat deficitkW
Inlet temperature / outlet temperature°C
Volume flow ratem³/h
Heat exchanger pressure dropbar
Pressure difference across consumer (total) – sum over all elements of the substation, i.e. the pressure difference an index point control seesbar
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 substationkW

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 typeUnitCurves
Heat loss (supply / return / all) – sum over all pipe segments; negative values = heat gainskWSupply pipes, Return pipes, All pipes

Pumps

Diagram typeUnit
Electrical powerW
Pressure headbar
Volume flow ratem³/h
Pump efficiency%
Volume flow rate limit exceedance (for controlled pumps)m³/h
Pump characteristic curvepressure 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.

Pump characteristic curve with operating points in the map of pressure head over volume flow
Pump characteristic curve with operating points from the simulation

Plot Matrix

By default, the plots are stacked in a single column. Above the matrix you find:

ElementDefaultMeaning
Stack plots in a single columnonOff: the plots are arranged automatically in a grid
Sync x-axis zoom across plotsoffZooming 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

ButtonFunction
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 tableToggles between plot and table view. The table shows the values in the display units of the plot.
UndockDetaches 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.

Stay up to date

New features, tutorials and updates delivered to your inbox.