modelCFD

Model of a room in which the air is computed using Computational Fluid Dynamics (CFD)

Extends from Buildings.ThermalZones.Detailed.BaseClasses.RoomHeatMassBalance (Base model for a room).

Information

Room model that computes the room air flow using computational fluid dynamics (CFD). The CFD simulation is coupled to the thermal simulation of the room and, through the fluid port, to the air conditioning system.

Currently, the supported CFD program is the Fast Fluid Dynamics (FFD) program (Zuo 2010). See Buildings.ThermalZones.Detailed.UsersGuide for detailed explanations.

References

Wangda Zuo. Advanced simulations of air distributions in buildings. Ph.D. Thesis, School of Mechanical Engineering, Purdue University, 2010.

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
BooleanhomotopyInitialization (from RoomHeatMassBalance)true= true, use homotopy method
Modelica.Units.SI.VolumeV (from RoomHeatMassBalance)AFlo*hRooVolume
Modelica.Units.SI.AreaAFlo (from RoomHeatMassBalance)Floor area
Modelica.Units.SI.LengthhRoo (from RoomHeatMassBalance)Average room height
BooleanlinearizeRadiation (from RoomHeatMassBalance)trueSet to true to linearize emissive power
Real[nConExtWin]uSha_fixedzeros(nConExtWin)Constant control signal for the shading device (0: unshaded; 1: fully shaded)
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 RoomHeatMassBalance)0Number of ports
Dynamics › Glazing system
BooleansteadyStateWindow (from RoomHeatMassBalance)falseSet to false to add thermal capacity at window, which generally leads to faster simulation
Convective heat transfer
Buildings.HeatTransfer.Types.InteriorConvectionintConMod (from RoomHeatMassBalance)Buildings.HeatTransfer.Types.InteriorConvection.TemperatureConvective heat transfer model for room-facing surfaces of opaque constructions
Modelica.Units.SI.CoefficientOfHeatTransferhIntFixed (from RoomHeatMassBalance)3.0Constant convection coefficient for room-facing surfaces of opaque constructions
Buildings.HeatTransfer.Types.ExteriorConvectionextConMod (from RoomHeatMassBalance)Buildings.HeatTransfer.Types.ExteriorConvection.TemperatureWindConvective heat transfer model for exterior facing surfaces of opaque constructions
Modelica.Units.SI.CoefficientOfHeatTransferhExtFixed (from RoomHeatMassBalance)10.0Constant convection coefficient for exterior facing surfaces of opaque constructions
Nominal condition
Modelica.Units.SI.MassFlowRatem_flow_nominal (from RoomHeatMassBalance)V*1.2/3600Nominal mass flow rate
Experimental (may be changed in future releases)
BooleansampleModel (from RoomHeatMassBalance)falseSet to true to time-sample the model, which can give shorter simulation time if there is already time sampling in the system model
Dynamics › Conservation equations
Modelica.Fluid.Types.DynamicsmassDynamicsModelica.Fluid.Types.Dynamics.DynamicFreeInitialFormulation of mass balance
Initialization
Medium.AbsolutePressurep_startMedium.p_defaultStart value of pressure
CFD
BooleanuseCFDtrueSet to false to deactivate the CFD computation and use instead yFixed as output
String[:]sensorNameNames of sensors as declared in the CFD input file
String[nPorts]portName{"port_" + String(i) for i in 1:nPorts}Names of fluid ports as declared in the CFD input file
StringcfdFilNamCFD input file name
Sampling
Modelica.Units.SI.TimesamplePeriodSample period of component

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Vessels.BaseClasses.VesselFluidPorts_b[nPorts]ports (from RoomHeatMassBalance)Fluid inlets and outlets
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_aheaPorAir (from RoomHeatMassBalance)Heat port to air volume
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_aheaPorRad (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.BusweaBus (from RoomHeatMassBalance)Weather data
Modelica.Blocks.Interfaces.RealOutput[nSen]yCFDSensor for output from CFD

Components

TypeNameDefaultDescription
Constructions.Construction[NConExt]conExt (from RoomHeatMassBalance)Heat conduction through exterior construction that have no window
Constructions.ConstructionWithWindow[NConExtWin]conExtWin (from RoomHeatMassBalance)Heat conduction through exterior construction that have a window
Constructions.Construction[NConPar]conPar (from RoomHeatMassBalance)Heat conduction through partitions that have both sides inside the thermal zone
Constructions.Construction[NConBou]conBou (from RoomHeatMassBalance)Heat conduction through opaque constructions that have the boundary conditions of the other side exposed
BaseClasses.ExteriorBoundaryConditionsbouConExt (from RoomHeatMassBalance)Exterior boundary conditions for constructions without a window
BaseClasses.ExteriorBoundaryConditionsWithWindowbouConExtWin (from RoomHeatMassBalance)Exterior boundary conditions for constructions with a window
HeatTransfer.Windows.BaseClasses.WindowRadiation[NConExtWin]conExtWinRad (from RoomHeatMassBalance)Model for solar radiation through shades and window
BaseClasses.PartialAirHeatMassBalanceair (from RoomHeatMassBalance)
Buildings.ThermalZones.Detailed.BaseClasses.SolarRadiationExchangesolRadExc (from RoomHeatMassBalance)Solar radiative heat exchange
Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationGainDistributionirRadGai (from RoomHeatMassBalance)Distribution for infrared radiative heat gains (e.g., due to equipment and people)
Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationExchangeirRadExc (from RoomHeatMassBalance)Infrared radiative heat exchange
Buildings.ThermalZones.Detailed.BaseClasses.RadiationTemperatureradTem (from RoomHeatMassBalance)Radiative temperature of the room
HeatTransfer.Windows.BaseClasses.ShadeRadiation[NConExtWin]shaRad (from RoomHeatMassBalance)Radiation model for room-side window shade

Revisions