crepyscule

Vous trouverez ici le code source utilisé pour générer les données de la page http://ptaff.ca/soleil/. Le projet fut originalement inspiré du fichier calculant le lever et le coucher du soleil fait par Henrik Härkönen et disponible sur sa page web.

Pour 1 ou 2 lieux géographiques sur la planète, crepyscule produit quatre graphiques :

1. Un graphique représentant l'heure de lever du soleil, l'heure de coucher du soleil et la durée totale de la journée (définie comme étant la durée entre le lever et le coucher du soleil) pour chaque jour de l'année;
2. Un graphique représentant l'altitude maximale du soleil pour chaque jour de l'année;
3. Un graphique qui présente la variation quotidienne de la durée du jour;
4. Un graphique qui présente le flux solaire pour chaque jour de l'année.

Si on choisit de représenter 2 lieux géographiques, les courbes des 2 lieux sont mis sur le même graphique, utilisant des couleurs différentes.

Pour l'instant, les titres des graphiques pour les axes peuvent être en anglais ou en français, la langue par défaut étant l'anglais. Voir les exemples d'utilisation pour plus de détails.

Developpé sous GNU/Linux, ce script est connu pour fonctionner sur GNU/Linux et sous Windows; si vous l'utilisez sous une autre plateforme que GNU/Linux, veuillez informer le développeur afin que la documentation correspondante soit publiée.

• python
• python :: numpy
• python :: rpy
• R
• R :: GDD

• crepyscule-1.1.3.tar.bz2
• crepyscule-1.1.3.zip

De façon générale, l'application devrait être appelée en ligne de commande de la façon suivante :

python crepyscule.py --filename=filename --ctime=ctime --background-color=bg_color --lat1=latitude1 --lon1=longitude1 --utc1=utc1 --tz1=timezone1 [--lat2=latitude2 --lon2=longitude2 --utc2=utc2 --tz2=timezone2] [--graph-sunrise-sunset] [--graph-sun-altitude] [--graph-daylight-variation] [--graph-solar-flux] [--text-sunrise-sunset] [--graph-all]

• Les paramètres entre [] sont optionnels; vous pouvez ainsi comparer 2 lieux géographiques. Notez que vous devez obligatoirement spécifier au moins l'une des options --graph-sunrise-sunset, --graph-sun-altitude, --graph-daylight-variation, --graph-solar-flux, --text-sunrise-sunset ou --graph-all;
• Le paramètre filename sert à indiquer le chemin et le nom de l'image. L'écriture de l'extension .png est obligatoire. Le premier graphique prend le nom exact du paramètre; l'altitude sera dans un fichier auquel les caractères « _alt » seront ajoutés avant l'extension .png, la variation quotidienne de la durée du jour sera dans un fichier auquel les caractères « _delta_t » seront ajoutés avant l'extension .png et le flux solaire sera dans un fichier auquel les caractères « _sf » seront ajoutés avant l'extension .png;
• Le paramètre ctime est utilisé pour déterminer l'année pour laquelle les valeurs seront calculées. De plus, dans le cas où un seul endroit est représenté, une droite verticale pointillée est tracée la journée correspondant à cette date. Les valeurs aux intersections entre cette ligne et les différentes courbes représentées, pour chacun des 4 graphiques, sont également indiquées;
• Le paramètre background-color doit être dans la liste des couleurs X11 et être écrit en lettres minuscules;
• La latitude et la longitude sont des nombres réels. Par exemple, on représentera 45°30' par 45.5;
• Le paramètre UTC représente le décalage par rapport au temps universel coordonné que l'on veut afficher pour la zone. Par exemple, pour New York ce paramètre vaut -5.0;
• Pour plus de détails sur la signification du paramètre tz, vous pouvez consulter le fichier summer_time.py ou encore le fichier TZrules.dat qui est fourni avec l'application kstars. Pour le système GNU/Linux, ce fichier se trouve habituellement dans /usr/share/apps/kstars/ lorsque cette application est installée;
• La langue d'affichage est déterminée par la variable d'environnement LANGUAGE.

python crepyscule.py --graph-all --filename montreal.png --ctime 1112121748 \
--background-color white --lat1 45.4667 --lon1 -73.75 --utc1 -5.0 --tz1 US

Créer les graphiques pour la ville de Montréal pour la date du 29 mars 2005.

export LANGUAGE='fr'; \
python crepyscule.py --graph-all --filename montreal.png --ctime 1112121748 \
--background-color white --lat1 45.4667 --lon1 -73.75 --utc1 -5.0 --tz1 US

Sous un système GNU/Linux; comme l'exemple précédent mais avec les axes des graphiques en français.

python crepyscule.py --graph-all --filename montreal_new_york.png --ctime 1112121748 \
--background-color white --lat1 45.4667 --lon1 -73.75 --utc1 -5.0 --tz1 US --lat2 40.75 --lon2 -73.99 --utc2 -5.0 --tz2 US

Créer les graphiques comparant les villes de Montréal et de New York pour la date du 29 mars 2005.

Vous pouvez consulter la documentation de l'interface API [En] de crepyscule.

Si vous trouvez un bogue, vous devez le rapporter à soleil.miguel@ptaff.ca

Miguel Tremblay

Copyright © 2005 Miguel Tremblay.

crepyscule est un logiciel libre; vous pouvez le redistribuer et/ou le modifier selon les termes de la GNU General Public License (Licence Publique Générale GNU) telle qu'elle a été publiée par la Free Software Foundation; soit la version 2 de la licence, soit (comme vous le souhaitez) toute version ultérieure.