Editing building demands

Define the demand models of the consumers, edit them in the table editor, import them from clipboard, Excel or text file and export them

VICUS Districts Page 2 of 3 in this chapter

Overview

The demand model of a consumer defines how its heating demand (and optionally cooling and domestic hot water demand) is described: constant, from predefined profiles by building type, or from user-defined time series. Editing is done individually on the Building demand tab of the network properties, or for all consumers together in the table editor with import and export functions.

How to open

  • Menu Network › Edit building demands … opens the table editor
  • alternatively the Building demands table … button on the Building demand tab of the network properties
  • individual consumers: select a consumer node in the 3D view, the demand properties appear on the Building demand tab, see Consumers and connection power

Demand models

The Demand model: selection field offers four model types:

Model typeDescription
Constant demandTemporally constant load, defined via Maximum heating power: [kW], Supply temperature secondary side: [°C] and Temperature difference secondary side: [K]
Pre-defined time seriesDemand profile is generated from the building type and characteristic values; parameters via Edit demand parameters …, the resulting curve is shown as a chart
User-defined time series by valuesUser-defined time series entered directly as a value table (Time [h] / Heating demand [kW]); Copy header for import and Paste from clipboard ease the data exchange with spreadsheets
User-defined time series by fileReference to a TSV or CSV file (File:); with several data columns, the desired column is chosen under Select column in data file (for the format see TSV files)

For the pre-defined time series, an overview summarizes the demand parameters, including building type, heating curve, max. heating power, annual heating energy, specific heating demand, full load hours, as well as cooling and domestic hot water characteristics (generation mode, DHW energy and share, storage parameters). Available building types: Single Family House, Multi Family House, Office Building, Nursing Home, Retail Building, Hotel, Day Care / Kindergarten, Hospital, Canteen, School, Sports Hall.

Three generation modes are available for domestic hot water; they are described in detail under Building demand in the detail editor:

DHW generation modeBehavior
With buffer storage (default)A thermostat recharges a DHW storage from which tapping and circulation are drawn; charging runs parallel to heating or with priority. The supply temperature follows the heating curve, optionally weighted with a separate DHW supply temperature
In scheduled time windowsSimplified coordinated storage charging: DHW is generated in two preparation windows per day (02:00–04:00 and, as overflow, 12:00–14:00) at the DHW peak power; the required DHW supply temperature: [°C] is taken into account
Added on top of heatingSimple model: the scaled DHW profile is added to the heating profile, without storage, preparation windows or separate DHW supply temperature

Editing several consumers together

If several consumers with pre-defined time series are selected, the Building demand tab shows the common settings under Demand parameters. A change is transferred to all selected consumers for this one setting only; the other values of the consumers are kept:

ElementMeaning
Building type:Changes the building type without a prompt; the maximum heating power is kept, the heating energy demand is determined from the new profile shape, cooling and DHW values are set to the area-related defaults of the new type
Heating curve:Assigns a heating curve to all selected consumers
With cooling demand / With domestic hot water demandSwitch the demand components on or off (default: cooling off, DHW on)
DHW generation mode:DHW generation mode
Storage charging:, Circulation share of DHW demand:, Separate DHW supply temperature:, Automatic storage sizingOnly visible if all selected consumers use DHW in With buffer storage mode
DHW / heating power ratio:Only visible if all selected consumers use DHW in In scheduled time windows mode
DHW supply temperature:Editable if all selected consumers use DHW in In scheduled time windows or With buffer storage mode, the latter only with a separate DHW supply temperature

If the selected consumers have different values, check boxes show an intermediate state and selection fields stay empty. The Edit all demand parameters … button opens the detail editor, which by contrast overwrites all values together.

Heating curve

Via Heating curve:, a heating curve from the project database is assigned to each consumer. It defines how the secondary-side supply temperature changes with the outdoor temperature; the same curve can be reused across multiple consumers. The Heating curve color mode on the Building demand tab shows the assignments in the network.

For the simulation, the demand profiles of the consumers can additionally be smoothed in an energy-preserving way, see Simulation settings.

Table editor

The Edit network building demands dialog shows all consumers of the active network in four tabs:

Edit network building demands dialog with four tabs and the consumer table
The »Edit network building demands« table editor, Demand type tab: all consumers with connection power and model type, filter field and tabs for the demand models
TabContent
Demand typeOverview with the columns Id, Consumer name, Connection power [kW] and Model type; name, connection power and model type are directly editable; the Filter: input field filters by name
Pre-defined time seriesParameter table with the columns Id, Consumer name, Connection power [kW], Building type, Floor area [m2], Heating power [kW], Heating demand [kWh/a], Heating curve, Use DHW, DHW generation mode, DHW energy demand [kWh], DHW supply temperature [C], DHW-to-heating ratio [-], DHW circulation share [%], DHW storage auto size, DHW storage volume [L], DHW charging priority, DHW separate supply temperature, Use cooling, Cooling power [kW], Cooling demand [kWh/a]
User-defined time seriesColumns Id, Building name, Time unit, Data count; Remove existing values deletes the stored time series
User-defined filesColumns Id, Building name, File path; Remove existing file references deletes the file assignments

The tabs of the three demand models each contain a Convert all consumers to ’…’ button, which switches the model type of all consumers to the tab’s type. Changes are only applied with Apply to project; Cancel discards them.

When applying, VICUS Districts checks the consumers with pre-defined time series: if an annual heating or cooling energy demand cannot be reached with the given peak power and profile shape, it is automatically moved into the reachable range. The Building demand check message lists the adjusted consumers with old and new value as well as consumers whose parameters are still invalid. Such inconsistencies typically originate from bulk imports.

Import

The Import data … button opens the import dialog. The data can be inserted with Paste from clipboard (or Ctrl+V) or loaded with Read from file …; for user-defined files, pasting from the clipboard is not available. The text is directly editable in the dialog.

SourceParameters / time seriesUser-defined files
Excel workbook (.xlsx)yes, the first worksheet is usedno
TSV or CSV fileyesyes
Clipboard (e.g. from a spreadsheet)yes–
OptionDefaultMeaning
Number of lines to skip from top:0 (parameter import: 1)Skips header or comment lines at the start of the file

Format requirements:

  • Parameters are tab-separated, as when pasting from a spreadsheet or reading an Excel workbook. The column order matches the parameter export; building type, DHW generation mode and heating curve are given as number or ID, yes/no columns as 1/0. The rows are assigned via the node Id.
  • Time series: header line with units in square brackets, the first column is the time axis in [s], [h] or [d], the unit of the data columns must be convertible to watts (e.g. [kW]). Columns may be separated by tab, semicolon or comma; the separator is detected automatically. The column headings are matched against the node names in the project.
  • Point and comma are both accepted as decimal separator (comma not with comma-separated columns); empty rows are skipped.

The Messages area shows the check result, such as IDs or names that cannot be assigned; only valid data can be applied with Ok.

Practical tip

For a bulk import of parameters, first export the table as an Excel workbook, edit it there and read it back in: this keeps column order and coding correct, and the key lists for building types, DHW generation modes and heating curves are included as separate worksheets. Note that parameters are assigned via the node Id, whereas time series are assigned via the exact node name in the column heading, and that every time series column must carry its unit in square brackets. Always read the Messages area before confirming.

Export

  • Export data … exports the table of the active tab (parameters or user-defined time series). The parameter export is followed by the key lists Building types, DHW generation modes and heating curves
  • Export time series … (only on the Pre-defined time series tab) generates time series for all consumers from the pre-defined profiles and exports them

For the time series export, the export dialog offers the following options:

OptionDefaultMeaning
Demand:Heating + Cooling + DHW (combined, signed)Alternatively Heating only, Cooling only or Domestic hot water only
Consider node time shiftinactiveShifts each demand profile by its optimized time shift from the diversity calculation; the output is then in its temporal resolution (e.g. 20 minutes). Only available if valid diversity results are present

Copy to clipboard transfers the data tab-separated; the decimal separator follows the language of the user interface (e.g. comma in German), so the values can be pasted directly into a spreadsheet. Save to file … writes an Excel workbook (.xlsx, default; key lists as separate worksheets) or a TSV file with a point as decimal separator. The data columns are exported in [kW], the time axis as Time [h].

Stay up to date

New features, tutorials and updates delivered to your inbox.