.Buildings.DHC.Loads.BaseClasses.BuildingTimeSeries

Information

This is a simplified building model where the space heating and cooling loads are provided as time series. In order to approximate the emission characteristic of the building HVAC system, this model uses idealized fan coil models that are parameterized with the peak load, determined from the provided time series, and design values of the hot water and chilled water supply and return temperatures.

The time series that provide the loads are read from the file filNam. This file must have columns as shown in this example:

#1
#Heating, cooling and domestic hot water loads
#
#First column: Seconds in the year (loads are hourly)
#Second column: cooling loads in Watts (as negative numbers).
#Third column: space heating loads in Watts
#Fourth column: domestic hot water loads in Watts
#
#Peak space cooling load = -146960 Watts
#Peak space heating load = 167690 Watts
#Peak water heating load = 9390 Watts
double tab1(8760,4)
0;0;18230;0
3600;0;17520;0
7200;0;20170;0
10800;0;22450;0
[further rows omitted]

• The first column must be the time of the year in seconds.
• If have_chiWat = true, then the next column must be the space cooling load in Watts. Note that cooling is a negative number.
  If have_chiWat = false, this column must be present but it will be ignored, and hence it can be set to any number such as 0.
• If have_heaWat = true, the next column must be the space heating load in Watts.
  If have_heaWat = false, this column must be present but it will be ignored, and hence it can be set to any number such as 0.
• If have_hotWat = true, the next column must be the domestic hot water load in Watts.
  If have_hotWat = false, this column must be present but it will be ignored, and hence it can be set to any number such as 0.

The entry double tab1(8760,4) shows how many columns and rows are present.

The header also needs to contain the lines that start with #Peak as shown in the example above.

Implementation details

The total space heating (resp. cooling) load is split between facMulHea (resp. facMulCoo) identical terminal units with heat transfer performance approximated based on design specifications of a reference terminal unit. It is not expected that the user modifies the default values that are proposed for facMulHea and facMulCoo unless detailed design data are available for the building HVAC system. In that latter case, the following set of parameters should be modified consistently to match the design data.

• Hot water (resp. chilled water) supply and return temperature T_aHeaWat_nominal and T_bHeaWat_nominal (resp. T_aChiWat_nominal and T_bChiWat_nominal)
• Terminal unit entering air temperature T_aLoaHea_nominal (resp. T_aLoaCoo_nominal) and humidity ratio w_aLoaCoo_nominal
• Terminal unit air mass flow rate mLoaHea_flow_nominal (resp. mLoaCoo_flow_nominal)
• Terminal unit scaling factor facMulHea (resp. facMulCoo)

For reference, the default reference terminal unit performance is based on manufacturer data (Carrier fan coil model 42NL/NH) at selection conditions as specified in the "Advanced" tab.

Contents

Name	Description
Medium2	Load side medium

Revisions

• May 3, 2023, by David Blum:
  Applied facMul to domestic hot water load.
  This is for issue 3379.
• November 21, 2022, by David Blum:
  Scale facMulHea and facMulCoo with peak load.
  This is for issue 2302.
• December 21, 2020, by Antoine Gautier:
  Refactored for optional hot water and multiplier factor.
  This is for issue 2291.
• September 18, 2020, by Jianjun Hu:
  Changed flow distribution components and the terminal units to be conditional depending on if there is water-based heating, or cooling system. This is for issue 2147.
• February 21, 2020, by Antoine Gautier:
  First implementation.