modelTestCell
Extends from Buildings.ThermalZones.Detailed.MixedAir (Model of a room in which the air is completely mixed).
Information
This is a model for test cell 3A in the LBNL User Facility. This model is intended to represent the main space in test cell 3A. This documentation describes the wall constructions used to model test cell X3A. Documentation describing how it is to be combined to other room models to create a model of the full test cell can be found in Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.X3A.
There are 7 different wall sections described in the model. They are shown in the figure below.
The different wall sections are entered into the model according to the following table.
| Wall Section Number | Description | Location in Model | Corresponding Layer |
|---|---|---|---|
| 1 | The west wall is modeled in two parts. One part represents the dividing wall between test cells X3A and X2B. The other part represents a portion of the wall exposed to the ambient conditions. Wall 1 is the section of wall connected to test cell X2B. | datConBou[1] | bedDiv |
| 2 | The west wall is modeled in two parts. One part represents the dividing wall between test cell X3A and test cell X2B. The other part represents a portion of the wall exposed to the ambient conditions. Wall 2 is the section of wall exposed to ambient conditions. | datConExt[4] | bedDiv |
| 3 | This is the north exterior wall of test cell X3A. There are actually two constructions used here. One construction models the wall, the other construction models a door. The area calculation for the wall in the model shows the calculation of the total wall area minus the door area. | Door: datConExt[1]; Wall: datConExt[2] | Door: extDoo; Wall: R16p8Wal |
| 4 | This north wall borders an electrical room. It models the heat transfer between test cell X3A and the externally modeled electrical room. For an example see Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.Examples.X3AWithRadiantFloor. | datConBou[5] | R52Wal |
| 5 | This north wall borders an externally modeled closet. For an example see Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.Examples.X3AWithRadiantFloor. Similar to wall section 3 this wall section contains both a wall construction and a door construction. The wall area calculation shows the total wall area minus the door area. | Door: datConBou[4]; Wall: datConBou[3] | Door: parDoo; Wall: parCon |
| 6 | This east wall connects to test cell UF90X3B. This wall is removable, but this model was developed assuming that the wall is installed. | datConBou[2] | celDiv |
| 7 | This is the south wall of test cell X3A. It includes both a wall construction and windows. The bottoms of the windows are 3 ft above the floor. | datConExtWin[1] | Window: glaSys; Wall: R16p8Wal |
An eigth construction, not shown in the figure, models the ceiling. It is modeled in datConExt[3] using
the layer R20Wal.
The test cell can be configured with several different floor types. The options include radiant conditioning, a slab on grade floor with no conditioning, or a raised floor. Because of this uncertainty in floor design, a model of the floor itself is not included in this model. The user must include a model for the floor in any applications of this model.
Several of the connections in this model are intended to be connected to specific surfaces in other room models. The following table describes the connections to models outside of the X3A package. The connections in datConExt are not described in the table because they are connected to the external environment, and no additional heat port connections are necessary. A rationale for why the model is created this way is also provided if it is considered necessary.
| Location in TestCell | Description of External Connection | Location in External Model | Rationale |
|---|---|---|---|
| surf_conBou[1] | Temperature of test cell X2B | References a data table | A data table is used, instead of a model of test cell X2B, because the goal of this model is to be able to perform simulations of TestCell with minimal complexity, by simplifying the neighboring test cells. The wall separating the test beds is highly insulated, and it is believed that the error in simulations caused by using a data table will be negligible. |
| surf_conBou[2] | Temperature of test cell X3B | References a data table | See rationale for surf_ConBou[1] |
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 |
| Data.Constructions.OpaqueConstructions.ExteriorConstructions.Construction10and23 | R16p8Wal | ||
| Data.Constructions.OpaqueConstructions.DividingWalls.CellAndElectricalDividingWall | R52Wal | ||
| Data.Constructions.OpaqueConstructions.Roofs.ASHRAE_901_2010Roof | R20Wal | ||
| Data.Constructions.GlazingSystems.ASHRAE901Gla | glaSys | ||
| Data.Constructions.OpaqueConstructions.PartitionConstructions.PartitionWall | parCon | ||
| Data.Constructions.OpaqueConstructions.DividingWalls.TestCellDividngWall | celDiv | Construction of wall connecting to cell UF90X3B | |
| Data.Constructions.OpaqueConstructions.DividingWalls.TestBedDividingWall | bedDiv | Construction of wall connecting to cell UF90X2B | |
| Data.Constructions.OpaqueConstructions.PartitionConstructions.PartitionDoor | parDoo | Door used in partition walls in FLEXLAB test cells | |
| Data.Constructions.OpaqueConstructions.ExteriorConstructions.ExteriorDoorInsulated | extDoo | Construction of an exterior door | |
| 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 (from MixedAir) | 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 (from MixedAir) | Modelica.Fluid.Types.Dynamics.DynamicFreeInitial | Type of energy balance for zone air: dynamic (3 initialization options) or steady state |
| Real | mSenFac (from MixedAir) | 1 | Factor for scaling the sensible thermal mass of the zone air volume |
| Initialization | |||
| Medium.AbsolutePressure | p_start (from MixedAir) | Medium.p_default | Start value of zone air pressure |
| Medium.Temperature | T_start (from MixedAir) | Medium.T_default | Start value of zone air temperature |
| Medium.MassFraction[Medium.nX] | X_start (from MixedAir) | Medium.X_default | Start value of zone air mass fractions m_i/m |
| Medium.ExtraProperty[Medium.nC] | C_start (from MixedAir) | fill(0, Medium.nC) | Start value of zone air trace substances |
| Medium.ExtraProperty[Medium.nC] | C_nominal (from MixedAir) | 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 (from MixedAir) | Control signal for the shading device (removed if no shade is present) | |
| Modelica.Blocks.Interfaces.RealInput[Medium.nC] | C_flow (from MixedAir) | Trace substance mass flow rate added to the room air. Enable if use_C_flow = true | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[NConExtWin] | HGlo (from MixedAir) | Global solar irradiance | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[NConExtWin] | QTraGlo (from MixedAir) | Transmitted global solar radiation |
Components
Revisions
- Jun 10, 2013 by Peter Grant:
First implementation.