• Français
  • English

crepyscule

Saisies d'écran
Lever, coucher du soleil et durée du jour, Montréal
Altitude maximale du soleil, Montréal
Variation quotidienne de la durée du jour, Montréal
Flux solaire, Montréal
Durée du crépuscule, Montréal
Lever, coucher du soleil et durée du jour, Montréal vs. New York
Altitude maximale du soleil, Montréal vs. New York
Variation quotidienne de la durée du jour, Montréal vs. New York
Flux solaire, Montréal vs. New York
Durée du crépuscule, Montréal vs. New York

Code source python pour la création de graphiques du lever/coucher du soleil

Introduction

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.

Prérequis

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.

Téléchargement

Manuel

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]

Sommaire des paramètres
Paramètre Description
--versionAffiche la version du programme et quitte
-h, --helpAffiche l'aide
-f FILENAME, --filename=FILENAMENom du fichier du graphique
--ctime=FTIMEctime pour le jour courant
--background-color=SBACKGROUNDCOLORCouleur de fond des graphiques
--lat1=FLAT1Latitude du premier emplacement (valeur négative au sud)
--lon1=FLON1Longitude du premier emplacement (valeur négative à l'ouest)
--utc1=FUTC1Nombre d'heures de différence du fuseau horaire comparé au temps UTC pour le premier emplacement
--tz1=STZ1Code du fuseau horaire pour l'heure d'été. Les valeurs possibles sont : IR, JD, EU, IQ, US, CH, EG, MX, SK, HK, NB, FK, PY, NZ, TS, BZ, CL, AU, TG, ZN, LB, SY, RU
--lat2=FLAT2Latitude du deuxième emplacement (valeur négative au sud)
--lon2=FLON2Longitude du deuxième emplacement (valeur négative à l'ouest)
--utc2=FUTC2Nombre d'heures de différence du fuseau horaire comparé au temps UTC pour le deuxième emplacement
--tz2=STZ2Fuseau horaire du deuxième emplacement. Cf. --tz1 pour les valeurs possibles
--graph-sunrise-sunsetCrée le graphique pour le lever/coucher du soleil
--graph-sun-altitudeCrée le graphique pour l'altitude du soleil
--graph-daylight-variationCrée le graphique pour la variation de la durée du jour
--graph-solar-fluxCrée le graphique pour le flux solaire
--graph-twilight-lengthCrée le graphique pour la durée du crépuscule
--text-sunrise-sunsetCrée un fichier texte contenant les valeurs de lever/coucher du soleil
--graph-allCrée tous les graphiques
  • 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.

Exemples d'utilisation

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.

API

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

Bogues

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

Auteur

Miguel Tremblay

Licence

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.


crepyscule

Création : 14 août 2005
Villeray
N 45° 33′ W 73° 36′

crepyscule

Dernière mise à jour : 23 mai 2014,
Villeray,
N 45° 33′ W 73° 36′