Evaluation and Export
Evaluate the energy balance of the network simulation in the overview, export tables and charts, and process results externally
VICUS Districts Page 3 of 4 in this chapter
Overview
The overview balances the dynamic network simulation of the active network over a freely selectable evaluation period: the heat supplied by the energy centers, the heat losses of the pipe network split into supply and return, and the electricity demand of heat pumps and circulation pumps. Tables and plots can be copied to the clipboard or exported as an image; for more detailed evaluations, the external PostProc application as well as the DXF and GIS export are available.
Opening
Button Results in the main toolbar, then Overview in the vertical toolbar to the right of the 3D scene (with the workspaces for buildings and networks both active: Overview Networks). In the Districts perspective, the results view opens directly on this page. Result files in the folder
<projectname>/results/ next to the project file are a prerequisite.
The evaluation always covers the active network. You choose it in the status bar above the page under Network:; there, Reload results also re-reads changed result files (see Line charts).

Evaluation Period
| Field | Default | Meaning |
|---|---|---|
| Evaluation start: | Start of the last full year of the simulation period | First day of the evaluation |
| Evaluation end (inclusive): | Last day of the simulation period | Last day of the evaluation, this day included |
| Simulated time range: | – | Period covered by the available results (display only) |
The default follows the simulation period planned in the simulation settings, not the time simulated so far – so the period stays stable even while a simulation is running. If the simulation period is shorter than one year, it is evaluated in full. Your own choice is kept until the simulation period changes. If the results do not fully cover the evaluation period, the note The results only cover … of the evaluation period. appears.
All energy amounts are integrals of the power time series over the evaluation period and are given in MWh.
Energy Balance
The overview is divided into three sections. Each section additionally shows the shares as a colored bar; sections without rows are left out. An energy center for which no results are available stays in the table with dashes.
| Section | Rows | Columns |
|---|---|---|
| Heat sources | one per energy center, with several also Total | Supplied heat (MWh), Share (%), Peak load (kW, from 10 MW in MW) |
| Heat losses | Supply pipes, Return pipes, Total | Losses (MWh), Relative losses (%), Per route length (kWh/m) |
| Electricity | Group Heat pumps: one per energy center with a heat pump, and all decentralized heat pumps together (At n consumers). Group Circulation pumps: one per energy center, all decentralized pumps together and every pump in the pipe network individually. Plus Total. | Electricity (MWh), Share (%), plus Seasonal COP for the heat pumps or Efficiency (%) for the circulation pumps |
Notes on the balancing:
- The relative losses are related to the heat fed into the network, i.e. the sum of the heat supplied by all energy centers. The shares of supply and return add up to the relative loss of the whole network.
- For cold networks with heat input from the ground, the section is called Heat gains with the columns Gains and Relative gains. The relative gains are related to the heat drawn from the network, because the heat fed into a cold network can approach zero over the year.
- The seasonal COP is the quotient of the heat delivered by the heat pump and its electricity demand, the efficiency of a pump the quotient of hydraulic work and electricity demand, both over the evaluation period.
- If the results do not provide separate supply and return losses, the heat loss section shows a single row Pipe network.
Practical tip
The relative losses are your quickest plausibility check for the network design: a conspicuously high share points to oversized routes, too small a temperature spread, or too low a demand density. The split into supply and return shows where the losses arise. Balance a full annual cycle for this. For a network that has not yet settled, simulate more than one year – the default evaluates only the last full year anyway.
Copying the Table
The button Copy data as table copies the complete overview tab-separated to the clipboard – for pasting directly into Excel or a report. Values for which no results are available appear as a dash.
Exporting Plot Data and Images
Each plot of the line-chart view offers its own tools:
| Button | Function |
|---|---|
| Copy the time-series data as a tab-separated table to the clipboard, ready for use in Excel or Python. The values are given in the display units of the plot. | |
| Export the plot as Bitmap or Vector graphics to a file or copy to clipboard |
External Evaluation with PostProc
Menu Tools › External Results… (also available as a button in the main toolbar) opens the PostProc application with an automatically generated session file that references the project’s result files. If a session file already exists, VICUS Districts asks whether it should be overwritten. The path to the PostProc application is stored in the program settings.
The result files themselves are located in the folder <projectname>/results/ – one file per quantity following the pattern <networkname>-<network ID>.<quantity>.tsv (text format) or .btf (binary format, depending on the project’s output setting, see Defining outputs). Powers and heat fluxes are written as mean values over the output interval and carry the suffix -mean in the quantity name; the name of the output grid may follow. Thanks to the network ID in the file name, the results of several networks are kept side by side. The files can also be processed further with your own tools.
Exporting Results into Plans
Results of the steady-state calculation can be transferred directly into planning documents:
- DXF export: labeling of the network plan with result quantities such as volume flow, pressure loss or heat loss per operating point.
- GIS export: result values of the selected operating point as attribute data of the pipe and consumer objects.
For complete, print-ready documentation of the steady-state calculation and the dynamic simulation, use the network report.