modelPartialSimInfoManager

Partial providing structure for SimInfoManager

Information

Parameters

TypeNameDefaultDescription
StringfilNamModelica.Utilities.Files.loadResource("modelica://IDEAS/Resources/weatherdata/BEL_VLG_Uccle.064470_TMYx.2007-2021.mos")File name of TMY3 weather file
Modelica.Units.SI.TimetimZonweaDat.timZonTime zone for which the simulation time t=0 corresponds to midnight, january 1st
Modelica.Units.SI.Angle[5]aziOpts{incS, incW, incN, incE, incS}Inclination options, default south
Modelica.Units.SI.Angle[4]incOpts{IDEAS.Types.Tilt.Wall, IDEAS.Types.Tilt.Floor, IDEAS.Types.Tilt.Ceiling, IDEAS.Types.Tilt.Wall}Azimuth options, default wall
Booleanuse_port_1interZonalAirFlowType <> IDEAS.BoundaryConditions.Types.InterZonalAirFlow.NoneWhether port_1 of the propsbus connector should be used
Booleanuse_port_2interZonalAirFlowType == IDEAS.BoundaryConditions.Types.InterZonalAirFlow.TwoPortsWhether port_2 of the propsbus connector should be used
Modelica.Units.SI.TemperatureTenv_nom280Nominal ambient temperature, only used when linearising equations
IntegernumIncAndAziInBussize(incAndAziInBus, 1)Number of pre-computed azimuth
Modelica.Units.SI.TemperatureTdes-8 + 273.15design outdoor temperature
Modelica.Units.SI.TemperatureTdesGround10 + 273.15design ground temperature
RealV50_defV50 - V50_customCorrected V50 value, default for surfaces without custom assignment.
RealV50V_tot*n50V50 value assuming no custom v50 values.
Realq50_defif A_def < Modelica.Constants.small then q50_av else V50_def/A_def
Realq50_avif A_tot < Modelica.Constants.small then 0 else V50/A_totaverage, not corrected q50
Modelica.Units.SI.VolumeV_totTotal conditioned building volume
Modelica.Units.SI.AreaA_totTotal surface area of OuterWalls and Windows
RealV50_customSum of v50 values for components that have a custom assignment
Modelica.Units.SI.AreaA_defTotal area with default q50, i.e. without custom q50 assignment, or connected to zone with custom n50 assigned
Advanced
Modelica.Units.SI.AnglelatweaDat.latLatitude of the location
Modelica.Units.SI.AnglelonweaDat.lonLongitude of the location
Incidence angles
Modelica.Units.SI.AngleincSIDEAS.Types.Azimuth.SSouth inclination
Modelica.Units.SI.AngleincWincS + Modelica.Constants.pi/2West inclination
Modelica.Units.SI.AngleincNincS + Modelica.Constants.piNorth inclination
Modelica.Units.SI.AngleincEincS + 3*Modelica.Constants.pi/2East inclination
Modelica.Units.SI.Angle[:,:]incAndAziInBus{{IDEAS.Types.Tilt.Ceiling, 0}, {IDEAS.Types.Tilt.Wall, incS}, {IDEAS.Types.Tilt.Wall, incW}, {IDEAS.Types.Tilt.Wall, incN}, {IDEAS.Types.Tilt.Wall, incE}, {IDEAS.Types.Tilt.Floor, 0}}Combination of inclination and azimuth which are pre-computed and added to solBus.
Conservation of energy
BooleancomputeConservationOfEnergyfalseAdd equations for verifying conservation of energy
BooleanstrictConservationOfEnergyfalseThis adds an assert statement to make sure that energy is conserved
BooleanopenSystemConservationOfEnergyfalseCompute conservation of energy for open system
Modelica.Units.SI.EnergyEmax1Error bound for violation of conservation of energy
Linearisation
BooleanlineariseDymolafalseLinearises building model equations for Dymola linearisation approach
BooleanlineariseJModelicafalseLinearises building model equations for optimisations in JModelica
BooleancreateOutputsfalseCreates output connections when linearising windows
BooleanoutputAnglesnot lineariseDymolaOutput angles in weaBus. Set to false when linearising
IntegernWindow1Number of windows in the to be linearised model
IntegernLayWin3Number of window layers in the to be linearised model; should be maximum of all windows
BooleanlineariselineariseDymola or lineariseJModelicaLinearises building model equations
Linearisation › Convection
BooleanlinIntConfalse= true, if interior convective heat transfer should be linearised
BooleanlinExtConfalse= true, if exterior convective heat transfer should be linearised (uses average wind speed)
Linearisation › Radiation
BooleanlinIntRadtrue= true, if interior radiative heat transfer should be linearised
BooleanlinExtRadfalse= true, if exterior radiative heat transfer for walls should be linearised
BooleanlinExtRadWintrue= true, if exterior radiative heat transfer for windows should be linearised
Advanced › CO2
RealppmCO2400Default CO2 concentration in [ppm] when using air medium containing CO2
Interzonal airflow
IDEAS.BoundaryConditions.Types.InterZonalAirFlowinterZonalAirFlowTypeIDEAS.BoundaryConditions.Types.InterZonalAirFlow.NoneType of interzonal air flow model
Booleanunify_n50falseif true, zone n50 values are merged and then redistributed across al zones even if interZonalAirFlowType==None
Realn503n50 value of zones
Wind
Booleanuse_sim_Cstrueif checked, the default Cs of each surface in the building is sim.Cs
IDEAS.BoundaryConditions.Types.LocalTerrainlocTerIDEAS.BoundaryConditions.Types.LocalTerrain.UnshieldedSelection of local terrain
Reala_custom0.14Custom velocity profile exponent
RealA0_custom1.0Custom local terrain coefficient
Realaif locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Unshielded then 0.14 elseif locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Suburban then 0.22 elseif locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Urban then 0.33 else a_customVelocity profile exponent
Modelica.Units.SI.Lengthdeltaif locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Unshielded then 270 elseif locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Suburban then 370 elseif locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Urban then 460 else 0Wind boundary layer thickness
RealA0if locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Custom then A0_custom else (270/Hwind)^0.14*(Hwind/delta)^aLocal terrain coefficient
Modelica.Units.SI.LengthH10Building or roof height
Modelica.Units.SI.LengthHwind10Height above ground of meteorological wind speed measurement
Modelica.Units.SI.LengthHPres1Height above ground of meteorological atmospheric pressure measurement
RealCs_coeff(A0*A0)*((1/Hwind)^(2*a))Multiplication factor for wind speed modifier Cs
RealCsCs_coeff*(H^(2*a))Wind speed modifier

Connectors

TypeNameDefaultDescription
IDEAS.Buildings.Components.Interfaces.WeaBusweaBus
Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_aQgaiThermal gains in model
IDEAS.Buildings.Components.BaseClasses.ConservationOfEnergy.EnergyPortEModel internal energy
IDEAS.Buildings.Components.Interfaces.WindowBuswinBusOutBus for windows in case of linearisation
IDEAS.BoundaryConditions.WeatherData.BusweaDatBusWeather data bus connectable to weaBus connector from Buildings Library
Buildings.Components.Interfaces.VolumePortvolumePortPort for summing volumes of all zones
Buildings.Components.Interfaces.AreaPortareaPortPort for summing surface areas of all surfaces

Components

TypeNameDefaultDescription
Modelica.Units.SI.TemperatureTeambient outdoor temperature for determination of sky radiation exchange
Modelica.Units.SI.TemperatureTskyeffective overall sky temperature
Modelica.Units.SI.TemperatureTeAvrunning average of ambient outdoor temperature of the last 5 days, not yet implemented
Modelica.Units.SI.TemperatureTgroundground temperature
Modelica.Units.SI.VelocityVawind speed
Modelica.Units.SI.AngleVdirwind direction
RealrelHumRelative humidity
Modelica.Units.SI.TemperatureTDewPoiDewpoint
Modelica.Units.SI.EnergyEtotTotal internal energy
Modelica.Units.SI.EnergyQintTotal energy from boundary
IDEAS.Utilities.Psychrometrics.X_pTphiXiEnv
IDEAS.BoundaryConditions.SolarIrradiation.ShadedRadSolradSolModel for computing solar irradiation and properties of predefined set of tilted surfaces
Modelica.Blocks.Sources.RealExpressionTskyPow4ExprPower 4 of sky temperature
Modelica.Blocks.Sources.RealExpressionTePow4ExprPower 4 of ambient temperature
Modelica.Blocks.Sources.RealExpressionTdesExprExpression for design temperature
Modelica.Thermal.HeatTransfer.Sources.FixedTemperaturefixedTemperatureFixed temperature
Modelica.Blocks.Sources.RealExpressionCEnvConcentration of trace substance in surroundings
Modelica.Blocks.Routing.RealPassThroughsolTimSolar time
Modelica.Blocks.Routing.RealPassThroughaltAltitude

Revisions

  • July 9, 2025, by Jelger Jansen:
    Update wind speed modifier calculation according to ASHRAE2005 and change the default local terrain type to unshielded. See #1340.
  • October 30, 2024, by Klaas De Jonge:
    Modifications for wind pressure,ambient pressure and wind speed modifiers used in interzonal airflow.
  • October 18, 2023 by Filip Jorissen:
    Added use_port_1 and use_port_2 for convenience.
  • December 18, 2022 by Filip Jorissen:
    parameter revisions for #1244.
  • April 28, 2022 by Filip Jorissen:
    Changed the default weather file to BEL_VLG_Uccle.064470_TMYx.2007-2021.mos. See #1239 for more details.
  • August 10, 2020, by Filip Jorissen:
    Modifications for supporting interzonal airflow. See #1066
  • April 16, 2021 by Filip Jorissen:
    Changed the default weather file to Brussels.mos. See #1209 for more details.
  • June 30, 2020 by Filip Jorissen:
    Overridable assignments of variables of PartialSimInfoManager. See #1148
  • November 28, 2019 by Ian Beausoleil-Morrison:
    Remove calculation of convection coefficient at exterior surfaces as this has been moved to a new model. Also, removed this coefficient from WeaBus as it is not surface-dependent.
    Make wind direction available on weather bus as this is required for new convection model. See #1089
  • October 9, 2019 by Josué Borrajo Bastero:
    Added button to select the weather file graphically.
  • January 25, 2019 by Filip Jorissen:
    Corrected molar mass fraction for consistency. See #1004.
  • April 10, 2019 by Filip Jorissen:
    Avoided redundant consistent initial equation for Etot. See #971.
  • July 27, 2018 by Filip Jorissen:
    Added outputs CEnv and X_wEnv to weaDatBus. See #868.
  • June 21, 2018, by Damien Picard:
    Reduce the icon size of weaBus to something very small such that users would not try to connect to it. Rename and make public the connector weaDatBus such that it can be connected to models from the Buildings library.
  • June 12, 2018, by Filip Jorissen:
    Refactored implementation such that we use more computations from the weather data reader instead of computing them ourself using equations.
  • June 11, 2018, by Filip Jorissen:
    Revised implementation such that longitude, latitude and time zone are read from the TMY3 weather file. Removed split between file path and file name to avoid confusion and incorrectly formatted paths.
  • June 11, 2018, by Filip Jorissen:
    Changed table name of TMY3 file from 'data' to IBPSA final default 'tab1' for issue #808.
  • June 8, 2018, by Filip Jorissen:
    Moved input TMY3 file. See issue #821.
  • June 7, 2018 by Filip Jorissen:
    Created 'input' for TSky, Va and Fc such that they can be overwriten from the extends clause. This is for #838.
  • March 27, 2018, by Filip Jorissen:
    Added relative humidity to weather bus. See issue #780.
  • January 26, 2018, by Filip Jorissen:
    Added floor orientation to set of precomputed boundary conditions. See issue #764.
  • January 21, 2018 by Filip Jorissen:
    Added solTim connections for revised azimuth computations. See #753.
  • March 21, 2017, by Filip Jorissen:
    Changed linearisation implementation for JModelica compatibility. See issue #559.
  • January 10, 2017 by Filip Jorissen:
    Set linExtRad = false and added new parameter linExtRadWin = true since only for windows is it necessary that linExtRad is true. See #615.
  • September 22, 2016 by Filip Jorissen:
    Reworked implementation such that we use Annex 60 baseclasses for boundary condition computations.
  • March 25, 2016 by Filip Jorissen:
    Reworked radSol implementation to use RealInputs instead of weaBus. This simplifies translation and interpretation. Also cleaned up connections.
  • January 29, 2015, Filip Jorissen:
    Made changes for allowing a proper implementation of airLeakage.
  • June 14, 2015, Filip Jorissen:
    Adjusted implementation for computing conservation of energy.
  • February 10, 2015 by Filip Jorissen:
    Adjusted implementation for grouping of solar calculations.