API : crepyscule

De Octet.ca

Cet article contient la documentation de l'API pour crepyscule.

Dans tous les cas il faut faire:

import crepyscule

Sommaire

[modifier] Fonctions

[modifier] Coucher/lever du soleil

[modifier] get_sunrise_sunset_as_csv

get_sunrise_sunset_as_csv(fLat1, fLon1, ctimeToday, fUTC1=0, sSummerTime1="",\
                    fLat2= None,fLon2=None,  fUTC2=0, sSummerTime2="")
[modifier] Arguments

Les arguments en italiques sont optionnels.

Argument Description Type
fLat1 Latitude du premier endroit float (Degré décimal)
fLon1 Longitude du premier endroit float (Degré décimal)
ctimeToday ctime d'une journée pour le premier endroit int
fUTC1 Nombre d'heures de différence avec le fuseau UTC pour le premier endroit float
SummerTime1 Code de 3 lettres indiquant les dates de changements d'heure d'été pour le premier endroit. Pas d'heure d'été si vide. string dans la liste de kstars
fLat2 Latitude du deuxième endroit float (Degré décimal)
fLon2 Longitude du deuxième endroit float (Degré décimal)
fUTC2 Nombre d'heures de différence avec le fuseau UTC pour le deuxième endroit float
SummerTime2 Code de 3 lettres indiquant les dates de changements d'heure d'été pour le deuxième endroit. Pas d'heure d'été si vide. string dans la liste de kstars
[modifier] Sortie

Liste de format CVS contenant 366 ou 367 entrées: une entrée pour l'entête plus une entrée pour chaque jour de l'année.

La première ligne contient:

  • la chaîne de caractères "Date";
  • La chaîne de caractères "Sunrise for" suivie de la latitude et de la longitude pour le premier endroit;
  • [optionnel] La chaîne de caractères "Sunrise for" suivie de la latitude et de la longitude pour le deuxième endroit, lorsqu'il y a 2 endroits de spécifiés;

La deuxième ligne contient:

  • La date pour le lever/coucher du soleil en format ISO8601;
  • L'heure de lever du soleil;
  • L'heure de coucher du soleil;
[modifier] Exemple
'Date,"Sunrise for 45.4667 -73.75 -5.0 US","Sunset for 45.4667 -73.75 -5.0 US", \
"Sunrise for 40.75 -73.99 -5.0 US","Sunset for 40.75 -73.99 -5.0 US"'
'2005-01-01,07:35,16:23,07:20,16:39'

[modifier] Altitude du soleil

[modifier] Variation de la durée du jour

[modifier] Flux solaire

[modifier] À faire

  • Fonctions qui retournent un dictionnaire avec les dates et une seule des valeurs possibles;
  • Ajouter les fonctions pour retourner, pour une année donnée et pour un endroit, seulement une liste;
  • Ajouter la reconnaissance du ctime ou de iso8601;
  • Traduire les strings;
Outils personnels