Component Reference

Overview of all component model types for plants: categories, common parameters, pressure loss law, controller and heating curve requirements

VICUS Districts Page 3 of 14 in this chapter

Overview

This reference describes all component model types that can be used in plants. Each component represents a hydraulic element (pressure loss or pressure increase) and – depending on the type – a thermal model. The detailed descriptions are organized into subchapters by category:

SubchapterContent
PipesSimple and discretized pipe, pressure loss according to Darcy-Weisbach
PumpsConstant, linear and controlled head, pump characteristic curves, electrical power
Pressure losses & valvesControlled valve, thermostatic bypass, pressure-loss elements (constant, quadratic, Kvs value, zeta), non-return valve, building internal installation
Automatic sizingSized vs. individual variants of the consumer components
Simple heat exchangerSimplified transfer-station model with demand boundary condition
Transfer stationDetailed counterflow model with limited transfer power
Model selection for consumersDecision aid: heat exchanger or transfer station?
Ideal heat/cold generatorSupply temperature from the heating curve or prescribed heating power, power limits
Heat pumpsSource-side and supply-side heat pump with COP polynomial
Geothermal & heat sourcesBorehole heat exchanger field, geothermal collector, source-side heat exchanger

Access

Components are dragged from the library onto the canvas in the graphical plant editor (accessed via Databases › Plants… and Edit plant …). Their parameters are edited there in the properties area of the respective component. For each component, the editor shows a detailed model description in the Description tab, with model equations, controller modes and – for pumps – efficiency and electrical power.

The heat exchange type is chosen per component in the Heat exchange tab. The possible types are: none (adiabatic), constant temperature, time-dependent temperature, constant heating power, time-dependent heating power – for details see heat exchange types.

Common model principles

Some parameters and relationships appear in almost all components:

Quadratic pressure loss law

The simple heat exchanger, transfer station, all heat pumps, the ideal heat/cold generator, the source-side heat exchanger and the element with quadratic pressure loss compute their pressure loss from a nominal operating point (nominal volume flow V˙nom\dot V_{nom} and nominal pressure loss Δpnom\Delta p_{nom}). The pressure loss scales quadratically with the volume flow:

Δp=Δpnom⋅(V˙V˙nom)2\Delta p = \Delta p_{nom} \cdot \left( \frac{\dot V}{\dot V_{nom}} \right)^2

For the sized variants, the nominal volume flow is determined automatically from the building’s connection power; only the nominal pressure loss then still has to be specified.

Other components follow their own laws: pipes, the borehole heat exchanger field, the geothermal collector and the building-internal installation use pipe friction (Darcy-Weisbach), the controlled valve uses its KvsK_{vs} value and a controller; the constant pressure loss element, zeta element, element with KvsK_{vs} value and check valve each have their own characteristics.

Fluid volume

Every component contains a fluid volume that determines its thermal inertia: the contained fluid is balanced as an ideally mixed volume with a uniform temperature. Larger volumes dampen temperature changes and have a numerically stabilizing effect, but delay the response of the control. Pipes derive their volume from length and inner diameter.

For all other components the fluid volume cannot be changed in the user interface. By default it is 10 L; components without a stored volume (ideal heater and cooler, non-return valve) are computed with 5 L. Projects from version 2.0 and older with smaller volumes are raised to 10 L when opened: very small, ideally mixed volumes lead to unphysical temperatures in idle components (leakage flow only) and slow down the simulation.

Parallel elements

Pipes and pumps have a counter for parallel elements (Number of parallel pipes or Number of parallel pumps). The mass flux is distributed evenly; pressure loss or head apply to each individual element.

Controller and heating curve requirements

RequirementComponents
Controller requiredPump with controlled head, controlled valve – see controller
Heating curve requiredTransfer station (setpoint secondary side; not with constant demand), supply-side heat pump (supply setpoint), ideal heat/cold generator (supply temperature), source-side heat pump (condenser temperature)
Heating curve optionalSimple heat exchanger (limiting the outlet temperature)

The heating curve of a consumer is assigned via the building demand of the node. With a constant building demand the transfer station needs no heating curve; it then works with the constant heating setpoint and the constant temperature spread. For the supply-side heat pump and the ideal heat/cold generator, the heating curve is assigned in detailed plants directly to the component in the component editor; only in the simplified energy plant is it a plant setting.

Notes

  • All default values are presets applied when creating a component and should be adjusted per project.
  • All physical quantities are computed internally in SI base units; the reference tables state the display units of the user interface.

Stay up to date

New features, tutorials and updates delivered to your inbox.