modelMixedAir
Model of a room in which the air is completely mixed
Extends from Buildings.ThermalZones.Detailed.BaseClasses.RoomHeatMassBalance (Base model for a room).
Information
Room model that assumes the air to be completely mixed.
See Buildings.ThermalZones.Detailed.UsersGuide for detailed explanations.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | NConExt (from ConstructionNumbers) | max(1, nConExt) | Number of elements for exterior constructions |
| Integer | NConExtWin (from ConstructionNumbers) | max(1, nConExtWin) | Number of elements for exterior constructions with windows |
| Integer | NConPar (from ConstructionNumbers) | max(1, nConPar) | Number of elements for partition constructions |
| Integer | NConBou (from ConstructionNumbers) | max(1, nConBou) | Number of elements for constructions that have their outside surface exposed to the boundary of this room |
| Integer | NSurBou (from ConstructionNumbers) | max(1, nSurBou) | Number of elements for surface heat transfer models that connect to constructions that are modeled outside of this room |
| Boolean | haveConExt (from ConstructionNumbers) | nConExt > 0 | Flag to conditionally remove components |
| Boolean | haveConExtWin (from ConstructionNumbers) | nConExtWin > 0 | Flag to conditionally remove components |
| Boolean | haveConPar (from ConstructionNumbers) | nConPar > 0 | Flag to conditionally remove components |
| Boolean | haveConBou (from ConstructionNumbers) | nConBou > 0 | Flag to conditionally remove components |
| Boolean | haveSurBou (from ConstructionNumbers) | nSurBou > 0 | Flag 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.Brick120 | dummyCon (from ConstructionRecords) | Dummy construction to assign a parameter to the instance | |
| Buildings.HeatTransfer.Data.GlazingSystems.SingleClear3 | dummyGlaSys (from ConstructionRecords) | Dummy construction to assign a parameter to the instance | |
| Boolean | homotopyInitialization (from RoomHeatMassBalance) | true | = true, use homotopy method |
| Modelica.Units.SI.Volume | V (from RoomHeatMassBalance) | AFlo*hRoo | Volume |
| Modelica.Units.SI.Area | AFlo (from RoomHeatMassBalance) | Floor area | |
| Modelica.Units.SI.Length | hRoo (from RoomHeatMassBalance) | Average room height | |
| Boolean | linearizeRadiation (from RoomHeatMassBalance) | true | Set to true to linearize emissive power |
| Exterior constructions | |||
| Integer | nConExt (from ConstructionNumbers) | Number of exterior constructions | |
| Integer | nConExtWin (from ConstructionNumbers) | Number of window constructions | |
| Partition constructions | |||
| Integer | nConPar (from ConstructionNumbers) | Number of partition constructions | |
| Boundary constructions | |||
| Integer | nConBou (from ConstructionNumbers) | Number of constructions that have their outside surface exposed to the boundary of this room | |
| Integer | nSurBou (from ConstructionNumbers) | Number of surface heat transfer models that connect to constructions that are modeled outside of this room | |
| General › Ports | |||
| Integer | nPorts (from RoomHeatMassBalance) | 0 | Number of ports |
| Dynamics › Glazing system | |||
| Boolean | steadyStateWindow (from RoomHeatMassBalance) | false | Set to false to add thermal capacity at window, which generally leads to faster simulation |
| Convective heat transfer | |||
| Buildings.HeatTransfer.Types.InteriorConvection | intConMod (from RoomHeatMassBalance) | Buildings.HeatTransfer.Types.InteriorConvection.Temperature | Convective heat transfer model for room-facing surfaces of opaque constructions |
| Modelica.Units.SI.CoefficientOfHeatTransfer | hIntFixed (from RoomHeatMassBalance) | 3.0 | Constant convection coefficient for room-facing surfaces of opaque constructions |
| Buildings.HeatTransfer.Types.ExteriorConvection | extConMod (from RoomHeatMassBalance) | Buildings.HeatTransfer.Types.ExteriorConvection.TemperatureWind | Convective heat transfer model for exterior facing surfaces of opaque constructions |
| Modelica.Units.SI.CoefficientOfHeatTransfer | hExtFixed (from RoomHeatMassBalance) | 10.0 | Constant convection coefficient for exterior facing surfaces of opaque constructions |
| Nominal condition | |||
| Modelica.Units.SI.MassFlowRate | m_flow_nominal (from RoomHeatMassBalance) | V*1.2/3600 | Nominal mass flow rate |
| Experimental (may be changed in future releases) | |||
| Boolean | sampleModel (from RoomHeatMassBalance) | false | Set to true to time-sample the model, which can give shorter simulation time if there is already time sampling in the system model |
| Ports | |||
| Boolean | use_C_flow | false | Set to true to enable input connector for trace substance that is connected to room air |
| Dynamics › Zone air | |||
| Modelica.Fluid.Types.Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamics.DynamicFreeInitial | Type of energy balance for zone air: dynamic (3 initialization options) or steady state |
| Real | mSenFac | 1 | Factor for scaling the sensible thermal mass of the zone air volume |
| Initialization | |||
| Medium.AbsolutePressure | p_start | Medium.p_default | Start value of zone air pressure |
| Medium.Temperature | T_start | Medium.T_default | Start value of zone air temperature |
| Medium.MassFraction[Medium.nX] | X_start | Medium.X_default | Start value of zone air mass fractions m_i/m |
| Medium.ExtraProperty[Medium.nC] | C_start | fill(0, Medium.nC) | Start value of zone air trace substances |
| Medium.ExtraProperty[Medium.nC] | C_nominal | fill(1E-2, Medium.nC) | Nominal value of zone air trace substances. (Set to typical order of magnitude.) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Fluid.Vessels.BaseClasses.VesselFluidPorts_b[nPorts] | ports (from RoomHeatMassBalance) | Fluid inlets and outlets | |
| Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a | heaPorAir (from RoomHeatMassBalance) | Heat port to air volume | |
| Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a | heaPorRad (from RoomHeatMassBalance) | Heat port for radiative heat gain and radiative temperature | |
| Modelica.Blocks.Interfaces.RealInput[nConExtWin] | uWin (from RoomHeatMassBalance) | Control signal for window state (used for electrochromic windows, removed otherwise) | |
| Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[nConBou] | surf_conBou (from RoomHeatMassBalance) | Heat port at surface b of construction conBou | |
| Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a[nSurBou] | surf_surBou (from RoomHeatMassBalance) | Heat port of surface that is connected to the room air | |
| Modelica.Blocks.Interfaces.RealInput[3] | qGai_flow (from RoomHeatMassBalance) | Radiant, convective and latent heat input into room (positive if heat gain) | |
| BoundaryConditions.WeatherData.Bus | weaBus (from RoomHeatMassBalance) | Weather data | |
| Modelica.Blocks.Interfaces.RealInput[nConExtWin] | uSha | Control signal for the shading device (removed if no shade is present) | |
| Modelica.Blocks.Interfaces.RealInput[Medium.nC] | C_flow | Trace substance mass flow rate added to the room air. Enable if use_C_flow = true | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[NConExtWin] | HGlo | Global solar irradiance | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[NConExtWin] | QTraGlo | Transmitted global solar radiation |
Components
Contents
| Name | Description |
|---|---|
| Medium in the component |
Revisions
-
March 3, 2022, by Michael Wetter:
MademassDynamicsfinal.
This is for issue 1542. -
September 16, 2021, by Michael Wetter:
Removed parameterlatbecause the latitude is now obtained from the weather data bus.
This is for IBPSA, #1477. -
April 8, 2019, by Michael Wetter:
Propagated parametermSenFac.
This is for issue Buildings #1405. -
September 8, 2017, by Michael Wetter:
Enabled input connectorC_flowto allow adding trace substances.
This is for issue 481. -
October 29, 2016, by Michael Wetter:
Removed inheritance from Buildings.Fluid.Interfaces.LumpedVolumeDeclarations to provide better comments. -
May 2, 2016, by Michael Wetter:
Refactored implementation of latent heat gain. This is for issue 515. -
February 12, 2015, by Michael Wetter:
Propagated initial states to the fluid volume. -
August 1, 2013, by Michael Wetter:
Introduced base class Buildings.ThermalZones.Detailed.BaseClasses.RoomHeatMassBalance as 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 assignmentsolRadExc(tauGla={0.6 for i in 1:NConExtWin})tosolRadExc(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 parametersoveandsidFinto the parameterdatConExtWin. 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.HeatGain. 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 instanceskyRadExcWinand the parameterabsIRFrato the model Buildings.ThermalZones.Detailed.BaseClasses.ExteriorBoundaryConditionsWithWindow. This closes ticket issue 36. -
August 9, 2011 by Michael Wetter:
Changed assignment of tilt in instancesbouConExtandbouConExtWin. 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.