modelBuildingETS

Load connected to the network via ETS with or without DHW integration

Extends from Buildings.DHC.Loads.BaseClasses.PartialBuildingWithPartialETS (Partial model of a building with an energy transfer station).

Information

Model that connects a building thermal and cooling load, specified by time series, with an energy transfer station, and exposes the fluid connections of the energy transfer station for connecting it to district energy service lines.

The model extends from Buildings.DHC.Loads.BaseClasses.PartialBuildingWithPartialETS, which connects the building and the load, and exposes the fluid connection for connecting it to the district service line. The building load is modeled by reading time series, and drawing as much heating or cooling water as determined by its control. This is implemented through Buildings.DHC.Examples.Combined.ETSHeatRecoveryHeatPump_BuildingTimeSeries.BaseClasses.BuildingTimeSeries. The energy transfer station uses a heat recovery heat pump, and can optionally have domestic hot water preparation. This is implemented in Buildings.DHC.ETS.Combined.HeatRecoveryHeatPump.

See the respective models for a detailed description.

Parameters

TypeNameDefaultDescription
IntegeridxPHeaETS (from PartialBuildingWithPartialETS)max(Modelica.Math.BooleanVectors.countTrue({bui.have_eleHea, ets.have_eleHea}), 1)Index for connecting the ETS output connector
IntegeridxPCooETS (from PartialBuildingWithPartialETS)max(Modelica.Math.BooleanVectors.countTrue({bui.have_eleCoo, ets.have_eleCoo}), 1)Index for connecting the ETS output connector
IntegeridxPFanETS (from PartialBuildingWithPartialETS)max(Modelica.Math.BooleanVectors.countTrue({bui.have_fan, ets.have_fan}), 1)Index for connecting the ETS output connector
IntegeridxPPumETS (from PartialBuildingWithPartialETS)max(Modelica.Math.BooleanVectors.countTrue({bui.have_pum, ets.have_pum}), 1)Index for connecting the ETS output connector
RealfacTerUniSizHeaFactor to increase design capacity of space terminal units for heating
StringfilNamFile name for the load profile
Buildings.DHC.Examples.Combined.ETSHeatRecoveryHeatPump_BuildingTimeSeries.Data.HVACdatBuiSetBuilding set points
Buildings.DHC.ETS.Combined.Data.WAMAK_220kWdatHeaPumHeat recovery heat pump parameters
Buildings.DHC.Loads.HotWater.Data.GenericDomesticHotWaterWithHeatExchangerdatDhwPerformance data of the domestic hot water component
Configuration
IntegernPorts_heaWat (from PartialBuildingWithPartialETS)0Number of heating water fluid ports
IntegernPorts_chiWat (from PartialBuildingWithPartialETS)0Number of chilled water fluid ports
TypDisSystyp (from PartialBuildingWithPartialETS)ets.typType of district system
Booleanhave_heaWat (from PartialBuildingWithPartialETS)ets.have_heaWatSet to true if the ETS supplies heating water
Booleanhave_hotWat (from PartialBuildingWithPartialETS)ets.have_hotWatSet to true if the ETS supplies domestic hot water
Booleanhave_chiWat (from PartialBuildingWithPartialETS)ets.have_chiWatSet to true if the ETS supplies chilled water
Booleanhave_eleHea (from PartialBuildingWithPartialETS)bui.have_eleHea or ets.have_eleHeaSet to true if the building or ETS has electric heating system
IntegernFue (from PartialBuildingWithPartialETS)ets.nFueNumber of fuel types (0 means no combustion system)
Booleanhave_eleCoo (from PartialBuildingWithPartialETS)bui.have_eleCoo or ets.have_eleCooSet to true if the building or ETS has electric cooling system
Booleanhave_fan (from PartialBuildingWithPartialETS)bui.have_fan or ets.have_fanSet to true if fan power is computed
Booleanhave_pum (from PartialBuildingWithPartialETS)bui.have_pum or ets.have_pumSet to true if pump power is computed
Booleanhave_weaBus (from PartialBuildingWithPartialETS)bui.have_weaBus or ets.have_weaBusSet to true to use a weather bus
Booleanhave_eleNonHvaSet to true to enable a data reader and output signal for non-HVAC electrical load
Scaling
RealfacMul (from PartialBuildingWithPartialETS)1Multiplier factor
Assumptions
BooleanallowFlowReversalSer (from PartialBuildingWithPartialETS)falseSet to true to allow flow reversal on service side
BooleanallowFlowReversalBui (from PartialBuildingWithPartialETS)falseSet to true to allow flow reversal on building side
Nominal condition
Modelica.Units.SI.HeatFlowRateQHeaWat_flow_nominal (from PartialBuildingWithPartialETS)ets.QHeaWat_flow_nominalNominal capacity of heating system (>=0)
Modelica.Units.SI.HeatFlowRateQHotWat_flow_nominal (from PartialBuildingWithPartialETS)ets.QHotWat_flow_nominalNominal capacity of hot water production system (>=0)
Modelica.Units.SI.HeatFlowRateQChiWat_flow_nominal (from PartialBuildingWithPartialETS)ets.QChiWat_flow_nominalNominal capacity of cooling system (<=0)
Modelica.Units.SI.TemperatureTChiWatRet_nominaldatBuiSet.TChiWatRet_nominalChilled water return temperature from building load
Modelica.Units.SI.TemperatureTHeaWatRet_nominaldatBuiSet.THeaWatRet_nominalHeating water return temperature from building load
Modelica.Units.SI.TemperatureDifferencedT_nominal4Water temperature drop/increase accross load and source-side HX (always positive)
Modelica.Units.SI.TemperatureTChiWatSup_nominaldatBuiSet.TChiWatSup_nominalChilled water supply temperature to building load
Modelica.Units.SI.TemperatureTHeaWatSup_nominaldatBuiSet.THeaWatSup_nominalHeating water supply temperature to building load
Design parameter
Modelica.Units.SI.HeatFlowRateQCoo_flow_nominalBuildings.DHC.Loads.BaseClasses.getPeakLoad(string = "#Peak space cooling load", filNam = Modelica.Utilities.Files.loadResource(filNam))Design cooling heat flow rate (<=0)
Modelica.Units.SI.HeatFlowRateQHea_flow_nominalBuildings.DHC.Loads.BaseClasses.getPeakLoad(string = "#Peak space heating load", filNam = Modelica.Utilities.Files.loadResource(filNam))Design heating heat flow rate (>=0)
Modelica.Units.SI.HeatFlowRateQHot_flow_nominalBuildings.DHC.Loads.BaseClasses.getPeakLoad(string = "#Peak water heating load", filNam = Modelica.Utilities.Files.loadResource(filNam))Design heating heat flow rate (>=0)
ETS model parameters
Modelica.Units.SI.TemperatureTHotWatSup_nominaldatBuiSet.THotWatSupFix_nominalDomestic hot water supply temperature to fixtures

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Interfaces.FluidPort_aport_aSerAmb (from PartialBuildingWithPartialETS)Fluid connector for ambient water service supply line
Modelica.Fluid.Interfaces.FluidPort_bport_bSerAmb (from PartialBuildingWithPartialETS)Fluid connector for ambient water service return line
Modelica.Fluid.Interfaces.FluidPort_aport_aSerHea (from PartialBuildingWithPartialETS)Fluid connector for heating service supply line
Modelica.Fluid.Interfaces.FluidPort_bport_bSerHea (from PartialBuildingWithPartialETS)Fluid connector for heating service return line
Modelica.Fluid.Interfaces.FluidPort_aport_aSerCoo (from PartialBuildingWithPartialETS)Fluid connector for cooling service supply line
Modelica.Fluid.Interfaces.FluidPort_bport_bSerCoo (from PartialBuildingWithPartialETS)Fluid connector for cooling service return line
BoundaryConditions.WeatherData.BusweaBus (from PartialBuildingWithPartialETS)Weather data bus
Buildings.Controls.OBC.CDL.Interfaces.RealOutputQHea_flow (from PartialBuildingWithPartialETS)Total heating heat flow rate transferred to the loads (>=0)
Buildings.Controls.OBC.CDL.Interfaces.RealOutputQCoo_flow (from PartialBuildingWithPartialETS)Total cooling heat flow rate transferred to the loads (<=0)
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPHea (from PartialBuildingWithPartialETS)Power drawn by heating system
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPCoo (from PartialBuildingWithPartialETS)Power drawn by cooling system
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPFan (from PartialBuildingWithPartialETS)Power drawn by fan motors
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPPum (from PartialBuildingWithPartialETS)Power drawn by pump motors
Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nFue]QFue_flow (from PartialBuildingWithPartialETS)Fuel energy input rate
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPEleNonHvaPower drawn by non-HVAC electricity load
Buildings.Controls.OBC.CDL.Interfaces.RealOutputdHHeaWat_flowHeating water distributed energy flow rate
Buildings.Controls.OBC.CDL.Interfaces.RealOutputdHChiWat_flowChilled water distributed energy flow rate
Buildings.Controls.OBC.CDL.Interfaces.RealOutputdHHotWat_flowDomestic hot water distributed energy flow rate

Components

TypeNameDefaultDescription
Buildings.DHC.Loads.BaseClasses.PartialBuildingbui (from PartialBuildingWithPartialETS)Building model
Buildings.DHC.ETS.BaseClasses.PartialETSets (from PartialBuildingWithPartialETS)Energy transfer station model
Buildings.Controls.OBC.CDL.Reals.MultiSumtotPHea (from PartialBuildingWithPartialETS)Total power drawn by heating system
Buildings.Controls.OBC.CDL.Reals.MultiSumtotPCoo (from PartialBuildingWithPartialETS)Total power drawn by cooling system
Buildings.Controls.OBC.CDL.Reals.MultiSumtotPFan (from PartialBuildingWithPartialETS)Total power drawn by fan motors
Buildings.Controls.OBC.CDL.Reals.MultiSumtotPPum (from PartialBuildingWithPartialETS)Total power drawn by pump motors
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulQHea_flow (from PartialBuildingWithPartialETS)Scaling
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulQCoo_flow (from PartialBuildingWithPartialETS)Scaling
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulPHea (from PartialBuildingWithPartialETS)Scaling
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulPCoo (from PartialBuildingWithPartialETS)Scaling
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulPFan (from PartialBuildingWithPartialETS)Scaling
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulPPum (from PartialBuildingWithPartialETS)Scaling
Fluid.BaseClasses.MassFlowRateMultipliermulSerAmbInl (from PartialBuildingWithPartialETS)Mass flow rate multiplier
Fluid.BaseClasses.MassFlowRateMultipliermulSerAmbOut (from PartialBuildingWithPartialETS)Mass flow rate multiplier
Fluid.BaseClasses.MassFlowRateMultipliermulSerHeaInl (from PartialBuildingWithPartialETS)Mass flow rate multiplier
Fluid.BaseClasses.MassFlowRateMultipliermulSerHeaOut (from PartialBuildingWithPartialETS)Mass flow rate multiplier
Fluid.BaseClasses.MassFlowRateMultipliermulSerCooInl (from PartialBuildingWithPartialETS)Mass flow rate multiplier
Fluid.BaseClasses.MassFlowRateMultipliermulSerCooOut (from PartialBuildingWithPartialETS)Mass flow rate multiplier
Buildings.Controls.OBC.CDL.Reals.MultiplyByParameter[nFue]mulQFue_flow (from PartialBuildingWithPartialETS)Scaling
Buildings.Controls.SetPoints.TableTHeaWatSupSet
Buildings.Controls.SetPoints.TableTChiWatSupSet
Buildings.Controls.OBC.CDL.Reals.Sources.ConstantTHotWatSupSet
Buildings.Controls.OBC.CDL.Reals.Sources.ConstantTColWat
Modelica.Blocks.Sources.CombiTimeTableloaEleNonHvaReader for non-HVAC electricity load
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametermulPEleNonHvaScaling

Revisions

  • November 14, 2025, by Michael Wetter:
    First implementation.