modelRoomHeatMassBalance

Base model for a room

Extends from Buildings.ThermalZones.Detailed.BaseClasses.ConstructionRecords (Data records for construction data).

Information

Partial model for a room heat and mass balance.

This is the base class for Buildings.ThermalZones.Detailed.CFD and for Buildings.ThermalZones.Detailed.MixedAir

See Buildings.ThermalZones.Detailed.UsersGuide for detailed explanations.

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
BooleanhomotopyInitializationtrue= true, use homotopy method
Modelica.Units.SI.VolumeVAFlo*hRooVolume
Modelica.Units.SI.AreaAFloFloor area
Modelica.Units.SI.LengthhRooAverage room height
BooleanlinearizeRadiationtrueSet to true to linearize emissive power
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
IntegernPorts0Number of ports
Dynamics › Glazing system
BooleansteadyStateWindowfalseSet to false to add thermal capacity at window, which generally leads to faster simulation
Convective heat transfer
Buildings.HeatTransfer.Types.InteriorConvectionintConModBuildings.HeatTransfer.Types.InteriorConvection.TemperatureConvective heat transfer model for room-facing surfaces of opaque constructions
Modelica.Units.SI.CoefficientOfHeatTransferhIntFixed3.0Constant convection coefficient for room-facing surfaces of opaque constructions
Buildings.HeatTransfer.Types.ExteriorConvectionextConModBuildings.HeatTransfer.Types.ExteriorConvection.TemperatureWindConvective heat transfer model for exterior facing surfaces of opaque constructions
Modelica.Units.SI.CoefficientOfHeatTransferhExtFixed10.0Constant convection coefficient for exterior facing surfaces of opaque constructions
Nominal condition
Modelica.Units.SI.MassFlowRatem_flow_nominalV*1.2/3600Nominal mass flow rate
Experimental (may be changed in future releases)
BooleansampleModelfalseSet to true to time-sample the model, which can give shorter simulation time if there is already time sampling in the system model

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Vessels.BaseClasses.VesselFluidPorts_b[nPorts]portsFluid inlets and outlets
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_aheaPorAirHeat port to air volume
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_aheaPorRadHeat port for radiative heat gain and radiative temperature
Modelica.Blocks.Interfaces.RealInput[nConExtWin]uWinControl signal for window state (used for electrochromic windows, removed otherwise)
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[nConBou]surf_conBouHeat port at surface b of construction conBou
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[nSurBou]surf_surBouHeat port of surface that is connected to the room air
Modelica.Blocks.Interfaces.RealInput[3]qGai_flowRadiant, convective and latent heat input into room (positive if heat gain)
BoundaryConditions.WeatherData.BusweaBusWeather data

Components

TypeNameDefaultDescription
Constructions.Construction[NConExt]conExtHeat conduction through exterior construction that have no window
Constructions.ConstructionWithWindow[NConExtWin]conExtWinHeat conduction through exterior construction that have a window
Constructions.Construction[NConPar]conParHeat conduction through partitions that have both sides inside the thermal zone
Constructions.Construction[NConBou]conBouHeat conduction through opaque constructions that have the boundary conditions of the other side exposed
BaseClasses.ExteriorBoundaryConditionsbouConExtExterior boundary conditions for constructions without a window
BaseClasses.ExteriorBoundaryConditionsWithWindowbouConExtWinExterior boundary conditions for constructions with a window
HeatTransfer.Windows.BaseClasses.WindowRadiation[NConExtWin]conExtWinRadModel for solar radiation through shades and window
BaseClasses.PartialAirHeatMassBalanceair
Buildings.ThermalZones.Detailed.BaseClasses.SolarRadiationExchangesolRadExcSolar radiative heat exchange
Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationGainDistributionirRadGaiDistribution for infrared radiative heat gains (e.g., due to equipment and people)
Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationExchangeirRadExcInfrared radiative heat exchange
Buildings.ThermalZones.Detailed.BaseClasses.RadiationTemperatureradTemRadiative temperature of the room
HeatTransfer.Windows.BaseClasses.ShadeRadiation[NConExtWin]shaRadRadiation model for room-side window shade

Contents

NameDescription
MediumMedium in the component

Revisions

  • February 11, 2022, by Michael Wetter:
    Change parameter isFloor to is_floor, and isCeiling to is_ceiling, for consistency with naming convention.
  • September 16, 2021, by Michael Wetter:
    Removed parameter lat because the latitude is now obtained from the weather data bus.
    This is for IBPSA, #1477.
  • April 14, 2020, by Michael Wetter:
    Changed homotopyInitialization to a constant.
    This is for IBPSA, #1341.
  • November 21, 2016, by Thierry S. Nouidui:
    Removed for loop to avoid translation error in Dymola 2107. This is a work-around for a bug in Dymola which will be addressed in future releases.
  • October 29, 2016, by Michael Wetter:
    Added optional capacity at the room-facing surface to reduce the dimension of the nonlinear system of equations, which generally decreases computing time.
    This is for issue 565.
  • September 17, 2016, by Michael Wetter:
    Corrected error in annotation to enable the pedantic model check in Dymola 2017 FD01 beta 2.
    This is for issue 557.
  • May 2, 2016, by Michael Wetter:
    Refactored implementation of latent heat gain. This is for issue 515.
  • August 7, 2015, by Michael Wetter:
    Revised model to allow modeling of electrochromic windows. This is for issue 445.
  • March 13, 2015, by Michael Wetter:
    Changed model to avoid a translation error in OpenModelica.
  • July 25, 2014, by Michael Wetter:
    Propagated parameter homotopyInitialization.
  • August 1, 2013, by Michael Wetter:
    Introduced this model as a partial base class because the latent heat gains are treated differently in the mixed air and in the CFD model.
  • July 16, 2013, by Michael Wetter:
    Redesigned implementation to remove one level of model hierarchy on the room-side heat and mass balance. This change was done to facilitate the implementation of non-uniform room air heat and mass balance, which required separating the convection and long-wave radiation models.
    Changed assignment solRadExc(tauGla={0.6 for i in 1:NConExtWin}) to solRadExc(tauGla={datConExtWin[i].glaSys.glass[datConExtWin[i].glaSys.nLay].tauSol for i in 1:NConExtWin}) to better take into account the solar properties of the glass.
  • March 7 2012, by Michael Wetter:
    Added optional parameters ove and sidFin to the parameter datConExtWin. This allows modeling windows with an overhang or with side fins.
  • February 8 2012, by Michael Wetter:
    Changed model to use new implementation of Buildings.HeatTransfer.Radiosity.OutdoorRadiosity. This change leads to the use of the same equations for the radiative heat transfer between window and ambient as is used for the opaque constructions.
  • December 12, 2011, by Wangda Zuo:
    Add glass thickness as a parameter for conExtWinRad. It is needed by the claculation of property for uncoated glass.
  • December 6, 2011, by Michael Wetter:
    Fixed bug that caused convective heat gains to be removed from the room instead of added to the room. This error was caused by a wrong sign in Buildings.ThermalZones.Detailed.BaseClasses.MixedAirHeatGain. This closes ticket issue 46.
  • August 9, 2011, by Michael Wetter:
    Fixed bug that caused too high a surface temperature of the window frame. The previous version did not compute the infrared radiation exchange between the window frame and the sky. This has been corrected by adding the instance skyRadExcWin and the parameter absIRFra to the model Buildings.ThermalZones.Detailed.BaseClasses.ExteriorBoundaryConditionsWithWindow. This closes ticket issue 36.
  • August 9, 2011 by Michael Wetter:
    Changed assignment of tilt in instances bouConExt and bouConExtWin. This fixes the bug in issue 35 that led to the wrong solar radiation gain for roofs and floors.
  • March 23, 2011, by Michael Wetter:
    Propagated convection model to exterior boundary condition models.
  • December 14, 2010, by Michael Wetter:
    First implementation.