modelPartialZone

Building zone model
Diagram of PartialZoneOpen the diagram
▶ Check in your browser

Extends from IDEAS.Buildings.Components.Interfaces.ZoneInterface (Partial model for thermal building zones).

Information

Partial model that defines the main variables and connectors of a zone model.

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_computedn50_intComputed n50 value
Modelica.Fluid.Types.DynamicsenergyDynamicsAirModelica.Fluid.Types.Dynamics.FixedInitialType of energy balance for air model: dynamic (3 initialization options) or steady state
Modelica.Units.SI.PowerQInf_design1012*1.204*V/3600*n50_int/n50toAch*(TZon_design - sim.Tdes)Design heat losses from infiltration at reference outdoor temperature
Modelica.Units.SI.PowerQRH_designA*fRHAdditional power required to compensate for the effects of intermittent heating
Modelica.Units.SI.PowerQ_designTotal design heat losses for the zone (including transmission, infiltration, and reheating; excluding ventilation)
IDEAS.Buildings.Components.OccupancyType.OfficeWorkoccTyp
IDEAS.Buildings.Components.RoomType.GenericrooTyp
IDEAS.Buildings.Components.LightingType.NoneligTyp
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
BooleanallowFlowReversaltrue= true to allow flow reversal in zone, false restricts to design direction (port_a -> port_b).
Airflow › Airtightness
Booleanuse_custom_n50sim.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
Realn50sim.n50n50 value for this zone
Realn50toAch20Conversion fractor from n50 to Air Change Rate
Advanced › Air model
RealmSenFac5Correction factor for thermal capacity of zone air.
Advanced › Radiative heat exchange
BooleanlinIntRadsim.linIntRadLinearized computation of long wave radiation
BooleancalculateViewFactorfalseExplicit calculation of view factors: works well only for rectangular zones!
Modelica.Units.SI.TemperatureTzone_nom295.15Nominal zone temperature, used for linearising radiative heat exchange
Modelica.Units.SI.TemperatureDifferencedT_nom-2Nominal temperature difference between zone walls, used for linearising radiative heat exchange
BooleansimVieFacfalseSimplify view factor computation
BooleanignAssfalseIgnore asserts to simulate non-physical unit test models
Advanced › Design heat load
Modelica.Units.SI.TemperatureTZon_design294.15Reference zone temperature for calculation of design heat load
RealfRH11Reheat factor for calculation of design heat load, (EN 12831, table D.10 Annex D)
Initialization
Medium.TemperatureT_startMedium.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.RealOutputTAirairModel.TAir
Modelica.Blocks.Interfaces.RealOutputTRadradDistr.TRad

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
IDEAS.Buildings.Components.InterzonalAirFlow.SiminterzonalAirFlow
IDEAS.Buildings.Components.Occupants.FixedoccNum
IDEAS.Buildings.Components.Comfort.Nonecomfort
IDEAS.Buildings.Components.BaseClasses.RadiativeHeatTransfer.ZoneLwGainDistributionradDistrDistribution of radiative internal gains
IDEAS.Buildings.Components.InternalGains.OccupantsintGaiOcc
IDEAS.Buildings.Components.InternalGains.LightingintGaiLig
Modelica.Units.SI.PowerQTra_designsum(propsBusInt.QTra_design)Total design transmission heat losses for the zone
Modelica.Units.SI.EnergyEairModel.E
IDEAS.Buildings.Components.LightingControl.FixedligCtr
IDEAS.Buildings.Components.BaseClasses.RadiativeHeatTransfer.ZoneLwDistributionViewFactorzoneLwDistributionViewFactor
Modelica.Blocks.Math.AddaddmWatFlowAdd medium substance mass flow rates, typically moisture
Modelica.Blocks.Math.Add[max(Medium.nC, 1)]addCFlowAdd tracer mass flow rates

Contents

NameDescription
Medium
Setq50protectedq50 computation for zones

Revisions

  • August 18, 2025, by Klaas De Jonge:
    Simplified n50_computed to n50_int since the if statement was a duplicate.
  • November 11, 2024 by Lucas Verleyen:
    Change Medium to IDEAS.Media.Air and use 'constrainedby' for Modelica.Media.Interfaces.PartialMedium. This is for #1375.
  • November 7, 2024, by Anna Dell'Isola and Jelger Jansen:
    Add parameter TZon_design to be used when calculating Q_design. See #1337
  • October 30, 2024, by Klaas De Jonge:
    Modifications for interzonal airflow and stack-effect input.
  • April 26, 2024 by Jelger Jansen:
    Added parameter ignAss to ignore view factor asserts for non-physical unit test models. This is for #1272.
  • Februari 18, 2024, by Filip Jorissen:
    Modifications for supporting trickle vents and interzonal airflow.
  • January 8, 2024, by Jelger Jansen:
    Added min attribute to mSenFac. See #1343
  • July 25, 2023, by Filip Jorissen:
    Added conditional inputs for injecting water or CO2. Added output phi for the relative humidity.
  • May 29, 2022, by Filip Jorissen:
    Unprotected component for OM compatibility. See #1254
  • August 10, 2020, by Filip Jorissen:
    Modifications for supporting interzonal airflow. See #1066
  • November 18, 2020, Filip Jorissen:
    Changed default n50 value from 0.4 to 3 and added documentation for n50toAch. See #1181.
  • September 17, 2020, Filip Jorissen:
    Removed Medium declaration. See #1169.
  • July 29, 2020, by Filip Jorissen:
    Removed duplicate definition of hZone and A. See #1158
  • March 17, 2020, Filip Jorissen:
    Added support for vector fluidport. See #1029.
  • April 26, 2020, by Filip Jorissen:
    Refactored SolBus to avoid many instances in PropsBus. See #1131
  • April 26, 2019 by Filip Jorissen:
    Set massDynamics=if interzonalAirFlow.prescribesPressure then Modelica.Fluid.Types.Dynamics.SteadyState such that the state is removed when the pressure is prescribed. See #1021.
  • April 11, 2019 by Filip Jorissen:
    Revised implementation such that default value of relative humidity is used when using a dry air medium. See #1011.
  • January 25, 2019 by Filip Jorissen:
    Avoided redundant consistent initial equation for pressure in airModel. See #971.
  • November 5, 2018 by Filip Jorissen:
    Propagated T_start into radDistr.
  • September 26, 2018 by Iago Cupeiro:
    Implementation of the lighting model See #879.
  • September 24, 2018 by Filip Jorissen:
    Fixed duplicate declaration of V. See #917.
  • July 27, 2018 by Filip Jorissen:
    Added output for the CO2 concentration. See #868.
  • July 11, 2018, Filip Jorissen:
    Propagated m_flow_nominal for setting nominal values of h_outflow and m_flow in FluidPorts. See #859.
  • May 29, 2018, Filip Jorissen:
    Removed conditional fluid ports for JModelica compatibility. See #834.
  • April 27, 2018 by Filip Jorissen:
    Modified interfaces for supporting new interzonal air flow models. See #796.
  • April 12, 2018 by Filip Jorissen:
    Propagated energyDynamicsAir. See issue #800.
  • March 29, 2018 by Filip Jorissen:
    Propagated mSenFac to airModel. See #792.
  • March 28, 2018 by Filip Jorissen:
    Added option for introducing state for radiative temperature.
  • July 26, 2018 by Filip Jorissen:
    Added replaceable block that allows to define the number of occupants. See #760.
  • March 21, 2017, by Filip Jorissen:
    Changed linearisation and conservation of energy implementations for JModelica compatibility. See issue #559.
  • February 1, 2017 by Filip Jorissen:
    Added option for disabling new view factor computation. See issue #663.
  • January 24, 2017 by Filip Jorissen:
    Made radDistr replaceable such that it can be redeclared in experimental models.
  • January 19, 2017 by Filip Jorissen:
    Propagated linearisation parameters for interior radiative heat exchange.
  • 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.