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 type | Description |
|---|---|
| Constant demand | Temporally constant load, defined via Maximum heating power: [kW], Supply temperature secondary side: [°C] and Temperature difference secondary side: [K] |
| Pre-defined time series | Demand 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 values | User-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 file | Reference 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 mode | Behavior |
|---|---|
| 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 windows | Simplified 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 heating | Simple 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:
| Element | Meaning |
|---|---|
| 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 demand | Switch 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 sizing | Only 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:
| Tab | Content |
|---|---|
| Demand type | Overview 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 series | Parameter 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 series | Columns Id, Building name, Time unit, Data count; Remove existing values deletes the stored time series |
| User-defined files | Columns 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.
| Source | Parameters / time series | User-defined files |
|---|---|---|
Excel workbook (.xlsx) | yes, the first worksheet is used | no |
| TSV or CSV file | yes | yes |
| Clipboard (e.g. from a spreadsheet) | yes | – |
| Option | Default | Meaning |
|---|---|---|
| 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:
| Option | Default | Meaning |
|---|---|---|
| Demand: | Heating + Cooling + DHW (combined, signed) | Alternatively Heating only, Cooling only or Domestic hot water only |
| Consider node time shift | inactive | Shifts 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].