Network Report

Generate the network report as PDF or ODT: choose chapters, document the pressure check of the whole network and the pressure profiles per energy center

VICUS Districts Page 4 of 4 in this chapter

Overview

The network report brings the network description, the diversity, the bill of materials, the steady-state calculation and the dynamic simulation of the active network together into one continuous document — with title page, table of contents, project data, page header and page footer, plus an appendix. It is written either as PDF or as an editable Word (ODT) document that is paginated like the PDF on A4 pages with header and footer. Chapters for which the network has nothing to report are left out automatically.

The network plans of the report carry a north arrow and show the OpenStreetMap or GIS background of the scene in pale colors, so that the pipes stay readable. In the power plans, consumers are colored and sized by their power.

In the chapter Steady state calculation, the report checks the pressures of the whole network for every printed operating point against two limits: the nominal pressure rating of each individual pipe and the minimum operating pressure. Each limit receives a spelled-out verdict with a color swatch; a network plan shows every pipe in green or red. This makes the network report the place where that check is recorded ready for documentation; while you are working, the same check is shown on the Pressure check page of the steady-state calculation. In addition, the report contains the pressure profile from every energy center to the index point.

Opening

Menu Reports › Network report…

The menu entry is only visible in the Districts perspective and stays disabled as long as no network is active. The report always covers the active network; its name is shown at the top left of the dialog next to Network:.

The Network Report dialog is split in two: the configuration on the left, with one collapsible page per chapter, and the page preview on the right. The preview does not follow your changes by itself — building the document renders every network image again and takes correspondingly long. Trigger it with Update preview once you are done configuring. Use the format selection and Export… to write the document to a file. With no network active, the right-hand side shows the note No network is active. The report covers the active network, so there is nothing to preview. instead of the preview.

Choosing the Chapters

Every page of the configuration carries a check box Print this chapter in its header. It switches the chapter off entirely without losing its settings — the page stays visible and is only greyed out.

ChapterContentSettings
Network descriptionNetwork extent, consumers and substations, energy centers, plants inside the pipe networkConsumer table: Summary / Individual list, Evaluation of the connection powers, Evaluation of the heating powers
DiversityDiversity reached in the networknone
Bill of materialsPipe types with installed lengths, fittings, fluid contentPipe type plan, Table type: Summary / Individual list, Fitting details, Show partitions separately with a selection list
Steady state calculationKey figures, pressure check, pressure profiles and pipe utilization per operating point, false-color maps, pump sizingsee Settings of the Steady-State Chapter
Dynamic simulationAnnual evaluation of the simulation: heat sources, heat losses and electricity demand with assessment, time-series charts, pump operationsee Settings of the Dynamic Simulation Chapter
Appendix: description of the softwareDescription of the calculation methods usednone

The two evaluations of the network description each show a histogram of the connection powers or of the maximum heating powers, and a network plan in which the consumers are colored and sized by that power.

If the network has nothing to report for a chapter, its switch is greyed out and the chapter is not printed; the tooltip states the reason. This applies to Diversity (the network does not consider the diversity), Steady state calculation (no steady-state results) and Dynamic simulation (no simulation results). The stored setting is kept, so the chapter returns as soon as results are available.

Title page and Table of contents cannot be switched off — they are always printed and therefore have no page of their own in the configuration. Always present as well is the page General Settings above the chapters: Report date:, Project information: (opens the project information editor), the two document colors Dark colour, headings: and Light colour, rules: with Reset colours to defaults, and the option Automatically turn network plans to fit the page. The Company logo from the project information appears on the title page and at the right of the page header; without it, the page header shows the VICUS logo.

The button Reset report settings to default puts all options back in one step: the printed chapters, their settings, the document colors and the date settings. The network being reported on is not affected.

Appendix

The appendix consists of up to three parts:

PartContentPrinted
Detailed network descriptionAssumptions of the pipe dimensioning, fluid properties with a plot of the kinematic viscosity, heating curves of the consumers (also those given as a time series, then plotted over the year), boundary conditions of the pipes with the Map of the pipe boundary conditionswith the chapter Network description
Tabular evaluation of the pressure profilesper printed operating point and energy center, a table of the plant elements, pipes and fittings along the route to the index point: temperature, pressure loss, operating pressure at inlet and outlet, length, pressure gradient, flow velocity, sum of the loss coefficients, geodetic height at the outletwith the option Pressure profile(s)
Description of the softwareCalculation methodswith the chapter Appendix: description of the software

Settings of the Steady-State Chapter

FieldDefaultMeaning
Index point:autoTransfer station reported in the key figures table and used as the target of the pressure profiles. Left empty, it is determined automatically from the lowest — or, with decentral pumps, highest — pressure difference of every operating point. Auto resets a selection.
Detailed pipe network informationonPrints the sections Pipe network and Height differences per operating point: heat losses, the hydraulic extremes together with the pipe that carries them, and the geodetic heights. Energy centers and index point are printed either way.
Pressure checkonPrints the pressure check of the whole network for every operating point: the highest and the lowest pressure found anywhere in it, each with the limit it is checked against, see The Pressure Check Section.
Pressure profile(s)onPrints the pressure profile from every energy center to the index point with operating pressure, pressure loss line and geodetic height, plus a plan of the routes and the route tables in the appendix.
Pipe utilizationonHistogram that splits the route length over the utilization of the pipes, with the matching network plan.
Pump sizingonTable of the installed pumps and, per pump, a diagram of its operating area together with the plant curves of all printed operating points.
Operating points:the one selected in the steady-state calculationSelection list of the calculated operating points. Points without results carry the addition (no results) and cannot be selected.
False color maps:Supply operating pressure, Pressure gradientMaps printed as a full-page plan for each printed operating point: Supply operating pressure, Supply pressure without the geodetic component, Return operating pressure, Return pressure without the geodetic component, Flow velocity, Volume flow, Mass flow, Pressure gradient, Supply temperature, Return temperature, Heat loss per pipe length

All fields of this page stay locked as long as no steady-state results are available; the note No steady state results are available. Run the steady state calculation first. is then shown above them.

Every setting of the dialog is stored in the project and can be undone individually (undo action Network report configuration modified). The settings only change how the report is presented and invalidate neither simulation nor calculation results.

Minimum Pressure Margin

The margin that forms the checked minimum operating pressure together with the vapour pressure is not a report setting but a property of the network. You will find it under menu Network › General settings …, in the group General settings:

FieldDefaultRangeMeaning
Minimum pressure margin1.5 bar0 to 100 barMargin added to the vapour pressure at the hottest point of the network; the two together form the minimum operating pressure the pressures of the network are checked against

The default of 1.5 bar is made up of 0.5 bar against evaporation and cavitation — on which there is broad professional consensus — plus around 1.0 bar for the control tolerance of the pressure maintenance and for transients; the second part is a planning recommendation and not a standard. The value applies to the whole network and takes effect equally in the report and on the Pressure check page of the steady-state calculation. It is stored with the project; the change is available as the undo action Modified default network settings.

Settings of the Dynamic Simulation Chapter

FieldDefaultMeaning
Evaluate from: / Evaluate until:last full year of the simulation periodFirst and last day (inclusive) of the period over which the annual results are integrated – the same default as in the overview of the results view
Result plots:Supplied power (daily means), Heat losses (daily means), Supply and return temperature (daily means)Time-series charts of the chapter: Supplied power as hourly, daily or monthly means and as a duration curve, Heat losses as daily or monthly means, Supply and return temperature of the energy centers and Consumer temperature difference, each as hourly or daily means
Evaluation of pump operationonOne diagram per pump: its characteristic curve with the operating points of the dynamic simulation, colored by the pump efficiency

The chapter also contains the sections Heat sources, Heat losses and Electricity demand with the same figures as the overview, each with an assessment against reference values:

QuantityReferencegoodmoderatepoorcritical
Relative heat lossesheat fed into the networkup to 10 %up to 15 %up to 25 %above
Electricity of the circulation pumpsheat fed into the networkup to 0.5 %up to 1 %up to 2 %above

For cold networks that gain heat from the ground, the assessment is left out: the gains are related to the heat drawn from the network, and the pump electricity share is stated without a class, because a cold network moves much more water for the same heat.

The Pressure Check Section

In the chapter Steady state calculation, every printed operating point receives its own block Results at <operating point>. Right after the key figures follows the section Pressure check. It checks the pressures of the whole network, supply and return, at all pipe ends; both limits are gauge pressures including the geodetic component, so they are checked against the pressure that actually stands in the pipes. The same check is shown on the Pressure check page of the steady-state calculation.

The table has the columns Quantity, Value, Limit and Result. Below each quantity, the report states where the value occurs (pipe, supply or return, node):

QuantityLimitResult
Highest operating pressure≤ nominal pressure rating of the pipe in which it occurs, reported as PN ncomplied with or exceeded by X bar
Highest pressure relative to its own pipe rating≤ nominal pressure rating of that pipeexceeded by X bar – only printed if a pipe other than the one with the highest pressure exceeds its own rating, e.g. a PN 10 stub on a main line at a higher pressure
Lowest operating pressure≥ min. operating pressure: vapour pressure at the hottest point of the network plus the Minimum pressure margin, less the ambient pressurecomplied with or undercut by X bar

The verdict is written out as text with a colored swatch in front of it — green for a limit that holds, red for one that is missed. Below the table, a note in small print states where the limits come from: Every pipe is checked against its own nominal pressure., with mixed ratings The network is built from pipes of PN a to b., and for the lower limit the vapour pressure at the temperature of the hottest point of the network, the margin and the subtracted ambient pressure with the altitude it follows from (see Pressure Calculation in the Network). Below that, a network plan draws every pipe green where it keeps the limits and red where it misses one of them.

Why a minimum pressure above the vapour pressure is needed at all, which magnitudes are common in technical connection requirements and how the margin is derived is covered in detail under meeting operating pressure limits in heat networks.

The Pressure Profile Section

After the pressure check, each energy center contributes a section Pressure profile between <energy center> and the index point. Two generation sites therefore produce two sections per operating point — the profile of one says nothing about the other. The profiles document the pressure along one route; the limits are checked for the whole network by the pressure check section.

The path drawn is always the same: from the energy center through the supply pipes to the index point and back through the return pipes. If the index point is tapped into the supply pipe and is fed and drained through the same stub, the return curve ends where that stub meets the network; the report notes this below the section description.

Three diagrams over the Route length [m]:

DiagramUnitWhat it says
Operating pressurebarThe pressure that actually stands in the pipes: the gauge pressure including the geodetic component.
Pressure loss linebarThe same path without the geodetic component, that is the pressure lost along the way. The steepness of the curves shows in which sections much pressure is lost.
Geodetic heightmThe height profile of the route, lifted by the z-height of the project origin so that it shows the same absolute heights as the table Height differences

The two pressure diagrams carry four curves: the energy center, Supply pipe, the transfer station named as the index point and Return pipe. Below the diagrams stands a table with the end points and the pressure balance of the loop: Energy center, Index point, Route length to the index point, Pressure loss of the supply pipe and Pressure loss of the return pipe, and, where decentral plants sit inline in a line, additionally the Pressure head of the decentral plants in the supply and in the return pipe. After the profiles of all energy centers, a network plan shows the Routes to the index point; the elements of every route are listed in tables in the appendix.

Limits of the Check

The pressure check is no substitute for sizing the pressure maintenance. What it does and what it does not do:

  • Only pipes carry a nominal pressure rating. Valves, fittings and plant components have no PN in the databases; they are left out of the upper limit. If the pipe carrying the highest pressure has no nominal pressure of its own, it is checked against the lowest one of the network. If no pipe of the network carries a nominal pressure rating, the row Highest operating pressure is omitted entirely — a check is then missing rather than failing; the dialog points this out.
  • The vapour pressure holds above 100 °C as well. It is determined over the entire temperature range from the hottest fluid temperature of the network, return included, following the industrial formulation IAPWS-IF97; supply temperatures above 100 °C are therefore assessed correctly. For cross-checking, a vapour pressure table is given in the knowledge article meeting operating pressure limits in heat networks. If the operating point supplies no fluid temperatures, the row Lowest operating pressure is omitted.
  • The standstill case is not checked. What is assessed is the calculated operating point with the pumps running. The state with the circulation at rest, which governs the sizing of the pressure maintenance, is not covered by the check.
  • The minimum operating pressure is only checked in the steady state. The evaporation check depends on the ambient pressure and on the safety margin and is performed exclusively at the steady-state operating points. The dynamic simulation says nothing about it; it reports only the Pressure exceedance of the permissible pipe pressure.
  • The differential pressure at the index point gets no verdict. The key figures table of the operating point reports Required differential pressure and Actual differential pressure side by side; you have to draw the comparison yourself.

Notes

  • Missing, outdated or non-converged results are not printed into the document but shown as messages above the button row of the dialog. They do not prevent the export.
  • Without steady-state results, the chapter Steady state calculation is left out (see Choosing the Chapters). If the results are older than the network, the dialog reports The steady state results are older than the current network. Run the calculation again to report the current state.
  • For the chapter Dynamic simulation, the dialog reports outdated simulation results, missing result files (whose figures are then missing from the report) and an evaluation period that the results cover only partly (The results cover only part of the evaluated period, so the printed energies are lower than the full period would give.).
  • If no path leads from an energy center to the index point, the dialog reports No path could be found from energy center ’…’ to the index point, so its pressure profile is not printed. In place of the section, the document then carries the sentence No path could be found from this energy center to the consumer.
  • If the assigned network fluid has no density, the geodetic component cannot be determined. No pressure profile is printed then; in place of the section, the document carries the sentence The pressure profile needs an energy center, a consumer and a network fluid with a density; at least one of them is missing.
  • For operating points with anomalies, the dialog reports Operating point ’…’: … — with no results, not checked or … % of the outputs did not converge.
  • If a stored index point refers to a node that no longer exists in the network as a transfer station, the report silently falls back to the automatic determination.

Important in practice:

Check two things before generating the report. Are elevations available for all nodes of the network? Without an elevation query every node sits at z = 0, the geodetic component is zero, and the pressure check assesses a network without topography — the limits are then formally complied with without that meaning anything. And: does the Minimum pressure margin fit your project? Binding are the technical connection requirements of the network operator; the default of 1.5 bar is a planning assumption, and one you should document along with the report.

Stay up to date

New features, tutorials and updates delivered to your inbox.