API : crepyscule

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

Dans tous les cas il faut faire:

import crepyscule

Fonctions

Coucher/lever du soleil

get_sunrise_sunset_as_csv

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

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

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;

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'

À 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;