modelMixedAirHeatMassBalance

Heat and mass balance of the air, assuming completely mixed air

Extends from Buildings.ThermalZones.Detailed.BaseClasses.PartialAirHeatMassBalance (Partial model for heat and mass balance of the air), Buildings.Fluid.Interfaces.LumpedVolumeDeclarations (Declarations for lumped volumes).

Information

This model computes the heat and mass balance of the air. The model assumes a completely mixed air volume.

Parameters

TypeNameDefaultDescription
IntegerNConExt (from ConstructionNumbers)max(1, nConExt)Number of elements for exterior constructions
IntegerNConExtWin (from ConstructionNumbers)max(1, nConExtWin)Number of elements for exterior constructions with windows
IntegerNConPar (from ConstructionNumbers)max(1, nConPar)Number of elements for partition constructions
IntegerNConBou (from ConstructionNumbers)max(1, nConBou)Number of elements for constructions that have their outside surface exposed to the boundary of this room
IntegerNSurBou (from ConstructionNumbers)max(1, nSurBou)Number of elements for surface heat transfer models that connect to constructions that are modeled outside of this room
BooleanhaveConExt (from ConstructionNumbers)nConExt > 0Flag to conditionally remove components
BooleanhaveConExtWin (from ConstructionNumbers)nConExtWin > 0Flag to conditionally remove components
BooleanhaveConPar (from ConstructionNumbers)nConPar > 0Flag to conditionally remove components
BooleanhaveConBou (from ConstructionNumbers)nConBou > 0Flag to conditionally remove components
BooleanhaveSurBou (from ConstructionNumbers)nSurBou > 0Flag to conditionally remove components
ParameterConstruction[NConExt]datConExt (from ConstructionRecords)Data for exterior construction
Buildings.ThermalZones.Detailed.BaseClasses.ParameterConstructionWithWindow[NConExtWin]datConExtWin (from ConstructionRecords)Data for exterior construction with window
Buildings.ThermalZones.Detailed.BaseClasses.ParameterConstruction[NConPar]datConPar (from ConstructionRecords)Data for partition construction
Buildings.ThermalZones.Detailed.BaseClasses.ParameterConstruction[NConBou]datConBou (from ConstructionRecords)Data for construction boundary
Buildings.ThermalZones.Detailed.BaseClasses.OpaqueSurface[NSurBou]surBou (from ConstructionRecords)Record for data of surfaces whose heat conduction is modeled outside of this room
HeatTransfer.Data.OpaqueConstructions.Brick120dummyCon (from ConstructionRecords)Dummy construction to assign a parameter to the instance
Buildings.HeatTransfer.Data.GlazingSystems.SingleClear3dummyGlaSys (from ConstructionRecords)Dummy construction to assign a parameter to the instance
BooleanhaveShade (from PartialAirHeatMassBalance)Set to true if at least one window has an interior or exterior shade
Modelica.Units.SI.VolumeV (from PartialAirHeatMassBalance)Volume
BooleanhomotopyInitializationtrue= true, use homotopy method
Exterior constructions
IntegernConExt (from ConstructionNumbers)Number of exterior constructions
IntegernConExtWin (from ConstructionNumbers)Number of window constructions
Partition constructions
IntegernConPar (from ConstructionNumbers)Number of partition constructions
Boundary constructions
IntegernConBou (from ConstructionNumbers)Number of constructions that have their outside surface exposed to the boundary of this room
IntegernSurBou (from ConstructionNumbers)Number of surface heat transfer models that connect to constructions that are modeled outside of this room
General › Ports
IntegernPorts (from PartialAirHeatMassBalance)0Number of ports
Dynamics › Conservation equations
Modelica.Fluid.Types.DynamicsenergyDynamics (from LumpedVolumeDeclarations)Modelica.Fluid.Types.Dynamics.DynamicFreeInitialType of energy balance: dynamic (3 initialization options) or steady state
Modelica.Fluid.Types.DynamicssubstanceDynamics (from LumpedVolumeDeclarations)energyDynamicsType of independent mass fraction balance: dynamic (3 initialization options) or steady state
Modelica.Fluid.Types.DynamicstraceDynamics (from LumpedVolumeDeclarations)energyDynamicsType of trace substance balance: dynamic (3 initialization options) or steady state
Advanced › Dynamics
Modelica.Fluid.Types.DynamicsmassDynamics (from LumpedVolumeDeclarations)energyDynamicsType of mass balance: dynamic (3 initialization options) or steady state, must be steady state if energyDynamics is steady state
Initialization
Medium.AbsolutePressurep_start (from LumpedVolumeDeclarations)Medium.p_defaultStart value of pressure
Medium.TemperatureT_start (from LumpedVolumeDeclarations)Medium.T_defaultStart value of temperature
Medium.MassFraction[Medium.nX]X_start (from LumpedVolumeDeclarations)Medium.X_defaultStart value of mass fractions m_i/m
Medium.ExtraProperty[Medium.nC]C_start (from LumpedVolumeDeclarations)fill(0, Medium.nC)Start value of trace substances
Medium.ExtraProperty[Medium.nC]C_nominal (from LumpedVolumeDeclarations)fill(1E-2, Medium.nC)Nominal value of trace substances. (Set to typical order of magnitude.)
Dynamics
RealmSenFac (from LumpedVolumeDeclarations)1Factor for scaling the sensible thermal mass of the volume
Nominal condition
Modelica.Units.SI.MassFlowRatem_flow_nominalNominal mass flow rate
Convective heat transfer
Buildings.HeatTransfer.Types.InteriorConvectionconModConvective heat transfer model for opaque constructions
Modelica.Units.SI.CoefficientOfHeatTransferhFixedConstant convection coefficient for opaque constructions
Ports
Booleanuse_C_flowSet to true to enable input connector for trace substance

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInput[NConExtWin]uSha (from PartialAirHeatMassBalance)Input connector, used to scale the surface area to take into account an operable shading device, 0: unshaded; 1: fully shaded
Modelica.Blocks.Interfaces.RealInput[NConExtWin]QRadAbs_flow (from PartialAirHeatMassBalance)Total net radiation that is absorbed by the shade (positive if absorbed)
Modelica.Blocks.Interfaces.RealInputQCon_flow (from PartialAirHeatMassBalance)Convective sensible heat gains of the room
Modelica.Blocks.Interfaces.RealInputQLat_flow (from PartialAirHeatMassBalance)Latent heat gains for the room
Modelica.Blocks.Interfaces.RealOutput[NConExtWin]TSha (from PartialAirHeatMassBalance)Shade temperature
Modelica.Fluid.Vessels.BaseClasses.VesselFluidPorts_b[nPorts]ports (from PartialAirHeatMassBalance)Fluid inlets and outlets
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_aheaPorAir (from PartialAirHeatMassBalance)Heat port to air volume
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConExt]conExt (from PartialAirHeatMassBalance)Heat port that connects to room-side surface of exterior constructions
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConExtWin]conExtWin (from PartialAirHeatMassBalance)Heat port that connects to room-side surface of exterior constructions that contain a window
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConExtWin]glaUns (from PartialAirHeatMassBalance)Heat port that connects to room-side surface of unshaded glass
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConExtWin]glaSha (from PartialAirHeatMassBalance)Heat port that connects to room-side surface of shaded glass
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConExtWin]conExtWinFra (from PartialAirHeatMassBalance)Heat port that connects to room-side surface of window frame
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConPar]conPar_a (from PartialAirHeatMassBalance)Heat port that connects to room-side surface a of partition constructions
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConPar]conPar_b (from PartialAirHeatMassBalance)Heat port that connects to room-side surface b of partition constructions
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NConBou]conBou (from PartialAirHeatMassBalance)Heat port that connects to room-side surface of constructions that expose their other surface to the outside
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[NSurBou]conSurBou (from PartialAirHeatMassBalance)Heat port to surfaces of models that compute the heat conduction outside of this room
Modelica.Blocks.Interfaces.RealInput[Medium.nC]C_flowTrace substance mass flow rate added to the room air. Enable if use_C_flow = true

Components

TypeNameDefaultDescription
Fluid.MixingVolumes.MixingVolumeMoistAirvolRoom air volume
HeatTransfer.Convection.Interior[NConExt]convConExtConvective heat transfer
HeatTransfer.Convection.Interior[NConExtWin]convConExtWinConvective heat transfer
HeatTransfer.Windows.InteriorHeatTransferConvective[NConExtWin]convConWinModel for convective heat transfer at window
HeatTransfer.Convection.Interior[nConPar]convConPar_aConvective heat transfer
HeatTransfer.Convection.Interior[nConPar]convConPar_bConvective heat transfer
HeatTransfer.Convection.Interior[nConBou]convConBouConvective heat transfer
HeatTransfer.Convection.Interior[nSurBou]convSurBouConvective heat transfer

Revisions

  • April 14, 2020, by Michael Wetter:
    Changed homotopyInitialization to a constant.
    This is for IBPSA, #1341.
  • April 8, 2019, by Michael Wetter:
    Propagated parameter mSenFac.
    This is for issue Buildings #1405.
  • December 14, 2018, by Michael Wetter:
    Replaced call to Medium.enthalpyOfCondensingGas with Buildings.Media.Air.enthalpyOfCondensingGas.
    This is for issue Buildings #1285.
  • April 12, 2017, by Michael Wetter:
    Removed temperature connection that is no longer needed.
    This is for issue Buildings #704.
  • May 2, 2016, by Michael Wetter:
    Refactored implementation of latent heat gain. This is for issue 515.
  • March 2, 2015, by Michael Wetter:
    Refactored model to allow a temperature dependent convective heat transfer on the room side. This is for issue 52.
  • July 17, 2013, by Michael Wetter:
    Separated the model into a partial base class and a model that uses the mixed air assumption.
  • July 12, 2013, by Michael Wetter:
    First implementation to facilitate the implementation of non-uniform room air models.