modelBuildingTimeSeries
Building load with time series and control valve for supply water temperature to the coils
Extends from Buildings.DHC.Loads.BaseClasses.BuildingTimeSeries (Building model with heating and/or cooling loads provided as time series).
Information
Model of a building heating and cooling load based on time series data.
This model is identical to Buildings.DHC.Loads.BaseClasses.BuildingTimeSeries, but it adds input signals for the heating and cooling supply water temperature, and configures the above model to use a three-way control valve to mix the heating and cooling supply water to the temperature described by these two input signals.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | nPorts_aHeaWat (from PartialBuilding) | 0 | Number of heating water inlet ports |
| Integer | nPorts_bHeaWat (from PartialBuilding) | 0 | Number of heating water outlet ports |
| Integer | nPorts_aChiWat (from PartialBuilding) | 0 | Number of chilled water inlet ports |
| Integer | nPorts_bChiWat (from PartialBuilding) | 0 | Number of chilled water outlet ports |
| String | filNam (from BuildingTimeSeries) | File name with thermal loads as time series | |
| Real | k (from BuildingTimeSeries) | 0.1 | Gain of controller |
| Modelica.Units.SI.Time | Ti (from BuildingTimeSeries) | 10 | Time constant of integrator block |
| Configuration | |||
| Boolean | have_heaWat (from PartialBuilding) | false | Set to true if the building has heating water system |
| Boolean | have_chiWat (from PartialBuilding) | false | Set to true if the building has chilled water system |
| Boolean | have_eleHea (from PartialBuilding) | false | Set to true if the building has decentralized electric heating system |
| Boolean | have_eleCoo (from PartialBuilding) | false | Set to true if the building has decentralized electric cooling system |
| Boolean | have_fan (from PartialBuilding) | false | Set to true if fan power is computed |
| Boolean | have_pum (from PartialBuilding) | false | Set to true if pump power is computed |
| Boolean | have_weaBus (from PartialBuilding) | false | Set to true to use a weather bus |
| Boolean | have_heaLoa (from PartialBuilding) | have_heaWat or have_eleHea | Set to true if the building has heating loads |
| Boolean | have_cooLoa (from PartialBuilding) | have_chiWat or have_eleCoo | Set to true if the building has cooling loads |
| Boolean | have_hotWat (from BuildingTimeSeries) | false | Set to true if SHW load is included in the time series |
| Scaling | |||
| Real | facMul (from PartialBuilding) | 1 | Multiplier factor |
| Assumptions | |||
| Boolean | allowFlowReversal (from PartialBuilding) | false | = true to allow flow reversal, false restricts to design direction (port_a -> port_b) |
| Advanced › Scaling | |||
| Real | facMulHea (from BuildingTimeSeries) | QHea_flow_nominal/(QHea_flow_nominal_ref*abs(T_aLoaHea_nominal - T_aHeaWat_nominal)/abs(T_aLoaHea_nominal_ref - T_aHeaWat_nominal_ref)*mLoaHea_flow_nominal/mLoaHea_flow_nominal_ref) | Heating terminal unit multiplier factor |
| Real | facMulCoo (from BuildingTimeSeries) | QCoo_flow_nominal/(QCoo_flow_nominal_ref*abs(h_aLoaCoo_nominal - hSat_nominal)/abs(h_aLoaCoo_nominal_ref - hSat_nominal_ref)*mLoaCoo_flow_nominal/mLoaCoo_flow_nominal_ref) | Cooling terminal unit scaling factor |
| Nominal condition | |||
| Modelica.Units.SI.Temperature | T_aHeaWat_nominal (from BuildingTimeSeries) | 323.15 | Heating water inlet temperature at nominal conditions |
| Modelica.Units.SI.Temperature | T_bHeaWat_nominal (from BuildingTimeSeries) | T_aHeaWat_nominal - 10 | Heating water outlet temperature at nominal conditions |
| Modelica.Units.SI.Temperature | T_aChiWat_nominal (from BuildingTimeSeries) | 280.15 | Chilled water inlet temperature at nominal conditions |
| Modelica.Units.SI.Temperature | T_bChiWat_nominal (from BuildingTimeSeries) | T_aChiWat_nominal + 5 | Chilled water outlet temperature at nominal conditions |
| Modelica.Units.SI.HeatFlowRate | QCoo_flow_nominal (from BuildingTimeSeries) | if have_chiWat then Buildings.DHC.Loads.BaseClasses.getPeakLoad(string = "#Peak space cooling load", filNam = Modelica.Utilities.Files.loadResource(filNam)) else 0 | Design cooling heat flow rate (<=0) |
| Modelica.Units.SI.HeatFlowRate | QHea_flow_nominal (from BuildingTimeSeries) | if have_heaWat then Buildings.DHC.Loads.BaseClasses.getPeakLoad(string = "#Peak space heating load", filNam = Modelica.Utilities.Files.loadResource(filNam)) else 0 | Design heating heat flow rate (>=0) |
| Modelica.Units.SI.MassFlowRate | mChiWat_flow_nominal (from BuildingTimeSeries) | QCoo_flow_nominal/cp_default/(T_aChiWat_nominal - T_bChiWat_nominal) | Chilled water mass flow rate at nominal conditions (all units) |
| Modelica.Units.SI.MassFlowRate | mHeaWat_flow_nominal (from BuildingTimeSeries) | QHea_flow_nominal/cp_default/(T_aHeaWat_nominal - T_bHeaWat_nominal) | Heating water mass flow rate at nominal conditions (all units) |
| Advanced › Nominal condition | |||
| Modelica.Units.SI.Temperature | T_aLoaHea_nominal (from BuildingTimeSeries) | 293.15 | Load side inlet temperature at nominal conditions in heating mode |
| Modelica.Units.SI.Temperature | T_aLoaCoo_nominal (from BuildingTimeSeries) | 298.15 | Load side inlet temperature at nominal conditions in cooling mode |
| Modelica.Units.SI.MassFraction | w_aLoaCoo_nominal (from BuildingTimeSeries) | 0.01 | Load side inlet humidity ratio at nominal conditions in cooling mode |
| Modelica.Units.SI.MassFlowRate | mLoaHea_flow_nominal (from BuildingTimeSeries) | 0.5 | Load side mass flow rate at nominal conditions in heating mode (single unit) |
| Modelica.Units.SI.MassFlowRate | mLoaCoo_flow_nominal (from BuildingTimeSeries) | mLoaHea_flow_nominal | Load side mass flow rate at nominal conditions in cooling mode (single unit) |
| Advanced › Reference terminal unit performance | |||
| Modelica.Units.SI.Temperature | T_aHeaWat_nominal_ref (from BuildingTimeSeries) | 323.15 | Heating water inlet temperature at nominal conditions of reference terminal unit |
| Modelica.Units.SI.Temperature | T_aLoaHea_nominal_ref (from BuildingTimeSeries) | 293.15 | Load side inlet temperature at nominal conditions in heating mode of reference terminal unit |
| Modelica.Units.SI.MassFlowRate | mLoaHea_flow_nominal_ref (from BuildingTimeSeries) | 0.5 | Load side mass flow rate at nominal conditions in heating mode of reference terminal unit |
| Modelica.Units.SI.HeatFlowRate | QHea_flow_nominal_ref (from BuildingTimeSeries) | 4.5E3 | Heat flow at nominal conditions in heating mode of reference terminal unit |
| Modelica.Units.SI.Temperature | T_aChiWat_nominal_ref (from BuildingTimeSeries) | 279.15 | Chilled water inlet temperature at nominal conditions of reference terminal unit |
| Modelica.Units.SI.Temperature | T_aLoaCoo_nominal_ref (from BuildingTimeSeries) | 298.15 | Load side inlet temperature at nominal conditions in cooling mode of reference terminal unit |
| Modelica.Units.SI.MassFraction | w_aLoaCoo_nominal_ref (from BuildingTimeSeries) | 0.01 | Load side inlet humidity ratio at nominal conditions in cooling mode of reference terminal unit |
| Modelica.Units.SI.MassFlowRate | mLoaCoo_flow_nominal_ref (from BuildingTimeSeries) | 0.5 | Load side mass flow rate at nominal conditions in cooling mode of reference terminal unit |
| Modelica.Units.SI.HeatFlowRate | QCoo_flow_nominal_ref (from BuildingTimeSeries) | -5.8E3 | Heat flow at nominal conditions in cooling mode of reference terminal unit |
Connectors
Components
Revisions
-
November 14, 2025, by Michael Wetter:
First implementation.
This is for #4354.