BuildSysPro.BoundaryConditions.Weather.Meteofile

# .BuildSysPro.BoundaryConditions.Weather.Meteofile

Weather data reader

## Information

Weather data reader providing meteorological boundary conditions

Hypothesis and equations

This model reads weather data files. The files are contained in the directory file://BuildSysPro\Resources\Donnees\Meteos.

The data format must be compliant with specifications described below (see table).

Bibliography

none

Instructions for use

This model reads a data file containing the following columns:

Time [s] | Solar irradiance 1 [W/m²] Direct normal (defaut) | Solar irradiance 2 [W/m²] Diffuse horizontal (defaut) | T_dry [°C] Dry bulb temperature | T_dew [°C] Dew point temperature | T_sky [°C] Sky temperature | Patm [Pa] Atmospheric pressure | HR (between 0 and 1) Relative humidity | VitVent [m/s] Wind speed | DirVent [°] Wind direction | Latitude [°] | Longitude [°]

By default weather file can be given either in universal time (UTC - h0 = 0) or in local time (TL - h0 = Time zone). The scenarios should be consistent with the time given in the weather file - there is no change to summer time.

The weather data are repeated periodically. By default, a one year period is used (see advanced parameter Tbouclage). So that one can start simulations on heating season: for example, from October 1 (start time 23587200s) to May 1 (stop time 41904000s). The advanced parameter Tbouclage allows to loop from a longer period so that a data file larger than a year can be used.

Default settings - link to the content of the folder file://BuildSysPro\Resources\Donnees\Meteos

1. Irradiation data are DIRN and DIFH
2. The beginning of the files is at 0:00 on January 1
3. The longitude is given in ° East
4. The pressure (in Pa) is an absolute pressure, and is assumed to be a wet air total pressure (used as such in humidity calculation functions)
5. The relative humidity is between 0 and 1
6. For the wind direction, the World Weather Organization assumes that a wind coming from the north is coded 360°, the wind rose is graduated clockwise (an east wind will be coded 90°) - check in all weather files -

Available files and their differences from default values are:

1. Meteofrance: Average irradiation [t-dt/2;t+dt/2]. h0 = 0
2. Meteonorm: Irradiation determined on the last hour and assigned in the middle of the hour to better match the sun's path. Local time (h0 = -1 in France).
3. Weather file from the French building regulation RT2012: irradiation determined on the last hour and assigned in the middle of the hour to better match the sun's path. Local time (h0 = -1 in France).
4. For user-defined weather data, fill in the parameters conditioning irradiation calculations thereafter. For example, for data starting May 11, at 15:30 (Universal Time) - indicate h0 = 15.5 and d0 = 135.

This model returns as outputs:

- G[10] vector containing information for solar irradiance computation:

- (1) Horizontal diffuse flux
- (2) Normal direct flux
- (3) Horizontal direct flux
- (4) Horizontal global flux
- (5) Time in UTC at time t = 0 (start of the simulation)
- (6-7-8) Sun's direction cosines (6-sinH, 7-cosW, 8-cosS)
- (9) Solar azimuth angle
- (10) Solar elevation angle

- V[2] vector containing information about wind

1. Wind speed
2. Wind direction (origin)

- Hygro[3] for hygro-thermal modelling

1. Dry air temperature [K]
2. Total pressure supposed to be wet (=Patm) [Pa]
3. Relative humidity [0;1]

Known limits / Use precautions

The irradiation couple read by the weather reader is set via the choice of CoupleFlux. By default, the model reads the couple FDIRN / FDIFH

Validations

Validated model - Aurélie Kaemmerlen 2010

--------------------------------------------------------------
Licensed by EDF under a 3-clause BSD-license
Copyright © EDF 2009 - 2023
BuildSysPro version 3.6.0
Author : Aurélie KAEMMERLEN, EDF (2010)
--------------------------------------------------------------

## Revisions

Aurélie Kaemmerlen 02/2011 : Inversion des composants 1 et 2 du vecteur G pour garder le même ordre des flux solaires entre le fichier météo d'entrée et ce vecteur G en sortie du lecteur Météo - Pas d'impact sur le format des fichiers mais les modèles utilisant le vecteur G modifiés en conséquent

Aurélie Kaemmerlen 05/2011 : Le vecteur G a été allongé avec 3 paramètres de plus : MoyFlux, dt et CoupleFlux permettant une plus grande réutilisabilité de ce lecteur Météo

Gilles Plessis 02/2012: Modification du type du paramètre pth (String changé en Filename) permettant l'utilisation d'une fenêtre pour atteindre le fichier de données.

Aurélie Kaemmerlen 03/2012 : Modification de la valeur par défaut de Est (=false pour Meteonorm qui est le fichier par défaut)

Aurélie Kaemmerlen 06/2012 :

- Désactivation de la saisie du paramètre dt lorsque la moyenne est une moyenne classique,
- Ajout de documentation pour préciser le mode d'emploi du modèle
- Automatisation du choix des fichiers météo selon les données disponibles par défaut dans la documentation (par défaut, météo perso)
- Ajout du port Hygro permettant la connexion avec les modèles aérauliques
- Modification du type d'interpolation de la table : au lieu d'une interpolation linéaire, les données sont interpolées de sorte que leur dérivée reste continue

Hassan Bouia 03/2013 : Simplification des calculs solaires et modification du vecteur G

Denis Covalet 04/2013 : Précisions sur le vecteur Hygro, variable pression et correction infos sur HR (entre 0 et 1 et non pas en %)

Aurélie Kaemmerlen 09/2013 : Ajout d'un choix du type d'interpolation des données météo, du choix du temps de bouclage du fichier météo et modulo sur la direction du vent qui sortait des bornes [0-360] avec une interpolation continue

Amy Lindsay 01/2014 : Suppression du modulo sur la direction du vent qui posait des problèmes de résolution dans certains cas (non continuité des données), et interpolation linéaire obligatoire sur la direction du vent pour répondre à ce problème

Amy Lindsay 03/2014 : Ajout de deux booléens permettant de 1- préciser si la température de ciel est déjà renseignée dans le fichier texte météo ou si'il faut la calculer 2- le cas échéant, préciser si l'humidité relative est connue ou non (la corrélation estimant la température de ciel dépend des données d'entrée disponibles)

Amy Lindsay 04/2014 : Ajout de documentation pour rappeler l'importance des conventions d'angles qui sont différentes pour la direction du vent et pour l'orientation des parois !

Amy Lindsay 11/2014 : Changement important pour les fichiers météo Meteonorm et réglementaires : pour mieux correspondre à la position du soleil à chaque instant, les flux moyennés sur l'heure écoulée sont affectés au milieu du pas de temps (demie-heure).

Hassan Bouia, Amy Lindsay 12/2014 : Ajout de la possibilité d'utiliser des fonctions en escalier.

Gilles Plessis 09/2015 : Utilisation de la fonction `Modelica.Utilities.Files.loadResource` pour le chargement de fichiers, pour une meilleure compatibilité avec le standard Modelica.

Benoît Charrier 01/2016 : Ajout du paramètre avancé `table_column_number` pour éviter une déclaration croisée de variables et permettre la compatibilité avec OpenModelica.

Benoît Charrier 01/2017 : Remplacement de la pression de vapeur par l'humidité relative comme troisième composante du vecteur `Hygro` pour coller aux entrées des modèles de conditions limites `WithoutWindEffect` et `WithWindEffect`.

Benoît Charrier 01/2018 : Added `noEvent` on some `CosDir[1]>0` conditions to avoid division by zero errors. Changed `h0` value from `0` to `-1` in case of RT2012 meteo to fit with sun height.

Generated at 2026-05-09T18:18:56Z by OpenModelicaOpenModelica 1.26.7 using GenerateDoc.mos