modelZone

Building zone model

Extends from IDEAS.Buildings.Components.Interfaces.PartialZone (Building zone model).

Information

This model is the main zone model. Surfaces such as windows and walls can be connectured using the propsBus connectors and HVAC can be connected using FluidPorts. The model contains models or options for radiative heat exchange, internal heat gains, interzonal air exchange and a zone air model.

Typical use and important parameters

Any number of surfaces can be connected to the propsbus of a zone. The number of connected surfaces must be specified using the parameter nSurf and each of the nSurf propsbus components has to be connected to exactly one surface.

Parameter V must be used to define the total zone air volume.

Parameter hZone is the zone height, which may be used to define the zone geometry.

Parameter A is the total floor surface area of the zone.

Replaceable parameter airModel determines the type of air model that is used.

Replaceable model occNum allows the user to choose a way to define the number of occupants that are present in the zone. This number of occupants is used to compute the internal heat gains in the model. Depending on the chosen model, an external input yOcc may be exposed by the zone model.

Parameter occTyp determines occupants properties. These properties may be used to evaluate internal comfort, or to determine internal gains.

Parameter comfort determines how occupant comfort may be computed.

Options

Parameter intGai determines internal gains model type. By default the internal gains model considers a fixed sensible and latent heat load and CO2 production per person.

Parameter simVieFac may be set to false to simplify the view factor calculation. This leads to a less accurate computation of view factors, but this approach is more robust. It may be used when the initial equation that computes the view factors does not converge.

Replaceable model interzonalAirFlow allows to choose between multiple options for modelling air leakage and interzonal airflow. This model can have a strong influence on numerics and on model results if used inappropliately, therefore only change the default value if you know what you are doing.

The lighting options allow to compute the thermal heat gains originating in the zone lighting. We assume that electric power use is converted for 100 % into heat gains. The record rooType determines the type of room, and the typical illuminance that corresponds to such a room type. The record ligTyp determines what kind of lighting device is used, which contains the lighting efficacy of the device, i.e. how much electric power is required per square meter of lighted zone. We assume that the zone is lighted completely. The model ligCtr determines how the lighting is controlled. See IDEAS.Buildings.Components.LightingControl for the available options.

The design heat losses Q_design are calculated via an initial equation based on, but not exactly according to, NBN EN 12831-1 ANB:2020. This value includes heat losses via transmission (QTra_design) and infiltration (QInf_design) and accounts for reheating (QRH_design). Ventilation losses are not considered as this system is typically modelled in a seperate block, see for example IDEAS.Templates.Interfaces.Building. In this model, the total design losses are calculated as the sum of the design losses from the building envelope (transmission, infiltration, reheating) and the ventilation system.

Parameters

TypeNameDefaultDescription
IntegernSurf (from ZoneInterface)Number of surfaces adjacent to and heat exchanging with the zone
IntegernPorts (from ZoneInterface)2Number of ports for ventilation connections
Realn50_computed (from PartialZone)n50_intComputed n50 value
Modelica.Fluid.Types.DynamicsenergyDynamicsAir (from PartialZone)Modelica.Fluid.Types.Dynamics.FixedInitialType of energy balance for air model: dynamic (3 initialization options) or steady state
Modelica.Units.SI.PowerQInf_design (from PartialZone)1012*1.204*V/3600*n50_int/n50toAch*(TZon_design - sim.Tdes)Design heat losses from infiltration at reference outdoor temperature
Modelica.Units.SI.PowerQRH_design (from PartialZone)A*fRHAdditional power required to compensate for the effects of intermittent heating
Modelica.Units.SI.PowerQ_design (from PartialZone)Total design heat losses for the zone (including transmission, infiltration, and reheating; excluding ventilation)
IDEAS.Buildings.Components.OccupancyType.OfficeWorkoccTyp (from PartialZone)
IDEAS.Buildings.Components.RoomType.GenericrooTyp (from PartialZone)
IDEAS.Buildings.Components.LightingType.NoneligTyp (from PartialZone)
Building physics
Modelica.Units.SI.VolumeV (from ZoneInterface)Total zone air volume
Modelica.Units.SI.LengthhZone (from ZoneInterface)2.8Zone height: distance between floor and ceiling
Modelica.Units.SI.LengthhFloor (from ZoneInterface)0Absolute height of zone floor
Modelica.Units.SI.AreaA (from ZoneInterface)V/hZoneTotal conditioned floor area
Advanced › Occupants
BooleanuseOccNumInput (from ZoneInterface)=false, to remove icon of yOcc
Advanced › Sources
BooleanuseWatFlowInput (from ZoneInterface)false=true, to enable an input for injecting water vapor into a zone
BooleanuseCFlowInput (from ZoneInterface)false=true, to enable an input for injecting CO2 into a zone
Advanced › Lighting
BooleanuseLigCtrInput (from ZoneInterface)=false, to remove icon of lightCtrl
Airflow › Air model
Modelica.Units.SI.MassFlowRatem_flow_nominal (from ZoneInterface)V*1.2*2/3600Nominal flow rate of the air flow system fluid ports
BooleanallowFlowReversal (from PartialZone)true= true to allow flow reversal in zone, false restricts to design direction (port_a -> port_b).
Airflow › Airtightness
Booleanuse_custom_n50 (from PartialZone)sim.interZonalAirFlowType == IDEAS.BoundaryConditions.Types.InterZonalAirFlow.None and not sim.unify_n50if true, a custom n50 value is used instead of a globally computed n50 value
Realn50 (from PartialZone)sim.n50n50 value for this zone
Realn50toAch (from PartialZone)20Conversion fractor from n50 to Air Change Rate
Advanced › Air model
RealmSenFac (from PartialZone)5Correction factor for thermal capacity of zone air.
Advanced › Radiative heat exchange
BooleanlinIntRad (from PartialZone)sim.linIntRadLinearized computation of long wave radiation
BooleancalculateViewFactor (from PartialZone)falseExplicit calculation of view factors: works well only for rectangular zones!
Modelica.Units.SI.TemperatureTzone_nom (from PartialZone)295.15Nominal zone temperature, used for linearising radiative heat exchange
Modelica.Units.SI.TemperatureDifferencedT_nom (from PartialZone)-2Nominal temperature difference between zone walls, used for linearising radiative heat exchange
BooleansimVieFac (from PartialZone)falseSimplify view factor computation
BooleanignAss (from PartialZone)falseIgnore asserts to simulate non-physical unit test models
Advanced › Design heat load
Modelica.Units.SI.TemperatureTZon_design (from PartialZone)294.15Reference zone temperature for calculation of design heat load
RealfRH (from PartialZone)11Reheat factor for calculation of design heat load, (EN 12831, table D.10 Annex D)
Initialization
Medium.TemperatureT_start (from PartialZone)Medium.T_defaultStart value of temperature

Connectors

TypeNameDefaultDescription
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_bgainRad (from ZoneInterface)Internal zone node for radiative heat gains
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_againCon (from ZoneInterface)Internal zone node for convective heat gains
Modelica.Blocks.Interfaces.RealOutputTSensor (from ZoneInterface)Sensor temperature of the zone, i.e. operative temeprature
Modelica.Fluid.Interfaces.FluidPort_bport_b (from ZoneInterface)Port for ventilation connections, deprecated, use 'ports' instead
Modelica.Fluid.Interfaces.FluidPort_aport_a (from ZoneInterface)Port for ventilation connections, deprecated, use 'ports' instead
Modelica.Blocks.Interfaces.RealInputyOcc (from ZoneInterface)Control input for number of occupants, used by Occupants.Input and Occupants.AreaWeightedInput
Modelica.Blocks.Interfaces.RealInputmWat_flow (from ZoneInterface)Input for injecting water vapor into a zone
Modelica.Blocks.Interfaces.RealInputC_flow (from ZoneInterface)Input for injecting CO2 into a zone
Modelica.Blocks.Interfaces.RealInputuLig (from ZoneInterface)Lighting control input (1 corresponds to 100%), only used when using LightingControl.Input
Modelica.Blocks.Interfaces.RealOutputppm (from ZoneInterface)CO2 concentration in the zone
Modelica.Blocks.Interfaces.RealOutputphi (from ZoneInterface)Relative humidity in the zone [0-1]
Modelica.Fluid.Interfaces.FluidPorts_a[nPorts]ports (from ZoneInterface)Ports for ventilation connetions
Modelica.Blocks.Interfaces.RealOutputTAir (from PartialZone)airModel.TAir
Modelica.Blocks.Interfaces.RealOutputTRad (from PartialZone)radDistr.TRad
IDEAS.Buildings.Components.Interfaces.ZoneBuspropsBus

Components

TypeNameDefaultDescription
IDEAS.BoundaryConditions.SimInfoManagersim (from ZoneInterface)Simulation information manager for climate data
SetVolumesetVolume (from ZoneInterface)Component for contributing zone volume to siminfomanager
ZoneAirModels.WellMixedAirairModel (from PartialZone)
IDEAS.Buildings.Components.InterzonalAirFlow.SiminterzonalAirFlow (from PartialZone)
IDEAS.Buildings.Components.Occupants.FixedoccNum (from PartialZone)
IDEAS.Buildings.Components.Comfort.Nonecomfort (from PartialZone)
IDEAS.Buildings.Components.BaseClasses.RadiativeHeatTransfer.ZoneLwGainDistributionradDistr (from PartialZone)Distribution of radiative internal gains
IDEAS.Buildings.Components.InternalGains.OccupantsintGaiOcc (from PartialZone)
IDEAS.Buildings.Components.InternalGains.LightingintGaiLig (from PartialZone)
Modelica.Units.SI.PowerQTra_design (from PartialZone)sum(propsBusInt.QTra_design)Total design transmission heat losses for the zone
Modelica.Units.SI.EnergyE (from PartialZone)airModel.E
IDEAS.Buildings.Components.LightingControl.FixedligCtr (from PartialZone)
IDEAS.Buildings.Components.BaseClasses.RadiativeHeatTransfer.ZoneLwDistributionViewFactorzoneLwDistributionViewFactor (from PartialZone)
Modelica.Blocks.Math.AddaddmWatFlow (from PartialZone)Add medium substance mass flow rates, typically moisture
Modelica.Blocks.Math.Add[max(Medium.nC, 1)]addCFlow (from PartialZone)Add tracer mass flow rates

Revisions

  • August 10, 2020, by Filip Jorissen:
    Modifications for supporting interzonal airflow. See #1066
  • October 13, 2019 by Filip Jorissen:
    Added number of surfaces in the zone icon. for #1068.
  • March 28, 2019 by Filip Jorissen:
    Revised documentation for #998.
  • July 26, 2018 by Filip Jorissen:
    Added replaceable block that allows to define the number of occupants. See #760.
  • October 22, 2016, by Filip Jorissen:
    Revised documentation for IDEAS 1.0.
  • August 26, 2016 by Filip Jorissen:
    Added support for conservation of energy of air model.
  • April 30, 2016, by Filip Jorissen:
    Added replaceable air model implementation.
  • March, 2015, by Filip Jorissen:
    Added view factor implementation.