modelSimInfoManagerInputs
Extends from IDEAS.BoundaryConditions.SimInfoManager (Simulation information manager for handling time and climate data required in each for simulation.).
Information
This extension of the SimInfoManager allows to use a custom text input file for the weather data instead of the TMY3 weather data loaded by the SimInfoManager.
The text file should have the following structure. It should start with:
double data(xx,10)
where xx should be replaced by the number of time entries (number of rows).
The following lines should have 10 tab-separated columns containing following values:
time [s], ambiant temperature [K], dew point temperature [K], atmospheric pressure [bar], wind speed [m/s], wind bearing [deg] (between 0 and 360), relative humidity [-] (between 0 and 1), direct normal sun irradiance [W/m2], diffuse horizontal irradiance [W/m2] and weather the measurement is trusted or not (even though nothing is done in modelica with the last column).
Once the custom text file is created, give the correct path to the
fileNameLocalWeather parameter.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| String | filNam (from PartialSimInfoManager) | Modelica.Utilities.Files.loadResource("modelica://IDEAS/Resources/weatherdata/BEL_VLG_Uccle.064470_TMYx.2007-2021.mos") | File name of TMY3 weather file |
| Modelica.Units.SI.Time | timZon (from PartialSimInfoManager) | weaDat.timZon | Time zone for which the simulation time t=0 corresponds to midnight, january 1st |
| Modelica.Units.SI.Angle[5] | aziOpts (from PartialSimInfoManager) | {incS, incW, incN, incE, incS} | Inclination options, default south |
| Modelica.Units.SI.Angle[4] | incOpts (from PartialSimInfoManager) | {IDEAS.Types.Tilt.Wall, IDEAS.Types.Tilt.Floor, IDEAS.Types.Tilt.Ceiling, IDEAS.Types.Tilt.Wall} | Azimuth options, default wall |
| Boolean | use_port_1 (from PartialSimInfoManager) | interZonalAirFlowType <> IDEAS.BoundaryConditions.Types.InterZonalAirFlow.None | Whether port_1 of the propsbus connector should be used |
| Boolean | use_port_2 (from PartialSimInfoManager) | interZonalAirFlowType == IDEAS.BoundaryConditions.Types.InterZonalAirFlow.TwoPorts | Whether port_2 of the propsbus connector should be used |
| Modelica.Units.SI.Temperature | Tenv_nom (from PartialSimInfoManager) | 280 | Nominal ambient temperature, only used when linearising equations |
| Integer | numIncAndAziInBus (from PartialSimInfoManager) | size(incAndAziInBus, 1) | Number of pre-computed azimuth |
| Modelica.Units.SI.Temperature | Tdes (from PartialSimInfoManager) | -8 + 273.15 | design outdoor temperature |
| Modelica.Units.SI.Temperature | TdesGround (from PartialSimInfoManager) | 10 + 273.15 | design ground temperature |
| Real | V50_def (from PartialSimInfoManager) | V50 - V50_custom | Corrected V50 value, default for surfaces without custom assignment. |
| Real | V50 (from PartialSimInfoManager) | V_tot*n50 | V50 value assuming no custom v50 values. |
| Real | q50_def (from PartialSimInfoManager) | if A_def < Modelica.Constants.small then q50_av else V50_def/A_def | |
| Real | q50_av (from PartialSimInfoManager) | if A_tot < Modelica.Constants.small then 0 else V50/A_tot | average, not corrected q50 |
| Modelica.Units.SI.Volume | V_tot (from PartialSimInfoManager) | Total conditioned building volume | |
| Modelica.Units.SI.Area | A_tot (from PartialSimInfoManager) | Total surface area of OuterWalls and Windows | |
| Real | V50_custom (from PartialSimInfoManager) | Sum of v50 values for components that have a custom assignment | |
| Modelica.Units.SI.Area | A_def (from PartialSimInfoManager) | Total area with default q50, i.e. without custom q50 assignment, or connected to zone with custom n50 assigned | |
| String | fileNameLocalWeather | Modelica.Utilities.Files.loadResource("modelica://IDEAS/Resources/weatherdata/CustomWeatherFiles/example.txt") | Path to the local weather file |
| Advanced | |||
| Modelica.Units.SI.Angle | lat (from PartialSimInfoManager) | weaDat.lat | Latitude of the location |
| Modelica.Units.SI.Angle | lon (from PartialSimInfoManager) | weaDat.lon | Longitude of the location |
| Incidence angles | |||
| Modelica.Units.SI.Angle | incS (from PartialSimInfoManager) | IDEAS.Types.Azimuth.S | South inclination |
| Modelica.Units.SI.Angle | incW (from PartialSimInfoManager) | incS + Modelica.Constants.pi/2 | West inclination |
| Modelica.Units.SI.Angle | incN (from PartialSimInfoManager) | incS + Modelica.Constants.pi | North inclination |
| Modelica.Units.SI.Angle | incE (from PartialSimInfoManager) | incS + 3*Modelica.Constants.pi/2 | East inclination |
| Modelica.Units.SI.Angle[:,:] | incAndAziInBus (from PartialSimInfoManager) | {{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 | |||
| Boolean | computeConservationOfEnergy (from PartialSimInfoManager) | false | Add equations for verifying conservation of energy |
| Boolean | strictConservationOfEnergy (from PartialSimInfoManager) | false | This adds an assert statement to make sure that energy is conserved |
| Boolean | openSystemConservationOfEnergy (from PartialSimInfoManager) | false | Compute conservation of energy for open system |
| Modelica.Units.SI.Energy | Emax (from PartialSimInfoManager) | 1 | Error bound for violation of conservation of energy |
| Linearisation | |||
| Boolean | lineariseDymola (from PartialSimInfoManager) | false | Linearises building model equations for Dymola linearisation approach |
| Boolean | lineariseJModelica (from PartialSimInfoManager) | false | Linearises building model equations for optimisations in JModelica |
| Boolean | createOutputs (from PartialSimInfoManager) | false | Creates output connections when linearising windows |
| Boolean | outputAngles (from PartialSimInfoManager) | not lineariseDymola | Output angles in weaBus. Set to false when linearising |
| Integer | nWindow (from PartialSimInfoManager) | 1 | Number of windows in the to be linearised model |
| Integer | nLayWin (from PartialSimInfoManager) | 3 | Number of window layers in the to be linearised model; should be maximum of all windows |
| Boolean | linearise (from PartialSimInfoManager) | lineariseDymola or lineariseJModelica | Linearises building model equations |
| Linearisation › Convection | |||
| Boolean | linIntCon (from PartialSimInfoManager) | false | = true, if interior convective heat transfer should be linearised |
| Boolean | linExtCon (from PartialSimInfoManager) | false | = true, if exterior convective heat transfer should be linearised (uses average wind speed) |
| Linearisation › Radiation | |||
| Boolean | linIntRad (from PartialSimInfoManager) | true | = true, if interior radiative heat transfer should be linearised |
| Boolean | linExtRad (from PartialSimInfoManager) | false | = true, if exterior radiative heat transfer for walls should be linearised |
| Boolean | linExtRadWin (from PartialSimInfoManager) | true | = true, if exterior radiative heat transfer for windows should be linearised |
| Advanced › CO2 | |||
| Real | ppmCO2 (from PartialSimInfoManager) | 400 | Default CO2 concentration in [ppm] when using air medium containing CO2 |
| Interzonal airflow | |||
| IDEAS.BoundaryConditions.Types.InterZonalAirFlow | interZonalAirFlowType (from PartialSimInfoManager) | IDEAS.BoundaryConditions.Types.InterZonalAirFlow.None | Type of interzonal air flow model |
| Boolean | unify_n50 (from PartialSimInfoManager) | false | if true, zone n50 values are merged and then redistributed across al zones even if interZonalAirFlowType==None |
| Real | n50 (from PartialSimInfoManager) | 3 | n50 value of zones |
| Wind | |||
| Boolean | use_sim_Cs (from PartialSimInfoManager) | true | if checked, the default Cs of each surface in the building is sim.Cs |
| IDEAS.BoundaryConditions.Types.LocalTerrain | locTer (from PartialSimInfoManager) | IDEAS.BoundaryConditions.Types.LocalTerrain.Unshielded | Selection of local terrain |
| Real | a_custom (from PartialSimInfoManager) | 0.14 | Custom velocity profile exponent |
| Real | A0_custom (from PartialSimInfoManager) | 1.0 | Custom local terrain coefficient |
| Real | a (from PartialSimInfoManager) | if 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_custom | Velocity profile exponent |
| Modelica.Units.SI.Length | delta (from PartialSimInfoManager) | if 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 0 | Wind boundary layer thickness |
| Real | A0 (from PartialSimInfoManager) | if locTer == IDEAS.BoundaryConditions.Types.LocalTerrain.Custom then A0_custom else (270/Hwind)^0.14*(Hwind/delta)^a | Local terrain coefficient |
| Modelica.Units.SI.Length | H (from PartialSimInfoManager) | 10 | Building or roof height |
| Modelica.Units.SI.Length | Hwind (from PartialSimInfoManager) | 10 | Height above ground of meteorological wind speed measurement |
| Modelica.Units.SI.Length | HPres (from PartialSimInfoManager) | 1 | Height above ground of meteorological atmospheric pressure measurement |
| Real | Cs_coeff (from PartialSimInfoManager) | (A0*A0)*((1/Hwind)^(2*a)) | Multiplication factor for wind speed modifier Cs |
| Real | Cs (from PartialSimInfoManager) | Cs_coeff*(H^(2*a)) | Wind speed modifier |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| IDEAS.Buildings.Components.Interfaces.WeaBus | weaBus (from PartialSimInfoManager) | ||
| Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a | Qgai (from PartialSimInfoManager) | Thermal gains in model | |
| IDEAS.Buildings.Components.BaseClasses.ConservationOfEnergy.EnergyPort | E (from PartialSimInfoManager) | Model internal energy | |
| IDEAS.Buildings.Components.Interfaces.WindowBus | winBusOut (from PartialSimInfoManager) | Bus for windows in case of linearisation | |
| IDEAS.BoundaryConditions.WeatherData.Bus | weaDatBus (from PartialSimInfoManager) | Weather data bus connectable to weaBus connector from Buildings Library | |
| Buildings.Components.Interfaces.VolumePort | volumePort (from PartialSimInfoManager) | Port for summing volumes of all zones | |
| Buildings.Components.Interfaces.AreaPort | areaPort (from PartialSimInfoManager) | Port for summing surface areas of all surfaces |