Documentation pour OMM_un_mois.exe, OMM_mois_courant.exe et OMMmoiscourant.bat
(et les mêmes en version UTC)

Ces programmes ont pour but de calculer les températures minimales et maximales, les cumuls de pluie et l'énergie solaire re¸ue de toutes les journées d'un mois donné à partir d'un fichier (.wlk) généré par WeatherLink.
La particularité de ces programmes tient du fait que les valeurs sont calculées suivant la norme de l'OMM, c'est-à-dire :
- pour les températures maximales (Tx) et les cumuls de pluie entre 6 h UTC d'un jour et 6 h UTC du lendemain.
- pour les températures minimales (Tn) entre 18 h UTC de la veille et 18 h UTC d'un jour.
- l'énergie solaire re¸ue de 0 h UTC à 24 h UTC d'un jour (pour les stations munies d'un capteur de radiation).
Attention : Les versions OMM_un_mois et OMM_mois_courant fonctionnent pour des stations configurées en heures locales. Les décalages horaires, heures d'hiver et d'été, sont calculés automatiquement par ces programmes car les fichiers .wlk sont écrits avec l'heure locale .
Les versions OMM_un_mois_UTC et OMM_mois_courant_UTC fonctionnent pour des stations configurées en heures UTC.
Toutes les explications qui suivent s'appliquent de manière identique aux versions UTC.

Explications :

• Ce sont des applications DOS. Les extensions des fichiers, pour raison de sécurité au téléchargement, sont actuellement .ex_ ou .ba_, il faut tout d'abord renommer celles-ci en .exe ou .bat.
• OMM_un_mois.exe, OMM_mois_courant.exe et OMMmoiscourant.bat doivent être mis dans le répertoire où se trouvent les fichiers aaaa-mm.wlk. Ceux-ci se trouvent, a priori, dans le répertoire de la station.
  Il suffit de double-cliquer dessus pour lancer l'exécution (voir plus loin).
• Différences entre les 2 programmes :
  - a priori, OMM_un_mois est utilisé pour l'archivage des mois complètement achevés. Les numéros du mois et de l'année sont demandés. L'exécution est quasi-instantanée.
  - OMM_mois_courant, comme son nom l'indique, s'applique au fichier du mois courant. Rien ne s'affiche à l'écran lors de l'exécution. Ce programme est destiné, a priori, à être exécuté d'une manière automatique par une tâche planifiée.
• Il est créé soit un fichier OMMaaaa-mm.csv, soit un fichier OMM_MoisCourant.csv dans le même répertoire, où aaaa et mm sont l'année et le mois donnés.
  Ils comportent une première ligne d'en-tête rappelant le nom des données enregistrées pour chaque journée, c'est-à-dire, dans l'ordre :
  Date du Jour ; Température Minimale (°C) ; Heure de la Température Minimale ; TempMax(°C) ; Heure de la Température Maximale ; Cumul de Pluie du Jour (mm) ; Energie reçue du Jour(kWh/m²).
  Ces fichiers se lisent directement avec n'importe quel traitement de texte ou par n'importe quel tableur.
  Les droits d'écriture sur ce répertoire sont nécessaires.
  
• Remarque : OMM_mois_courant.exe lit le fichier .wlk du mois en cours, or WeatherLink empêche la lecture de ce fichier quand il est actif. Pour contourner cela, il est nécessaire d'utiliser un artifice, en l'occurrence le programme va créer automatiquement une copie du fichier aaaa-wlk sous le nom moiscourant.kkk dans le répertoire courant.
• Pour ces programmes, il est nécessaire de disposer, dans le même répertoire, des fichiers .wlk du mois précédent et du mois suivant pour assurer la justesse des données du premier et du dernier jour du mois. L'absence de ces fichiers n'entraînent pas d'erreur d'exécution, mais un message vous informera de ceci le cas échéant.
  Avec OMM_un_mois.exe, si les fichiers .wlk sont incomplets, les résultats obtenus ne seront évidemment pas significatifs.
  Avec OMM_mois_courant.exe, les résultats s'arrêtent la veille du jour courant. Si l'exécution est faite avant 6 h UTC la température maximale et le cumul de pluie du dernier jour du fichier peuvent être incorrects.
• Pour les heures des températures figurant dans les fichiers générés par ces programmes :
  - elles sont données en heures locales fran¸aises ou UTC suivant la version utilisée,
  - si l'heure de température maximale est inférieure à 7 heures (horaire d'hiver) ou 8 heures (horaire d'été) (ou 6 heures en version UTC), la température maximum a été relevée le lendemain matin de la Date du jour,
  - si l'heure de température minimale est supérieure 19 heures (horaire d'hiver) ou 20 heures (horaire d'été) (ou 18 heures en version UTC), la température minimum a été relevée la veille au soir de la Date du jour.
  - si l'heure de la rafale maximale est supérieure 23 heures (horaire d'hiver) ou 22 heures (horaire d'été) (ou 24 heures en version UTC), la rafale maximale a été relevée la veille au soir de la Date du jour.
  
• Quand WeatherLink est configuré en heures locales, lors du passage de l'heure d'été à l'heure d'hiver la séquence de 2 heures à 3 heures existe deux fois dans la réalité, or le fichier aaaa-10.wlk ne comporte qu'une seule de ces séquences donc une partie des données a été perdue.
• L'énergie solaire a été mise dans ces programmes, car sa valeur n'apparaît pas en général dans les logiciels. Elle est donnée ici en kWh/m², alors qu'elle est calculée en Ly par WeatherLink.
  Cette valeur est intéressante pour ceux qui possèdent des panneaux photovoltaï ques. Ils pourront vérifier le rendement de leur installation.
  Si votre station ne comporte pas de capteur de radiations, la valeur affichée est négative et n'a aucune signification.