pywws¶

Fichiers prérequis.¶

• Python 2.5+ - http://python.org/ (Note: Le support de Python 3 est en développement)

• Librarie USB - option 1 (préférable pour les Mac)

  • PyUSB 1.0 - http://sourceforge.net/apps/trac/pyusb/
  • libusb 0.1 or 1.0 - http://www.libusb.org/

• Librarie USB - option 2 (Si PyUSB 1.0 n’est pas disponible)

  • PyUSB 0.4 - http://sourceforge.net/apps/trac/pyusb/
  • libusb 0.1 - http://www.libusb.org/

• Librarie USB - option 3 (préférable pour les Mac)

  • hidapi - https://github.com/signal11/hidapi
  • ctypes - http://docs.python.org/2/library/ctypes.html

• Librarie USB - option 4:

  • hidapi - https://github.com/signal11/hidapi
  • cython-hidapi - https://github.com/gbishop/cython-hidapi
  • cython - http://cython.org/

Vous serez peut-être en mesure de les installer sur votre PC via un gestionnaire de paquet. Cette solution est beaucoup plus facile que de télécharger puis compiler les fichiers source à partir des sites de projet. Noter que certaines distributions Linux peuvent utiliser des noms différents pour certains paquets, ex. sur Ubuntu, pyusb se nomme python-usb.

En plus de ce qui précède, je recommende l’installation de pip (le paquet peut aussi se nommer python-pip) ou easy_install. Ceux-ci simplifient l’installation de logiciels par le Python Package Index (PyPI). Par exemple, PyUSB peut être installé à partir de PyPI en utilisant la commande pip:

sudo pip install pyusb

Télécharger le logiciel pywws.¶

Créer un dossier pour tous vos fichiers reliés à la météo et vous positionner dans ce dossier. Par exemple (avec un système d’exploitation Linux ou similaire):

mkdir ~/weather
cd ~/weather

Vous pouvez installer pywws directement à partir de PyPI en utilisant pip ou easy_install, ou vous pouvez télécharger et extraire les fichiers dans votre répertoire météo; ce qui a l’avantage de pouvoir facilement lire les modules Python et autres fichiers. Il vous permet également d’exécuter le logiciel pywws sans les privilèges du ‘root’ habituellement requis pour installer le logiciel.

sudo pip install pywws

cd ~/weather
tar zxvf pywws-12.11_95babb0.tar.gz

cd ~/weather
unzip pywws-12.11_95babb0.zip

cd ~/weather
ln -s pywws-12.11_95babb0 pywws

cd ~/weather
git clone https://github.com/jim-easterbrook/pywws.git
cd pywws
python setup.py msgfmt
python setup.py build_sphinx

cd ~/weather/pywws
python setup.py build
sudo python setup.py install

(Utilisateur de Python 3 seulement) Convertir pywws pour Python 3.¶

Si votre version de Python par défaut est 3.x et que vous avez installé pywws à l’aide de pip, ou exécuté python setup.py install, le code aura déjà été traduit de Python 2 vers Python 3 et inclu dans le processus d’installation. Sinon, vous devrez utiliser setup.py pour faire la conversion et créer une installation de Python 3:

cd ~/weather/pywws
rm -Rf build
python3 setup.py build
sudo python3 setup.py install

Tester la connexion de la station météo.¶

Finallement, vous êtes prêt à tester votre installation de pywws. Brancher la station météo (si ce n’est pas déjà fait), puis exécuter le module pywws.TestWeatherStation. Si vous avez téléchargé pywws mais ne l’avez pas installé, alors n’oubliez pas de changer de répertoire pour le dossier source de pywws. Par exemple:

cd ~/weather/pywws
python -m pywws.TestWeatherStation

Si tout fonctionne correctement, vous devriez voir apparaitre un lot de chiffres ressemblant à ceci:

0000 55 aa ff ff ff ff ff ff ff ff ff ff ff ff ff ff 05 20 01 51 11 00 00 00 81 00 00 0f 00 00 60 55
0020 ea 27 a0 27 00 00 00 00 00 00 00 10 10 12 13 45 41 23 c8 00 32 80 47 2d 2c 01 2c 81 5e 01 1e 80
0040 96 00 c8 80 a0 28 80 25 a0 28 80 25 03 36 00 05 6b 00 00 0a 00 f4 01 18 03 00 00 00 00 00 00 00
0060 00 00 4e 1c 63 0d 2f 01 73 00 7a 01 47 80 7a 01 47 80 e4 00 00 00 71 28 7f 25 bb 28 bd 25 eb 00
0080 0c 02 84 00 0e 01 e3 01 ab 03 dc 17 00 10 08 21 08 54 10 03 07 22 18 10 08 11 08 30 10 04 21 16
00a0 26 08 07 24 17 17 08 11 01 06 10 09 06 30 14 29 09 01 06 07 46 09 06 30 14 29 09 01 06 07 46 08
00c0 08 31 14 30 10 05 14 15 27 10 01 26 20 47 09 01 23 05 13 10 01 26 20 47 09 01 23 05 13 10 02 22
00e0 11 06 10 02 22 11 06 08 07 07 19 32 08 12 13 22 32 08 09 07 08 48 01 12 05 04 43 10 02 22 14 43

Si ce test ne fonctionne pas, plusieurs facteurs peuvent être en cause, mais le plus courant est un problème de ‘permissions’; ce qui peut être vérifié en exécutant la commande suivante avec les droits ‘root’:

sudo python -m pywws.TestWeatherStation

Si celà fonctionne, vous devriez être capable de permettre à votre compte utilisateur normal d’accéder à votre station météo en créant une règle ‘udev’. Voir la page de compatibilité du wiki http://code.google.com/p/pywws/wiki/Compatibility (en anglais) pour plus de détails.

Pour tout autre problème, n’hésitez pas à demander de l’aide sur la liste de publipostage de pywws: http://groups.google.com/group/pywws

Configurer votre station météo.¶

Si vous ne l’avez pas déjà fait, configurez votre station météo pour afficher la bonne pression atmosphérique relative. (Voir le manuel pour plus d’informations sur la façon de faire.) pywws obtient le décalage entre la pression relative et absolue de la station, donc cela doit être défini avant d’utiliser pywws .

Vous pouvez obtenir la bonne pression relative de votre emplacement en recherchant sur Internet des rapports météorologiques d’une station à proximité, idéalement une source officielle, tel un aéroport. Il est préférable de le faire durant une période calme lorsque la pression est presque constante sur une longue période.

Si vous modifiez le décalage, à tout moment, vous pouvez mettre à jour toutes vos données stockées en exécutant pywws.Reprocess.

Configurer l’intervalle d’enregistrement de la station météo.¶

Votre station météo a probablement quitté l’usine avec un intervalle d’enregistrement de 30 minutes. Ceci permet à la station d’enregistrer environ 11 semaines de données. La plupart des utilisateurs de pywws configurent leur ordinateur pour lire les données de la station à chaque heure, ou plus fréquemment et souhaitent que la station contienne assez de données pour couvrir d’éventuelles panne d’ordinateur. L’intervalle recommandé est de 5 minutes, ce qui représente 2 semaines de données. Utilisez le programme pywws.SetWeatherStation pour fixer l’intervalle:

python -m pywws.SetWeatherStation -r 5

Enregistrer les données de votre station météo.¶

En premier lieu, choisissez un dossier pour entreposer toute les données de votre station météo. Ces données étant écrites très fréquemment, un disque rigide sera préférable à une mémoire Flash (USB), puisque ces dernières ont un nombre d’écriture limité. Dans la plupart des cas, le répertoire personnel est préférable, par exemple:

mkdir ~/weather/data

Ce répertoire est référé dans la documentation pywws en tant que votre ‘répertoire de données’.

Assurez-vous que votre ordinateur ait la date et l’heure précise, ainsi que le fuseau horaire approprié, puisqu’ils seront utilisés pour identifier les données de votre station météo. Si vous ne l’avez pas déjà fait, il pourrait être utile d’utiliser la synchronisation horaires par réseau (NTP) pour synchroniser votre ordinateur à un ‘serveur de temps’.

La première fois que vous exécutez pywws.LogData un fichier de configuration, nommé ‘weather.ini’, sera créé dans votre répertoire de données, puis s’arrêtera. Vous devez éditer ce fichier de configuration et y modifier la ligne ws type = Unknown à ws type = 1080 ou ws type = 3080. (Si la console de votre station météo affiche la luminosité solaire, vous avez une station de type 3080, sinon, vous indiquez le type 1080.) Puis exécutez pywws.LogData de nouveau. Cette fois, l’exécution peut durer quelques minutes, puisqu’il copiera l’intégralité des données météo emmagasinées dans la mémoire de votre station météo. Le programme pywws.LogData possède une option ‘verbose’ qui augmente le nombre de messages affichés pendant l’exécution. Cette option est utile lors d’exécution manuelle, par exemple:

python -m pywws.LogData -vvv ~/weather/data

(Remplacez ~/weather/data par votre répertoire de données, si différent.)

Vous devriez maintenant avoir quelques fichiers de données à regarder. Par exemple:

more ~/weather/data/weather/raw/2012/2012-12/2012-12-16.txt

(Remplacez année, mois et jour par la date pour laquelle vous devriez avoir des données.)

Convertir les anciennes données de EasyWeather (optionnel).¶

Si vous utilisiez EasyWeather avant de décider d’utiliser pywws, vous pouvez convertir les données que EasyWeather a enregistré, vers format de pywws. Localisez votre fichier EasyWeather.dat et convertissez-le ainsi:

python -m pywws.EWtoPy EasyWeather.dat ~/weather/data

Indiquer certaines options de configuration.¶

Après avoir exécuté pywws.LogData, il devrait y avoir un fichier de configuration nommé ‘weather.ini’ dans votre répertoire de données. Ouvrez ce fichier avec un éditeur de texte. Vous devriez y trouver des lignes semblables à celle-ci:

[config]
ws type = 1080
logdata sync = 1

Vous devez ajouter une nouvelle entrée nommée day end hour dans la section [config]. Ceci indique à pywws quelle convention vous souhaitez utiliser pour le calcul du sommaire des données quotidiennes. En Grande-Bretagne, le ‘jour météorologique’ s’étale habituellement de 09:00 à 09:00 GMT (10:00 à 10:00 BST durant l’été), j’utilise donc 9 pour l’heure de fin du jour. Dans d’autres pays une valeur de 24 (ou 0) peut être souhaitable. Noter que cette valeur est définie à l’heure hivernale locale. Vous ne devriez pas avoir besoin de changer cette valeur pendant la saison chaude.

Après édition, votre fichier weather.ini devrait resembler à ceci:

[config]
ws type = 1080
logdata sync = 1
day end hour = 9

Pour plus de détails sur les options du fichier de configuration, voir weather.ini - format du fichier de configuration.

Traitement des données brutes.¶

pywws.LogData ne fait que copier les données brutes à partir de la station météo. Pour faire quelque chose d’utile avec ces données vous avez probablement besoin des sommaires horaire, quotidien et mensuel. Ces sommaires sont produits à partir du programme pywws.Process. Par exemple:

python -m pywws.Process ~/weather/data

Vous devriez avoir ainsi quelques fichiers traités à consulter:

more ~/weather/data/weather/daily/2012/2012-12-16.txt

Si vous changez votre période de fin du jour avec l’option de configuration day end hour, vous devrez re-traiter toutes vos données météo. Pour ce faire, exécutez le programme pywws.Reprocess:

python -m pywws.Reprocess ~/weather/data

Vous êtes maintenant prêt pour fixer une journalisation régulière ou continue, tel que décrit dans la section Comment configurer la journalisation horaire avec pywws ou Comment configurer le mode ‘live’ avec pywws.

Lire la documentation.¶

Le dossier doc du répertoire source de pywws contient une version HTML et une version en texte clair de la documentation ( à moins que vous ayez fait une installation directe avec pip). Les fichiers HTML peuvent être lus avec tous navigateurs. Débutez avec l’index (pywws) et suivez les liens à partir de ce point.

Commentaires ou questions? SVP, souscrivez à la liste d’envoi de pywws http://groups.google.com/group/pywws et laissez-le nous savoir.

Introduction¶

Pywws offre deux modes de fonctionnement très différents. Habituellement le programme Hourly devrait être exécuté à intervale régulier (habituellement chaque heure) à partir d’une tâche programmée (Cron). Ceci convient aux sites Web plutôt statiques, mais des mises à jour plus fréquentes peuvent être utiles pour des sites comme Weather Underground (http://www.wunderground.com/). Le plus récent programme LiveLog s’exécute continuellement et peut envoyer des données à chaque 48 secondes.

Notez: bien que ce document (et le nom du programme) réfère à la journalisation horaire (hourly), vous pouvez exécuter le programme Hourly aussi souvent ou peu fréquemment que vous le souhaitez, mais n’essayez pas de l’exécuter plus souvent que le double de la fréquence d’historique. Par exemple, si votre intervalle d’historique est de 10 minutes, n’exécutez pas Hourly plus fréquemment qu’aux 20 minutes.

Mise en route¶

Avant tout, vous devez installer pywws et vous assurer qu’il reçoit bien les informations de votre station météo. Voir Comment démarrer avec pywws pour plus de détails.

Essayez d’exécuter Hourly à partir de la ligne de commande, avec un haut niveau de commentaires pour que vous puissiez voir ce qui se passe:

python -m pywws.Hourly -vvv ~/weather/data

En moins de cinq minutes (assumant que votre intervalle de relevé soit de 5 minutes) vous devriez voir le message ‘live_data new ptr’, suivi par la recherche et le traitement de nouvelles données de la station météorologique.

Configurer l’emplacement des fichiers¶

Ouvrez votre fichier weather.ini avec un éditeur de texte. Vous devriez avoir une section [paths] similaire à ce qui suit (où xxx est votre nom d’usager):

[paths]
work = /tmp/weather
templates = /home/xxx/weather/templates/
graph_templates = /home/xxx/weather/graph_templates/

Éditez pour correspondre à votre installation et à vos préférences. work est un dossier temporaire utilisé pour emmagasiner les fichiers intermédiaires, templates est le dossier où vous gardez vos fichiers de gabarit texte et graph_templates est le dossier où vous gardez vos fichiers de gabarit graphes. Ne pas utiliser les dossiers exemple de pywws pour celà, puisqu’ils seront écrasés lors de mise à jour de pywws.

Copiez vos fichiers de gabarits texte et graphes dans les dossiers appropriés. Vous pouvez trouver les quelques exemples fournis avec pywws fort utiles pour débuter. Si vous avez installé pywws avec la commande pip, les exemples devrait se trouver dans le dossier /usr/share/pywws ou /usr/local/share/pywws ou similaire.

Configurer les tâches périodiques¶

Dans weather.ini vous devriez avoir les sections [logged], [hourly], [12 hourly] et [daily] similaires à celle-ci:

[logged]
services = []
twitter = []
plot = []
text = []

[hourly]
...

Ces sections spécifient ce que devrait faire Hourly à chaque exécution. Les tâches dans la section [logged] sont réalisées à chaque fois qu’une nouvelle donnée est enregistrée, les tâches dans la section [hourly] sont exécutées à chaque heure, les tâches dans la section [12 hourly] sont lancées deux fois par jour, tandis que les tâches dans la section [daily] sont réalisées une fois par jour.

Les entrées dans services sont une liste de services météo en ligne sur lesquels envoyer vos données météo. Les entrées plot et text sont des listes de fichiers gabarits graphes et textes à téléverser sur votre site web, et l’entrée twitter est une liste de gabarits pour les messages à poster sur Twitter. Ajoutez le nom de vos fichiers de gabarit et de services météo à l’entrée correspondante, par exemple:

[logged]
services = ['underground', 'metoffice']
twitter = []
plot = []
text = []

[hourly]
services = []
twitter = ['tweet.txt']
plot = ['7days.png.xml', '24hrs.png.xml', 'rose_24hrs.png.xml']
text = ['24hrs.txt', '6hrs.txt', '7days.txt']

[12 hourly]
services = []
twitter = []
plot = []
text = []

[daily]
services = []
twitter = ['forecast.txt']
plot = ['28days.png.xml']
text = ['allmonths.txt']

Vous pouvez réaliser un test de bon fonctionnement en enlevant la section last update du fichier weather.ini, puis exécutez Hourly de nouveau:

python -m pywws.Hourly -v ~/weather/data

Utilisation d’un script¶

L’installation de pywws inclu un petit script pywws-hourly.py à installer dans /usr/bin ou /usr/local/bin ou similaire. Vous devriez être en mesure d’utiliser ce script en exécutant Hourly:

pywws-hourly.py -v ~/weather/data

Exécuter en tant que tâche ‘cron’¶

La plupart des systèmes UNIX/Linux possèdent un service ‘cron’ qui à pour but d’exécuter un programme spécifié à un intervalle défini, même si vous n’êtes pas connecté à votre session. Vous éditez un fichier ‘crontab’ pour spécifier ce qui doit être exécuté et quand. Par exemple, pour exécuter Hourly à chaque heure, à zéro minutes de l’heure:

0 * * * *       pywws-hourly.py /home/jim/weather/data

Ceci devrait fonctionner, mais si ce n’est pas le cas vous n’obtiendrez probablement pas de messages d’erreur vous indiquant ce qui ne va pas. Il est préférable d’exécuter un script qui lance Hourly puis vous envoi un courriel avec tout message qui aurait pu être produit. Voici le script que j’utilise:

#!/bin/sh
#
# weather station logger calling script

if [ ! -d /data/weather/ ]; then
  exit
  fi

log=/var/log/log-weather

pywws-hourly.py -v /data/weather >$log 2>&1

# mail the log file
/home/jim/scripts/email-log.sh $log "weather log"

Vous devrez éditer beaucoup pour adapter à vos emplacements de dossier et ainsi de suite, mais il donne une certaine idée de ce qui peut être fait.

Commentaires ou questions? SVP, souscrivez à la liste d’envoi de pywws http://groups.google.com/group/pywws et laissez-le nous savoir.

Introduction¶

Pywws offre deux modes de fonctionnement très différents. Habituellement le programme Hourly devrait être exécuté à intervale régulier (habituellement chaque heure) à partir d’une tâche programmée (Cron). Ceci convient aux sites Web plutôt statiques, mais des mises à jour plus fréquentes peuvent être utiles pour des sites comme Weather Underground (http://www.wunderground.com/). Le plus récent programme LiveLog s’exécute continuellement et peut envoyer des données à chaque 48 secondes.

Mise en route¶

Avant tout, vous devez installer pywws et vous assurer qu’il reçoit bien les informations de votre station météo. Voir Comment démarrer avec pywws pour plus de détails.

Essayez d’exécuter LiveLog à partir de la ligne de commande, avec un haut niveau de commentaires pour que vous puissiez voir ce qui se passe:

python -m pywws.LiveLog -vvv ~/weather/data

En moins de cinq minutes (assumant que vous avez un intervalle de relevé de 5 minutes) vous devriez voir le message ‘live_data new ptr’, suivi par la recherche et le traitement de nouvelles données de la station météorologique. Laissez LiveLog fonctionner une ou deux minutes de plus, puis arrêtez le processus en tapant ‘<Ctrl>C’.

Configurer l’emplacement des fichiers¶

Ouvrez votre fichier weather.ini avec un éditeur de texte. Vous devriez avoir une section [paths] similaire à ce qui suit (où xxx est votre nom d’usager):

[paths]
work = /tmp/weather
templates = /home/xxx/weather/templates/
graph_templates = /home/xxx/weather/graph_templates/

Éditez pour correspondre à votre installation et à vos préférences. work est un dossier temporaire utilisé pour emmagasiner les fichiers intermédiaires, templates est le dossier où vous gardez vos fichiers de gabarit texte et graph_templates est le dossier où vous gardez vos fichiers de gabarit graphes. Ne pas utiliser les dossiers exemple de pywws pour celà, puisqu’ils seront écrasés lors de mise à jour de pywws.

Copiez vos fichiers de gabarits texte et graphes dans les dossiers appropriés. Vous pouvez trouver les quelques exemples fournis avec pywws fort utiles pour débuter. Si vous avez installé pywws avec la commande pip, les exemples devrait se trouver dans le dossier /usr/share/pywws ou /usr/local/share/pywws ou similaire.

Configurer les tâches périodiques¶

Dans weather.ini vous devriez avoir une section [live] similaire à celle-ci:

[live]
services = []
twitter = []
plot = []
text = []

Cette section spécifie ce que devrait faire pywws à chaque fois qu’il reçoit une lecture de la station météo, ex. toutes les 48 secondes. Les entrées services sont des listes de services météo en ligne sur lesquels envoyer vos données météo, ex. ['underground']. Les entrées plot et text sont des listes de fichiers gabarits de graphe et de texte à téléverser sur votre site web, et l’entrée twitter est une liste de gabarits pour les messages à poster sur Twitter. Vous devriez probablement laisser toutes ces entrées vides, sauf pour services.

Si vous utilisez YoWindow (http://yowindow.com/) vous pouvez ajouter l’entrée à la section [live] pour spécifier votre fichier YoWindow, ex.:

[live]
yowindow = /home/jim/data/yowindow.xml
services = ['underground']
...

Si vous ne les avez pas déjà, créez quatre sections supplémentaires dans votre fichier weather.ini : [logged], [hourly], [12 hourly] et [daily]. Ces sections doivent avoir des entrées similaires à la section [live], et spécifiez ce qui doit être fait chaque fois qu’une donnée est enregistrée (5 à 30 minutes, dépendant de votre intervalle), chaque heure, deux fois par jour et chaque jour. Ajoutez les noms de vos fichiers de gabarit à l’entrée appropriée, par exemple:

[logged]
services = ['underground', 'metoffice']
twitter = []
plot = []
text = []

[hourly]
services = []
twitter = ['tweet.txt']
plot = ['7days.png.xml', '24hrs.png.xml', 'rose_24hrs.png.xml']
text = ['24hrs.txt', '6hrs.txt', '7days.txt']

[12 hourly]
services = []
twitter = []
plot = []
text = []

[daily]
services = []
twitter = ['forecast.txt']
plot = ['28days.png.xml']
text = ['allmonths.txt']

Utilisation d’un script¶

L’installation de pywws inclu un petit script pywws-livelog.py qui se trouve dans le dossier /usr/bin ou /usr/local/bin ou similaire. Vous devriez être en mesure d’utiliser ce script pour exécuter LiveLog:

pywws-livelog.py -v ~/weather/data

Exécuter en arrière-plan¶

Afin que LiveLog continue de fonctionner après avoir fini d’utiliser votre ordinateur, vous devez exécuter ce programme en tant que ‘tâche en arrière-plan’. Sur la plupart des systèmes Linux / UNIX vous pouvez faire celà en ajoutant simplement le symbole (‘&’) à la fin de la ligne de commande. Par exemple:

pywws-livelog.py ~/weather/data &

Cependant, il peut être utile de savoir ce qui ne va pas si le programme se bloque pour une raison quelconque. LiveLog peut enregistrer ces messages dans un fichier d’historique, pour ce faire spécifiez l’option -l:

pywws-livelog.py -v -l ~/weather/data/pywws.log ~/weather/data &

Redémarrage automatique¶

Il y a une plusieurs manières de configurer un système Linux pour lancer un programme au démarrage de l’ordinateur. Habituellement pour ce faire, vous devez mettre un fichier dans /etc/init.d/, ce qui requière les privilèges ‘root’. Un problème un peu plus difficile est d’assurer qu’un programme redémarre s’il se bloque. Ma solution à ces deux problèmes consiste à exécuter le script cron suivant, toutes les heures.

#!/bin/sh

pidfile=/var/run/pywws.pid
datadir=/data/weather
logfile=$datadir/live_logger.log

# exit if process is running
[ -f $pidfile ] && kill -0 `cat $pidfile` && exit

# email last few lines of the logfile to see why it died
if [ -f $logfile ]; then
  log=/var/log/log-weather
  tail -40 $logfile >$log
  /home/jim/scripts/email-log.sh $log "weather log"
  rm $log
  fi

# restart process
pywws-livelog.py -v -l $logfile $datadir &
echo $! >$pidfile

Ce script enregistre l’identificateur de processus exécutant LiveLog dans le pidfile. Si le processus fonctionne, le script ne fait rien. Si le processus a bloqué, il m’envoie un courriel contenant les 40 dernières lignes du fichier d’historique (en utilisant un script qui crée un message et l’envoi par sendmail) puis redémarre LiveLog. Vous devrez éditer beaucoup pour adapter à vos emplacements de dossier et ainsi de suite, mais il donne une certaine idée de ce qui doit être fait.

Commentaires ou questions? SVP, souscrivez à la liste d’envoi de pywws http://groups.google.com/group/pywws et laissez-le nous savoir.

YoWindow¶

YoWindow est un widget météo qui peut afficher des données provenant d’une source internet ou de votre station météo. Pour afficher les données de votre station, pywws a besoin d’écrire dans un fichier local, en général toutes les 48 secondes lorsque de nouvelles données sont reçues. C’est facile à faire:

1. Arrêter toute instance de pywws

2. Copier le gabarit exemple yowindow.xml dans votre répertoire de gabarits text.

3. Si ce n’est déjà fait, éditez le fichier weather.ini et configurez la clé local_files dans la section [paths] pour un répertoire approprié pour votre fichier yowindow.

4. Ajoutez le modèle yowindow dans les tâches [live] de weather.ini. Mettre son paramètre à 'L' si le résultat est copié dans votre répertoire local au lieu d’être téléchargés sur un site ftp:

   [live]
   text = [('yowindow.xml', 'L')]
   

5. Redémarrez l’enregistrement live de pywws.

Vous pouvez vérifier que le fichier est mis à jour toutes les 48 secondes en utilisant more ou cat pour afficher à l’écran.

Finallement, configurez yowindow pour l’utilisation de ce fichier. Voir http://yowindow.com/pws_setup.php pour les instructions pour ce faire.

Twitter¶

Voir Comment configurer pywws pour poster des messages sur Twitter pour les instructions détaillées.

Weather Underground¶

Weather Underground (ou Wunderground) est l’un des plus anciens sites météorologiques dans le monde. Comme pour beaucoup d’autres services, pywws peut leur envoyer vos données météo via l’internet. Le module pywws.toservice gère cette communication pour toute une gamme de services en ligne .

La première étape consiste à vous créer un compte Weather Underground à cette adresse http://www.wunderground.com/members/signup.asp. Puis utilisez le formulaire “Add A Station” pour fournir les détails de votre station tel que la localisation et son type. Vous devriez par la suite obtenir un identificateur de station (station ID) et un mot de passe – prenez ces informations en note.

Assurez vous qu’aucune autre instance de pywws ne fonctionne, puis exécutez le programme pywws.toservice directement:

python -m pywws.toservice ~/weather/data underground

Celà devrait échouer, comme vous n’avez pas encore défini l’ID de votre station ou le mot de passe, mais ceci crée les entrées nécessaires dans le fichier weather.ini pour que vous puissiez l’éditer. Ouvrez weather.ini et trouvez la section [underground]:

[underground]
station = unknown
password = unknown

Remplacez les valeures unknown par votre Station ID et votre mot de passe.

Maintenant, essayez pywws.toservice de nouveau:

python -m pywws.toservice ~/weather/data underground

Si cela a fonctionné, vous pouvez télécharger votre dernier 7 jours de données. Notez que cela peut prendre un temps assez long, surtout si vous avez un intervalle d’enregistrement court. En premier éditez status.ini et supprimez l’entrée underground de la section [last update]. Ensuite, exécutez pywws.toservice avec l’option ‘catchup’ (rattrapage) et haute verbosité afin que vous puissiez voir le fonctionnement:

python -m pywws.toservice -vvc ~/weather/data underground

Lorsque tout fonctionne, vous pouvez ajouter ‘underground’ à la section des tâches [logged] du fichier weather.ini:

[logged]
services = ['underground']

[live]
services = ['underground_rf']

Fichiers prérequis.¶

Postersur Twitter requière certains logiciels supplémentaires. Voir Pré-requis - Mise à jour Twitter.

Créer un compte Twitter.¶

Vous pouvez poster des mise à jour météo sur votre compte Twitter ‘normal’, mais je crois qu’il est préférable d’avoir un compte distinct réservé à vos relevés météo. Ce qui pourrait être fort utile à une personne vivant dans votre voisinage, mais ne souhaitant pas savoir ce que vous avez pris au petit déjeuner.

Autoriser pywws à poster sur votre compte Twitter.¶

Si vous exécutez pywws sur un appareil de faible puissance tel qu’un routeur, il peut plus simple d’exécuter cette étape d’autorisation sur un autre ordinateur en autant que python-oauth2 y est installé. Utiliser un répertoire ‘data’ vide – un fichier weather.ini sera créé, dont le contenu pourra être copié dans votre fichier weather.ini réel en utilisant tout éditeur de texte.

Assurez vous qu’aucune autre instance de pywws ne fonctionne, puis exécutez le module TwitterAuth:

python -m pywws.TwitterAuth /data/weather

(Remplacez /data/weather par votre répertoire de données.)

Ceci ouvrira une fenêtre de navigation (ou vous donnera une URL à copier dans votre navigateur) où vous pourrez vous connecter à votre compte Twitter et autoriser pywws à poster. Votre navigateur vous affichera alors un nombre à 7 chiffre que vous aurez besoin de copier dans le programme TwitterAuth. Si tout s’est bien déroulé, votre fichier weather.ini devrait comporter une nouvelle section [twitter] avec les entrées secret et key. (Ne révéler à quiconque.)

Ajouter vos données de localisation (optionel).¶

Éditez votre fichier weather.ini et ajoutez les entrées latitude et longitude à votre section [twitter]. Par exemple:

[twitter]
secret = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
latitude = 51.501
longitude = -0.142

Créer un gabarit.¶

Les messages pour Twitter sont générés en utilisant un gabarit, tout comme sont créés les fichiers à téléverser sur votre site web. Copiez le gabarit exemple ‘tweet.txt’ dans votre dossier de gabarit, puis testez-le:

python -m pywws.Template /data/weather ~/weather/templates/tweet.txt tweet.txt
cat tweet.txt

(Remplacez /data/weather et ~/weather/templates par vos répertoires de données et de gabarits.) Si vous avez besoin de modifier le gabarit (ex. pour changer les unités de mesure ou la langue utilisée) vous pouvez l’éditer maintenant ou ultérieurement.

Poster votre premier Tweet météo.¶

Maintenant tout est pret pour exécuter ToTwitter:

python -m pywws.ToTwitter /data/weather tweet.txt

Si celà fonctionne, Votre nouveau compte Twitter aura posté son premier relevé météo. (Vous devriez supprimer le fichier tweet.txt maintenant.)

Ajouter les envois sur Twitter à vos tâche horaire.¶

Éditez votre fichier weather.ini et modifiez la section [hourly]. Par exemple:

[hourly]
services = []
plot = ['7days.png.xml', '24hrs.png.xml', 'rose_12hrs.png.xml']
text = [('tweet.txt', 'T'), '24hrs.txt', '6hrs.txt', '7days.txt']

Notez l’usage de l’indicateur 'T' – ce qui indique à pywws de 'Tweeter' le résultat du gabarit au lieu de le verser sur votre site par ftp.

Vous pourriez tout aussi bien choisir de plutôt modifier les sections [logged], [12 hourly] ou [daily], mais je crois que [hourly] est le plus approprié pour les envois sur Twitter.

Commentaires ou questions? SVP, souscrivez à la liste d’envoi de pywws http://groups.google.com/group/pywws et laissez-le nous savoir.

Introduction¶

Certaines parties de pywws peuvent être configurées pour utiliser votre langue locale au lieu de l’Anglais Britannique. Ceci requière un fichier de langage contenant la traduction des différentes phrases utilisées par pywws. Le projet repose sur les utilisateur qui fournissent ces traductions. Ce document décrit comment créer un fichier de langage.

La documentation de pywws peut aussi être traduite dans d’autres langues. C’est beaucoup de travail, mais pourrait être très utile aux utilisateurs potentiels qui ne lisent pas très bien l’anglais.

Prérequis.¶

En plus du logiciel pywws vous devez installer le paquet utilitaire GNU d’internationalisation gettext. Celui-ci est disponible dans la plupart des dépôts standard des distributions Linux, ou vous pouvez le télécharger à partir de http://www.gnu.org/software/gettext/ si vous devez le compiler vous même.

Choisir votre code de langue.¶

Les ordinateur utilisent les étiquettes d’identification de langues IETF (voir http://fr.wikipedia.org/wiki/%C3%89tiquette_d%27identification_de_langues_IETF). Par exemple, la Grande-Bretagne utilise en_GB qui est composé de 2 parties: en pour Anglais, et GB la version Britanique. Pour trouver le code correspondant à votre langue, consultez la liste sur http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes.

Mise en route¶

Votre dossier pywws doit déjà contenir un sous-dossier nommé translations. Celui-ci contient l’ensemble des fichiers de langue actuel, par exemple translations/fr/pywws.po contient la traduction Française. Si une de ces langues est ce que vous désirez, alors éditez votre fichier weather.ini et ajoutez une entrée language à la section [config], par exemple:

[config]
day end hour = 21
gnuplot encoding = iso_8859_1
language = sv

Vous devrez toujours compiler et installer le fichier de langue choisie. Ce qui est fait avec setup.py:

python setup.py msgfmt

S’il n’y a pas déjà de fichier pour votre langage, le reste de ce document vous indique comment en créer un.

Créer un fichier de langue.¶

La première étape consiste à créer un fichier contenant les phrases que vous devez traduire. Par exemple, pour créer un fichier source pour la langue française (code fr):

python setup.py xgettext
python setup.py msgmerge --lang=fr

Ce qui vous demandera de confirmer votre adresse courriel, puis créera un fichier pywws.po dans le répertoire translations/fr. Vous devez maintenant éditer le fichier pywws.po et remplir chaque ligne msgstr avec une traduction de la ligne msgid immédiatement au-dessus. La raison d’inclure votre adresse courriel est de permettre à chacun ayant une question à propos de la traduction de vous rejoindre. Sentez vous libre de mettre une adresse invalide si vous êtes préoccupé par le maintien de votre vie privée.

Après avoir édité le nouveau fichier de langue, il doit être compilé pour que pywws puisse l’utiliser. Ce qui est fait avec la commande msgfmt:

python setup.py msgfmt

N’oubliez pas de faire celà à chaque fois que vous éditez un fichier de langue.

Tester la traduction de pywws.¶

Le module Localisation peut être utilisé pour faire un test rapide de l’installation de votre fichier de langue:

python -m pywws.Localisation -t fr

Cela devrait afficher quelque chose comme ceci:

Locale changed from (None, None) to ('fr_FR', 'UTF-8')
Translation set OK
Locale
  decimal point: 23,2
  date & time: lundi, 17 décembre (17/12/2012 16:00:48)
Translations
  'NNW' => 'NNO'
  'rising very rapidly' => 'en hausse très rapide'
  'Rain at times, very unsettled' => 'Quelques précipitations, très perturbé'

Éditez l’entrée de langue dans votre fichier weather.ini pour utiliser votre code de langue (ex. fr), puis essayer d’utiliser Plot pour dessiner un graphe. L’axe des X du graphe devrait maintenant être étiquetée dans votre langue, utilisant la traduction que vous avez fournis pour ‘Time’, ‘Day’ ou ‘Date’.

Traduire la documentation.¶

Le système utilisé pour convertir les phrases utilisées dans pywws peut également servir à traduire la documentation. La commande pour extraire les phrases de la documentation est très similaire:

python setup.py xgettext_doc

Notez que ceci requière le logiciel sphinx utilisé pour ‘compiler’ la documentation. Après extraction des phraes, il créé les fichiers source pour votre langue. Dans cet exemple la langue est Français, avec le code sur deux lettres fr:

python setup.py msgmerge --lang=fr

Ceci créé quatre fichiers (index.po, essential.po, guides.po et api.po) lesquels contiennent les textes (souvent des paragraphes entier) extraits à partir des différentes parties de la documentation.

Ces fichiers peuvent être édités de la même manière que le fichier pywws.po. Complétez chaque msgstr avec une traduction de la phrase msgid juste au-dessus. Notez que certaines chaînes (par exemple, URL et liens vers d’autres parties de la documentation) ne doivent pas être traduites. Dans ces cas, le msgstr doit être laissé vide.

Traduire toute la documentation de pywws représente beaucoup de travail. Toutefois, lorsque la documentation est compilée toutes les chaînes non traduites reprennent leur valeur anglaise originale. Cela signifie qu’une traduction partielle pourrait quand même être utile - Je suggère de commencer par la première page de la documentation, index.po.

Visionner votre documentation traduite.¶

Tout d’abord convertir les fichiers de langue nouvellement édités:

python setup.py msgfmt

Puis. effacez l’ancienne documentation (si existante) et refaire en utilisant votre langage:

rm -Rf doc/html/fr
LANG=fr python setup.py build_sphinx

Notez que la commande build_sphinx n’a pas d’option --lang, donc le la langue est définie par une variable d’environnement temporaire.

Finallement, vous pouvez voir la documentation traduite en utilisant un navigateur web pour afficher le fichier doc/html/fr/index.html.

Mettre à jour les fichiers de langue.¶

Comme pywws évolue, de nouvelles phrases peuvent avoir été ajoutées et nécessiteront que votre fichier de traduction évolu lui aussi; ce qui est très facile à faire. Premièrement, Vous devez ré-extraire les phrases à traduire, puis les fusionner avec les fichier de langue existant. Ce qui est fait en répétant les commandes utilisées pour créer les fichiers:

python setup.py xgettext
python setup.py xgettext_doc
python setup.py msgmerge --lang=fr

Ceci devrait ajouter de nouvelles phrases à vos fichiers de langue, sans modifier les phrases que vous avez déjà traduits.

Si le source original Anglais a changé depuis votre dernière traduction, certaines phrases peuvent être marquées par gettext comme #, fuzzy (floue) . Vous devez vérifier que votre traduction est toujours adéquate pour ces phrases – Le changement peut être mineur (par ex. une correction d’orthographe) mais il pourrait être très important. Lorsque vous avez vérifié (et corrigée si nécessaire) la traduction, enlever la ligne #, fuzzy.

Envoyer la traduction à Jim¶

I’m sure you would like others to benefit from the work you’ve done in translating pywws. Please, please, please send a copy of your language file(s) (for example pywws.po) to jim@jim-easterbrook.me.uk. When you send a new translation you need to include details of which pywws version it is based on – the easiest way to do this is to include the value of commit from the file pywws/version.py in your email.

Commentaires ou questions? SVP, souscrivez à la liste d’envoi de pywws http://groups.google.com/group/pywws et laissez-le nous savoir.

config: diverses configuration système¶

[config]
ws type = 1080
day end hour = 21
gnuplot encoding = iso_8859_1
template encoding = iso-8859-1
language = en
logdata sync = 1
rain day threshold = 0.2

ws type est le “type” de station. Il devrait être fixé à 1080 pour la plupart des stations météo, ou 3080 si la console de votre station affiche l’éclairement solaire.

day end hour est la fin du “jour météorologique”, selon l’heure locale sans tenir compte de l’heure d’été. Généralement, les valeurs sont 21, 9, ou 24.

gnuplot encoding est l’encodage de texte utilisé lors du tracé de graphes. La valeur par défaut est iso_8859_1 permettant le symbole des degrés, fort utile dans une application météorologique! D’autres valeurs peuvent être nécessaire si votre langue comporte des caractères accentués. Les valeurs possible dépendent de votre installation gnuplot, quelques expérimentations peuvent donc être nécessaire.

template encoding est l’encodage de text utilisé pour le gabarit. La valeur par défaut est iso-8859-1, ce qui est l’encodage utilisé dans les gabarits d’exemple. Si vous créez des gabarits avec un autre jeu de caractère, vous devez changer cette valeur pour celle de vos gabarits.

language est utilisé pour traduire pywws. Il est optionnel, puisque pywws utilise habituellement la langue par défaut de l’ordinateur tel que configuré par la variable d’environnement LANG. Vous trouverez les langages disponibles dans le sous-dossier translations de votre installation pywws. Si vous configurez une langue qui n’est pas inclue, pywws affichera en anglais.

logdata sync configure la qualité de la synchronisation utilisé par pywws.LogData. Fixer à 0 pour rapide & imprécis ou 1 pour plus lent, mais précis.

rain day threshold est la quantité de pluie (en mm) tombée en une journée pour qu’elle puisse être considéré comme un jour de pluie dans les données sommaires mensuels .

paths: dossiers dans lesquels sont emmagasinés les gabarits, etc.¶

[paths]
templates = /home/$USER/weather/templates/
graph_templates = /home/$USER/weather/graph_templates/
user_calib = /home/jim/weather/modules/usercalib
work = /tmp/weather

Ces trois entrées spécifient où sont emmagasinés vos gabarits de texte et de graphes, où doivent être créé les fichiers temporaires, et la localisation de votre module de calibration (si utilisé).

live: tâches à accomplir à chaque 48 secondes¶

[live]
services = ['underground']
twitter = []
text = []
plot = []
yowindow = /home/jim/data/yowindow.xml

Cette section spécifie les tâche devant être effectuées pour chaque échantillonnage pendant la ‘journalisation temps réel’, c.à.d. chaque 48 secondes. Il est peu probable que vous vouliez faire autre chose que le téléversement à Weather Underground ou la mise à jour du fichier YoWindow aussi souvent.

services est une liste de ‘services’ auxquels envoyer vos données. Chaque service listé doit avoir un fichier de configuration dans le dossier pywws/services/. Voir pywws.toservice pour plus de détails.

twitter est une liste de gabarit texte à traiter avant de les poster sur Twitter.

text et plot sont des listes de gabarits texte et graphe à traiter et à téléverser sur votre site web.

yowindow indique le chemin complet du fichier au format xml à générer pour le widget YoWindow weather (voir http://yowindow.com/). Si vous n’employez pas YoWindow, omettez cette entrée.

logged: tâches à accomplir chaque fois que la station enregistre une lecture¶

[logged]
services = ['underground', 'metoffice']
twitter = ['tweet.txt']
text = []
plot = []

Cette section spécifie les tâche devant être réalisées chaque fois qu’une donnée est lue en mode ‘temps réel’ ou chaque fois qu’une tâche horaire cron est exécutée.

services est une liste de ‘services’ auxquels envoyer vos données. Chaque service listé doit avoir un fichier de configuration dans le dossier pywws/services/. Voir pywws.toservice pour plus de détails.

twitter est une liste de gabarit texte à traiter avant de les poster sur Twitter.

text et plot sont des listes de gabarits texte et graphe à traiter et à téléverser sur votre site web.

hourly: tâches à réaliser à chaque heure¶

[hourly]
services = []
twitter = ['tweet.txt']
text = ['24hrs.txt', '6hrs.txt', '7days.txt', 'feed_hourly.xml', 'allmonths.txt']
plot = ['7days.png.xml', '24hrs.png.xml', 'rose_12hrs.png.xml']

Cette section spécifie les tâches à réaliser à chaque heure en mode ‘temps réel’ ou exécutées en tant que tâche horaire cron.

services est une liste de ‘services’ auxquels envoyer vos données. Chaque service listé doit avoir un fichier de configuration dans le dossier pywws/services/. Voir pywws.toservice pour plus de détails.

twitter est une liste de gabarit texte à traiter avant de les poster sur Twitter.

text et plot sont des listes de gabarits texte et graphe à traiter et à téléverser sur votre site web.

12 hourly: tâches à réaliser à chaque 12 heures¶

[12 hourly]
services = []
twitter = []
text = []
plot = []

Cette section spécifie les tâches à réaliser à chaque 12 heures en mode ‘temps réel’ ou exécutées en tant que tâche horaire cron. Utilisez pour des choses qui ne changent pas très souvent, tel que les graphes mensuels.

services est une liste de ‘services’ auxquels envoyer vos données. Chaque service listé doit avoir un fichier de configuration dans le dossier pywws/services/. Voir pywws.toservice pour plus de détails.

twitter est une liste de gabarit texte à traiter avant de les poster sur Twitter.

text et plot sont des listes de gabarits texte et graphe à traiter et à téléverser sur votre site web.

daily: tâches à faire à chaque 24 heures¶

[daily]
services = []
twitter = []
text = ['feed_daily.xml']
plot = ['2008.png.xml', '2009.png.xml', '2010.png.xml', '28days.png.xml']

Cette section spécifie les tâches à réaliser à chaque jour en mode ‘temps réel’ exécutées en tant que tâche horaire cron. Utilisez pour des choses qui ne changent pas très souvent, tel que les graphes mensuels ou annuels.

services est une liste de ‘services’ auxquels envoyer vos données. Chaque service listé doit avoir un fichier de configuration dans le dossier pywws/services/. Voir pywws.toservice pour plus de détails.

twitter est une liste de gabarit texte à traiter avant de les poster sur Twitter.

text et plot sont des listes de gabarits texte et graphe à traiter et à téléverser sur votre site web.

ftp: configuration du téléversement à un site web¶

[ftp]
local site = False
secure = False
site = ftp.your_isp.co.uk
user = username
password = userpassword
directory = public_html/weather/data/

Ces entrées fournissent des détails sur votre site web (ou répertoire local) où doivent être transférés les fichier de texte et de graphe traités.

local site spécifie si les fichiers doivent être copiés dans un dossier local ou envoyé sur un site distant. Vous pouvez vouloir fixer ce paramètre si votre serveur web fonctionne sur le même ordinateur qui exécute pywws.

secure spécifie si le transfert des fichiers utilise SFTP (FTP sécurisé) au lieu de l’habituel FTP. Votre hébergeur doit être en mesure de vous dire si vous pouvez utiliser SFTP.

site est l’adresse web de votre site FTP à laquelle transférer vos fichiers.

user et password sont les informations de branchement pour votre site FTP. Votre hébergeur doit vous avoir fourni ces informations.

directory spécifie où sur le site FTP (ou le disque local) les fichiers doivent être envoyés. Notez que vous pourriez devoir expérimenter quelque peu - vous pourriez par exemple devoir utiliser un caractère ‘/’ au début de votre adresse.

twitter: configuration pour poster sur Twitter¶

[twitter]
secret = longstringofrandomcharacters
key = evenlongerstringofrandomcharacters
latitude = 51.365
longitude = -0.251

secret et key sont les données d’authentification fournies par Twitter. Pour les configurer, exécutez le programme TwitterAuth.py.

latitude et longitude sont vos données de localisation et sont optionnelles. Si vous les incluez dans vos ‘tweets météo’ vos utilisateurs pourront voir où est située votre station. Ce qui pourrait aider les utilisateurs à trouver votre station s’ils cherchent par localisation.

underground, metoffice, temperaturnu etc: configuration pour poster sur ces ‘services’¶

[underground]
station = IXYZABA5
password = secret

Ces sections contiennent l’information nécessaire pour envoyer vos données sur ces services météo, tel que mot de passe et ID de votre station. Le nom de ces entrées de données dépend du service. L’exemple montré affiche les informations pour Weather Underground.

station est le PWS ID (Identificateur de station) alloué à la station météo par Weather Underground.

password est votre mot de passe pour Weather Underground.

fixed: valeurs copiées à partir des “blocs fixes” de la station météo¶

[fixed]
pressure offset = 7.4
fixed block = {...}

pressure offset est la différence entre la pression de l’air absolue et relative; copié à partir de la station météorologique, en supposant que vous l’avez configuré pour afficher la bonne pression relative.

fixed block est toutes les données stockées dans les 256 octets de mémoire de la station. Cela comprend les valeures minimales et maximum, les paramètres de seuil d’alarme, unités de mesure et ainsi de suite.

clock: information de synchronisation¶

[clock]
station = 1360322930.02
sensor = 1360322743.69

Ces valeurs enregistrent le temps calculé lorsque l’horloge de la station a enregistrée certaines données et lorsque les capteurs extérieurs ont transmis un nouveau jeu de données. Elles sont utilisées pour tenter d’empêcher le plantage de l’interface USB si l’ordinateur accède à la station météo en même temps que l’un ou l’autre de ces événements, un problème commun à de nombreuses stations compatibles EasyWeather. Les durées sont mesurées toutes les 24 heures pour permettre la dérive de l’horloge

last update: date et heure de la plus récente tâche complétée¶

[last update]
hourly = 2013-05-30 19:04:15
logged = 2013-05-30 19:04:15
daily = 2013-05-30 09:04:15
openweathermap = 2013-05-30 18:59:15
underground = 2013-05-30 18:58:34
metoffice = 2013-05-30 18:59:15
12 hourly = 2013-05-30 09:04:15

Ces enregistrement affichent la date et l’heure de la dernière exécution réussie des diverses tâches. Ils sont utilisés pour permettre aux tâches infructueuses (ex. panne de réseau empêchant les téléversements) d’être réessayé après quelques minutes.

Arrière-plan¶

L’utilisation de votre station météorologique peut être amusant, et les rapports quotidiens des diverses données des sites météo peuvent être très utiles pour vos voisins afin de vérifier les conditions climatiques. Cependant, à un moment donné, vous voudrez peut-être savoir quel sont les effets de la météo sur votre corps, et si il y a une façon de savoir quand il est bon ou non de travailler à l’extérieur.

Nous entrons ici dans un royaume entier de calculs basés sur l’énergie de transfert à travers les murs, et la résistance offerte par ceux-ci. Ce qui peut être une grande aventure de la connaissance, et peut vous faire économiser beaucoup d’argent, et découvrir comment l’énergie se déplace tout autour.

Introduction¶

L’Humidex est un outil pour déterminer comment un corps humain réagit à la combinaison du vent, de l’humidité et de la température. Fondement de la différence de température entre votre corps et votre peau et est complémentaire à ISO 7243 “Hot Environments - Estimation of the heat stress on working man”. Quelques remarques importantes,

• Ces indices sont fondés sur un certain nombre d’hypothèses qui peuvent résulter en une sur- ou sous-estimation de l’état de vos organes internes

• Une station météo personnelle peut ne pas afficher les conditions précises, et donc sur ou sous-estimer l’humidité, le vent ou la température.

• Le choix de vêtements a un effet sur la fatigue et la capacité des organes à rejeter la chaleur, un Indice d’humidité faible ne signifie pas que vous puissiez porter n’importe quoi

• Un entraînement personnel affectera la réaction du corps à une température changeante et l’expérience aidera à savoir quand arrêter de travailler

• La durée des activités qui peuvent être exécutées requiert la connaissance de l’intensité, ce qui ne peut pas être représenté par cet index

Hypothèse¶

Un certain nombre d’hypothèses ont été faites pour effectuer ce travail qui va affecter directement sa facilité d’utilisation. Ces hypothèses n’ont pas été rendues disponible par Environnement Canada, qui sont les développeurs à l’origine de l’Humidex utilisé dans la fonction PYWWS cadhumidex. Il est suffisamment sûr cependant de dire que la suite aurait été certaines hypothèses

• Type de vêtement, épaisseur

• Surface de la peau exposée à l’air libre

• Exposition au soleil

Cependant, il y a un certain nombre d’hypothèses que pywws doit faire dans le calcul de l’Humidex :

• Les relevés d’humidité, de vent et de température sont exacts

Il y a aussi les hypothèses au sujet du type de corps des individus et de leur ‘acclimatation’

• L’entraînement physique d’un individu affectera la réponse de son corps face à des changements de température

• L’expérience aidera à savoir quand arrêter de travailler

Références importantes¶

Being Prepared for Summer - http://www.ec.gc.ca/meteo-weather/default.asp?lang=En&n=86C0425B-1

Utilisation¶

La fonction est descriptivement nommé cadhumidex et a la température et l’humidité comme paramètres, essentiellement la fonction agit comme une conversion et peut être utilisée d’une manière simple:

<ycalc>cadhumidex(data['temp_out'],data['hum_out'])</ycalc>

En l’assemblant, j’ai ajouté des couleurs qui suivent les couleurs d’avertissement de base et les différentes échelles pour produire un graphique décent:

<?xml version="1.0" encoding="ISO-8859-1"?>
<graph>
  <title>Humidity Index, Bands indicate apparent discomfort in standard on-site working conditions</title>
  <size>1820, 1024</size>
  <duration>hours=48</duration>
  <xtics>2</xtics>
  <xformat>%H%M</xformat>
  <dateformat></dateformat>
  <plot>
    <yrange>29, 55</yrange>
    <y2range>29, 55</y2range>
    <ylabel></ylabel>
    <y2label>Humidex</y2label>
    <source>raw</source>
    <subplot>
      <title>Humidex</title>
      <ycalc>cadhumidex(data['temp_out'],data['hum_out'])</ycalc>
      <colour>4</colour>
      <axes>x1y2</axes>
    </subplot>
    <subplot>
      <title>HI > 54, Heat Stroke Probable</title>
      <ycalc>54</ycalc>
      <axes>x1y2</axes>
      <colour>1</colour>
    </subplot>
    <subplot>
      <title>HI > 45, Dangerous</title>
      <ycalc>45</ycalc>
      <axes>x1y2</axes>
      <colour>8</colour>
    </subplot>
    <subplot>
      <title>HI > 40, Intense</title>
      <ycalc>40</ycalc>
      <axes>x1y2</axes>
      <colour>6</colour>
    </subplot>
    <subplot>
      <title>HI > 35, Evident</title>
      <ycalc>35</ycalc>
      <axes>x1y2</axes>
      <colour>2</colour>
    </subplot>
    <subplot>
      <title>HI > 30, Noticeable</title>
      <ycalc>30</ycalc>
      <axes>x1y2</axes>
      <colour>3</colour>
    </subplot>
  </plot>
</graph>

N’exécutez pas la dernière mise à jour?¶

Si vous n’utilisez pas ou ne désirez pas utiliser la dernière mise à jour, vous pouvez l’implémenter à l’aide d’un <ycalc> plus long, comme suit:

<ycalc>data['temp_out']+0.555*(6.112*10**(7.5*data['temp_out']/(237.7+data['temp_out']))*data['hum_out']/100-10)</ycalc>