----------------------------------- Presentation de WlkTransformer v1.2 ----------------------------------- "WlkTransformer" est un utilitaire qui permet de lire les fichiers "aaaa-mm.wlk" crees par le programme (c)Weatherlink et de les transformer en fichiers textes. De nombreux parametrages sont possibles pour preciser au mieux ce que l'on veut exporter. On peut choisir : - le format des fichiers en sortie: CSV, HTML, SQL - la periode (de telle date à telle date) - la liste des capteurs meteos à exporter (temperature exterieure, pluie, pression, humidite, force du vent, direction du vent, ...) - l'unite des parametres meteos - l'intervalle entre 2 mesures exportees (dans le cas des parametres mesures) - le nom des parametres apparaissant en debut de colonnes (format CSV ou HTML), ou le nom des champs (format SQL). - Par ailleurs, il est possible de desactiver certains parametres, même si le capteur est selectionne. (par exemple, je selectionne le capteur "temperature_ext", mais je bannis le parametre "hiDew") Le parametrage du traitement peut se definir de 3 facons : - la configuration par defaut se definit dans le fichier 'conf\WlkTransformer.conf' - la personnalisation (facultative) des noms des parametres meteos dans le fichier 'conf\nom_des_parametres.conf' - en ligne de commande, on peut redefinir certaines configurations par defaut (comme les unites a utiliser par exemple) L'envoi des fichiers resultats vers un serveur distant est possible par ftp. (configuration de la connexion à la fin du fichier 'conf\WlkTransformer.conf', paragraphe 9) -------------------------------------------- Premiere installation de WlkTransformer v1.2 -------------------------------------------- 1> Telecharger le fichier sur le site http://meteofrouzins.fr/wlktrans_telecharger.php : - Systeme Windows 64 bits : 'WlkTransformer_v1.2_Win64b.zip' 2> Creer un repertoire d'utilisation pour le programme Par exemple : c:\Meteo\WlkTransformer (On considerera par la suite que le programme est installe dans ce repertoire.) 3> Copier le fichier que vous avez telecharge dans ce repertoire. Puis decompressez le. Vous obtenez les fichiers suivants : - WlkTransformer.exe ==> le programme WlkTransformer - _WlkTransformer_.conf ==> original du fichier de configuration de WlkTransformer - _nom_des_parametres_.conf ==> original du fichier contenant la liste de noms de parametres personnalises - deplace_conf.bat ==> script pour initialiser le nouveau fichier de configuration dans le repertoire 'conf' - test.bat ==> un script pour effectuer rapidement votre premier test - doWlkTransformer.bat ==> un exemple de script de production de fichiers de donnees meteos (a personnaliser) - doWlkTransformer_previ.bat ==> un exemple de script de production du dernier message de prevision (a personnaliser) - licence.txt ==> licence d'utilisation - result\WlkTransformer.css ==> la feuille de style pour les exports au format Html (a personnaliser) - wlk\2014-02.wlk ==> un exemple de fichier au format Weatherlink, pour permettre de faire rapidement quelques essais. ainsi que les dossiers : - .\wlk ==> recoit une copie des fichiers Weatherlink de votre station. - .\result ==> recoit les fichiers produits par WlkTransformer. - .\conf ==> recoit les fichiers de configuration !! La copie des fichiers de configuration 'WlkTransformer.conf' et 'nom_des_parametres.conf' !! est assuree par le script 'deplace_conf.bat'. - .\log ==> recoit les journaux de traitements - .\tmp ==> stocke des fichiers temporaires 4> EXECUTER LE SCRIPT 'deplace_conf.sh' (indispensable pour une première utilisation) : ------------------------ cd /Meteo/WlkTransformer deplace_conf.bat ------------------------ 'deplace_conf.sh' assure l'initialisation de nouveaux fichiers de configuration dans le repertoire 'conf'. Les anciens fichiers de configuration, s'ils existent, seront automatiquement renommés. 5> Reportez vous maintenant au paragraphe "Configuration du programme WlkTransformer" ci-dessous. ---------------------------------------------------------------- Mise a jour de WlkTransformer v1.2 depuis une version precedente ---------------------------------------------------------------- 1> Telecharger le fichier d'installation sur le site http://meteofrouzins.fr/wlktrans_telecharger.php 2> Copier le dans le repertoire ou est installe WlkTransformer (par exemple: c:\Meteo\WlkTransformer) Puis decompressez le fichier d'installation. 3> Il faut maintenant mettre a jour les fichiers de configuration dans le repertoire conf : --- Un script va renommer automatiquement vos fichiers de configuration actuels (pour ne pas perdre vos modifications) --- et copier les nouveaux fichiers de configuration dans le repertoire conf. --- Vos anciens fichiers de configuration seront renommes avec un nom de la forme : --- - WlkTransformer_AAAAMMJJ-HHmm.sauv --- - nom_des_parametres_AAAAMMJJ_HHmm.sauv EXECUTER LE SCRIPT 'deplace_conf.sh' : ------------------------ cd \Meteo\WlkTransformer deplace_conf.bat ------------------------ 4> Enfin, terminez la mise a jour des fichiers de configuration en reportant dans les nouveaux fichiers, les modifications que vous aviez apportees : nom de repertoires, ... (voir le paragraphe suivant pour plus de details) ----------------------------------------- Configuration du programme WlkTransformer ----------------------------------------- La configuration par defaut du programme se definit dans le fichier .\conf\WlkTransformer.conf Pour commencer : 1> DEFINIR le repertoire ou est installe WlkTransformer, a la ligne repertoire.install= 2> DEFINIR le repertoire ou se trouve la copie de vos fichiers weatherlink (*.wlk), a la ligne repertoire.wlk= 3> DEFINIR le repertoire ou seront exportes les resultats (fichiers *.csv, *.html, *.sql), a la ligne repertoire.destination= Ces 3 points sont suffisants pour un premier test. Vous pourrez ensuite, si vous le souhaitez, personnaliser de nombreux parametrages, comme par exemple : - le choix des sondes a exporter - la liste des parametres a exporter parmi les sondes que vous avez choisie - l'unite des parametres - la personnalisation des exports selon le format (csv, html, sql) - l'envoi des resultats vers un serveur distant par ftp Le nom des parametres meteos peut egalement etre redefini dans le fichier .\conf\nom_des_parametres.conf REMARQUE: Il est possible de definir plusieurs fichiers de configuration 'WlkTransformer_xxx.conf' dans le repertoire conf. Pour appeler une configuration personnalisee en ligne de commande, utiliser l'argument '-conf' suivi du nom du fichier. ---------------------------------------------------- Envoi des fichiers resultats vers un serveur distant ---------------------------------------------------- Au terme du traitement, WlkTransformer peut assurer l'envoi des fichiers textes produits vers un serveur distant par ftp. Le parametrage de la connexion doit etre defini dans le fichier de configuration (paragraphe 9). L'envoi par ftp est a preciser dans le fichier de configuration (etat par defaut) ou plus simplement en ligne de commande en ajoutant l'argument '-ftp oui'. ------------------------------------ IMPORTANT : PRECAUTION D'UTILISATION ------------------------------------ Il est fortement recommande de ne pas travailler sur les fichiers utilises en temps reel par Weatherlink. Pour eviter tout conflit entre les applications, il est preconise de copier les fichiers wlk de Weatherlink sous un autre repertoire, et de declarer ce repertoire dans "repertoire.wlk=" (voir le fichier de configuration WlkTransformer.conf). L'utilisateur assume le risque d'utiliser ce logiciel. ----------------------------------------- Pour executer le programme WlkTransformer ----------------------------------------- - Sous Windows, ouvrir une fenetre de commande. Windows 7 : - Depuis le menu Demarrer: - Faire: Executer, taper "cmd" puis bouton "OK". ==> La fenetre de commande s'ouvre. Windows 10 : - Depuis le menu Rechercher: - Taper "cmd". Sélectionner l'application "Invite de commande" ==> La fenetre de commande s'ouvre. Dans la fenetre de commande, taper : - cd \Meteo\WlkTransformer Pour realiser un 1er essai, lancer le fichier : - test.bat Un fichier au format wlk est fourni dans le dossier C:\Meteo\WlkTransformer\Wlk pour votre 1er essai. Vous devriez obtenir le resultat de votre test dans le dossier C:\Meteo\WlkTransformer\Result Maintenant, c'est a vous de jouer ! Vous pouvez a loisir modifier le fichier test.bat ou vos fichiers de configuration pour adapter le traitement a votre besoin. Pour creer plus rapidement vos commandes WlkTransformer, un generateur de lignes de commande est propose sur le site http://meteofrouzins.fr/wlktrans_commencer.php -------------------------------------------------------------------- Usage: WlkTransformer -to ... -export ... [-d1 ...] [-d2 ...] [-id ...] ... -------------------------------------------------------------------- Arguments principaux : -to : format en sortie parmi 'csv', 'html', 'sql' --> 'csv': les donnees sont exportees vers un fichier au format CSV (pour tableur comme Excel, Libre Office) --> 'html': les donnees sont exportees vers un fichier au format HTML (tableau lisible par tout navigateur) --> 'sql': les donnees sont exportees vers un fichier au format SQL (pour alimenter une base de donnees) -export : type de fichier a creer, parmi 'wdata', 'resume1', 'resume2', 'resume3', 'all', 'resume123', 'lastForecast' --> 'wdata': les parametres 'temps reel' directement mesures par la station --> 'resume1': les parametres quotidiens principaux releves sur la journee du fichier WLK (tempe., pluie, vent, ...) --> 'resume2': les parametres quotidiens secondaires releves sur la journee du fichier WLK (rayon., DJU, ET, ...) --> 'resume3': les parametres quotidiens Tn, Tx, RR recalcules selon la norme OMM (Tn-1818, Tx-0606, RR-0606) ou sur la journee UTC (Tn-0024, Tx-0024, RR-0024) --> 'all': export de l'ensemble des fichiers 'wdata' + 'resume1' + 'resume2' + 'resume3' --> 'resume123': les 3 resumes 'resume1', 'resume2', 'resume3' sont exportes dans le MEME fichier --> 'lastForecast': le dernier message de prevision disponible en clair --> 'climatic': donnees pour l'alimentation des releves journaliers ClimatIC d'Infoclimat (format csv, import sur infoclimat.fr) -d1 : date de debut au format AAAAMM ou AAAAMMJJ ou AAAAMMJJHHmm (= 1er du mois en cours a 00:00 si omis) -d2 : date de fin au format AAAAMM ou AAAAMMJJ ou AAAAMMJJHHmm (= fin du mois de d1 a 23:59 si omis) -id : identifiant de station = numero ou nom (facultatif, ajoute un champ lors d'un export csv ou sql, ou un titre en html) Arguments de mise en forme de l'export : -intervalWdata : intervalle d'export des parametres mesures en minutes parmi 1,2,5,10,15,30,60,120,180,240,360,720,1440 -heureMinMax : 'oui' pour afficher l'heure des parametres extremes quotidiens 'non' pour ne pas afficher l'heure des parametres extremes quotidiens -locale : 'fr' pour exporter les textes en francais (nom court des parametres, titre de colonne, message de prevision) 'en' pour exporter les textes en anglais -Tunit : choix de l'unite de temperature parmi 'C', 'F', 'K', 'C10', 'F10', 'K10' -Uunit : choix de l'unite d'humidite parmi 'U', 'U10' -Vunit : choix de l'unite de force du vent parmi 'kmph', 'mps', 'Kt', 'Mph', 'Bft', kmph10', 'mps10', 'Kt10', 'Mph10' -Dunit : choix de l'unite de direction du vent parmi 'secteur', 'degre', 'indice' -Runit : choix de l'unite de mesure de pluie parmi 'mm', 'inch', 'mm10', 'inch1000' -Punit : choix de l'unite de pression parmi 'hpa', 'mmHg', 'inHg', 'hpa10', 'mmHg10', 'inHg1000' !! Plus d'informations sur les unites dans le fichier de configuration 'WlkTransformer.conf' !! Autres arguments facultatifs : -ftp : 'oui' pour envoyer les resultats vers un serveur distant. ('non' pour bloquer l'envoi) !! Initialisation des parametres ftp dans le fichier de configuration 'WlkTransformer.conf' !! -conf : nom du fichier de configuration a utiliser (lu dans le repertoire ./conf ou donner le nom complet) -confirm : 'oui' pour afficher une demande de confirmation avant traitement 'non' pour supprimer la demande de confirmation avant traitement (mode automatique) -licence : licence d'utilisation du programme -version : version du programme -h : this help Exemple: export au format SQL des donnees quotidennes de 02/2014 (permet d'alimenter une base de donnees) WlkTransformer -to sql -export resume1 -d1 201402 Generateur de ligne de commande: http://meteofrouzins.fr/wlktrans_commencer.php Documentation complete: http://wlktransformer.meteofrouzins.fr -------------------------------------------------------- --------- Contact --------- Besoin de renseignements, une suggestion ? Contactez-nous a l'adresse contact@meteofrouzins.fr