SunTimes

SunTimes est un logiciel en ligne de commande qui calcule, pour un jour donné ou une période donnée :

• les heures de transit, de lever et de coucher du soleil.
• les heures des crépuscules civils, nautiques et astronomiques du matin et du soir. Les crépuscules sont définis respectivement par une hauteur du centre du soleil sous l'horizon de -6°, -12° et -18°.
• les durées de jour, calculées entre le lever et le coucher du soleil, ainsi qu'entre les crépuscules civils, nautiques et astronomiques du matin et du soir.
• la hauteur maximale du centre du soleil par rapport à l'horizon (au moment du transit), ainsi que les hauteurs minimales du centre du soleil par rapport à l'horizon du jour précédent et du jour suivant.

Le logiciel a besoin de la position de l'observateur (longitude, latitude, altitude au dessus du niveau de la mer) et prend optionnellement en compte la réfraction atmosphérique.
Des algorithmes très précis ont été utilisés pour le calcul de la position du soleil, néanmoins, les conditions atmosphériques locales peuvent affecter la précision des résultats.
Exceptionnellement, et dans des combinaisons très particulières de date et de position d'observateur, l'algorithme peut ne pas converger. Cette limitation sera sans effet pour la majorité des utilisateurs.

Le programme fournit soit des données textuelles tabulées, soit un graphique.

Génération des données pour une seule journée

SunTimes affiche les heures de lever, coucher, crépuscules civil, nautique et astronomiques du matin et du soir. Il indique aussi la durée de la journée, calculée du lever au coucher du soleil, mais aussi entre les divers crépuscules. Enfin, il précise la hauteur maximale du soleil par rapport à l'horizon, ainsi que les hauteurs minimales du jour précédent et du jour suivant.

Exemple :

>SunTimes.exe --day 12082007 --latitude 40 --longitude 3 --altitude 0.2 --verbose
Values for 12/08/2007 at 0.20 km height, 40° latitude and 3° longitude.

Morning Astronomical Twilight      : 03:10:08
Morning Nautical Twilight          : 03:48:45
Morning Civil Twilight             : 04:24:34

Sunrise                            : 04:57:08
Sun Transit                        : 11:53:06
Sunset                             : 18:49:03

Evening Civil Twilight             : 19:21:38
Evening Nautical Twilight          : 19:57:26
Evening Astronomical Twilight      : 20:36:04

Length Of Day:
- between sunrise and sunset       : 13:51:56
- between civil twilights          : 14:57:04
- between nautical twilights       : 16:08:41
- between astronomical twilights   : 17:25:56

Sun Elevations from observer's horizon, without atmospheric refraction:
Previous Minimum Sun Altitude  : -34.40°
Maximum Sun Altitude           : 65.45°
Next Minimum Sun Altitude      : -34.70°

Génération d'un tableau de données sur plusieurs jours

Les résultats sont formatés sur dix-sept colonnes :

• la colonne 1 est le jour (JJ/MM/AAAA).
• la colonne 2 est l'heure du crépuscule astronomique du matin.
• la colonne 3 est l'heure du crépuscule nautique du matin.
• la colonne 4 est l'heure du crépuscule civil du matin.
• la colonne 5 est l'heure du lever de soleil.
• la colonne 6 est l'heure du midi solaire.
• la colonne 7 est l'heure du coucher de soleil.
• la colonne 8 est l'heure du crépuscule civil du soir.
• la colonne 9 est l'heure du crépuscule nautique du soir.
• la colonne 10 est l'heure du crépuscule astronomique du soir.
• la colonne 11 est la durée de la journée entre le lever et le coucher du soleil.
• la colonne 12 est la durée de la journée entre les crépuscules civils.
• la colonne 13 est la durée de la journée entre les crépuscules nautiques.
• la colonne 14 est la durée de la journée entre les crépuscules astronomiques.
• la colonne 15 est l'angle minimal entre l'horizon et le centre du soleil, pour le jour précédent, en degrés.
• la colonne 16 est l'angle maximal entre l'horizon et le centre du soleil, en degrés.
• la colonne 17 est l'angle minimal entre l'horizon et le centre du soleil, pour le jour suivant, en degrés.

Example:

>SunTimes.exe --start 01082007 --end 10082007 --latitude 40 --longitude 3 --altitude 0.2 --verbose
Values between 01/08/2007 and 10/08/2007 at 0.20 km height, 40° latitude and 3° longitude.
Interval is 1 day.

  Column 1  is the day (DD/MM/YYYY).
  Column 2  is the morning astronomical twilight time.
  Column 3  is the morning nautical twilight time.
  Column 4  is the morning civil twilight time.
  Column 5  is the sunrise time.
  Column 6  is the noon time.
  Column 7  is the sunset time.
  Column 8  is the evening civil twilight time.
  Column 9  is the evening nautical twilight time.
  Column 10 is the evening astronomical twilight time.
  Column 11 is the day length between sunrise and sunset.
  Column 12 is the day length between civil twilights.
  Column 13 is the day length between nautical twilights.
  Column 14 is the day length between astronomical twilights.
  Column 15 is the previous minimum sun altitude, in degrees.
  Column 16 is the maximum sun altitude, in degrees.
  Column 17 is the next minimum sun altitude, in degrees.

          	------ Morning ------	   	     	     	------ Evening ------	------- Length Of Day -------	------ Sun Altitudes -------
Day       	Astro	Nauti	Civil	Rise 	Noon 	Set  	Civil	Nauti	Astro	Day	Civil	Nauti	Astro	Prev Min	Max	Next Min
01 Aug 2007	02:54	03:36	04:13	04:47	11:54	19:02	19:36	20:13	20:55	14:15	15:23	16:38	18:01	-31.38		68.49	-31.63
02 Aug 2007	02:56	03:37	04:14	04:48	11:54	19:01	19:34	20:12	20:53	14:13	15:20	16:35	17:57	-31.63		68.24	-31.89
03 Aug 2007	02:57	03:38	04:15	04:49	11:54	18:60	19:33	20:11	20:51	14:11	15:18	16:33	17:54	-31.89		67.98	-32.15
04 Aug 2007	02:58	03:39	04:16	04:50	11:54	18:59	19:32	20:09	20:50	14:09	15:16	16:30	17:51	-32.15		67.72	-32.41
05 Aug 2007	02:60	03:40	04:17	04:51	11:54	18:58	19:31	20:08	20:48	14:07	15:14	16:27	17:48	-32.41		67.45	-32.68
06 Aug 2007	03:01	03:42	04:18	04:51	11:54	18:56	19:30	20:06	20:46	14:05	15:11	16:25	17:45	-32.68		67.18	-32.96
07 Aug 2007	03:03	03:43	04:19	04:52	11:54	18:55	19:28	20:05	20:45	14:03	15:09	16:22	17:42	-32.96		66.90	-33.24
08 Aug 2007	03:04	03:44	04:20	04:53	11:54	18:54	19:27	20:03	20:43	14:01	15:07	16:20	17:39	-33.24		66.62	-33.52
09 Aug 2007	03:06	03:45	04:21	04:54	11:54	18:53	19:26	20:02	20:41	13:59	15:04	16:17	17:36	-33.52		66.34	-33.81
10 Aug 2007	03:07	03:46	04:22	04:55	11:53	18:52	19:24	20:00	20:40	13:56	15:02	16:14	17:32	-33.81		66.05	-34.10

Génération d'un graphique combiné

SunTimes peut générer sur un seul fichier image trois graphiques différents. L'axe des abscisses correspond aux jours.
Le graphique du haut contient les heures de transit, de lever, coucher et crépuscules.
Le graphique du milieu contient les durées du jour, du level au coucher, ainsi qu'entre les divers crépuscules.
Le graphique du bas contient les hauteurs minimales et maximales du soleil.

Exemple :

>SunTimes.exe --start 01012007 --end 31122007 --latitude 40 --longitude 3 --altitude 0.2 --graph 'test.png' --height 600

Génération d'un graphique des heures de transit, lever, coucher et crépuscules

L'axe des abscisses correspond aux jours.
La courbe rouge correspond aux heures UTC de transit du soleil.
Les courbes grises correspondent aux heures UTC de level/coucher et de crépuscules civils, nautiques et astronomiques.

Exemple :

>SunTimes.exe --start 01012007 --end 31122007 --latitude 40 --longitude 3 --altitude 0.2 --graphtimes 'test.png'

Génération d'un graphique de durée du jour

L'axe des abscisses correspond aux jours.
La courbe jaune correspond à la durée de la journée entre le lever et le coucher du soleil.
Les courbes oranges correspondent aux durées de la journée entre les crépuscules civils, nautiques et astronomiques.

Exemple :

>SunTimes.exe --start 01012007 --end 31122007 --latitude 40 --longitude 3 --altitude 0.2 --graphdaylen 'test.png'

Génération d'un graphique de hauteur du soleil

L'axe des abscisses correspond aux jours.
Les courbes vertes correspondent aux hauteurs minimales et maximales du soleil.

Exemple :

>SunTimes.exe --start 01012007 --end 31122007 --latitude 40 --longitude 3 --altitude 0.2 --graphalt 'test.png'

Téléchargement

La version actuelle est 1.1.1.0.

Les sources et l'exécutable de SunTimes peuvent être téléchargés par SVN anonyme à l'adresse :
https://anonsvn.loudet.org/SunTimes/tags/

SunTimes a été développé en C# sous MonoDevelop 2.0. Il peut aussi être compilé sous Visual Studio Express 2010.
Il a été testé sous Linux Ubuntu 9.10/Mono 2.4.2.3, ainsi que sous Windows XP/.NET 2.0.

Installation

Sous Windows, il est nécessaire d'installer :

• soit .NET 2.0 Redistributable Package, disponible à l'adresse : .NET 2.0.
• soit Mono 2.4 ou postérieure, disponible à l'adresse : Mono.

Sous Linux, il est nécessaire d'installer :

• Mono 2.4 ou postérieure, disponible à l'adresse : Mono.

D'autre part, gnuplot doit être installé pour la génération des graphiques : Voir la page d'accueil de Gnuplot. Sous Linux, gnuplot a besoin de la police Arial qui doit être installée et la variable d'environnement GDFONTPATH doit être initialisée avec le chemin vers cette police, par exemple :

Historique

Aide

 | --start  --end 
    --longitude  --latitude  | --locator 
    --altitude  --step  [--refract|-r] [--verbose|-v]
    [--extended|-e] [--mysql|-m]
    [--gnuplot ""]
    [--graph null|""]
      [--height ] [--width ]
    [--graphtimes null|""]
      [--heighttimes ] [--widthtimes ]
    [--graphdaylen null|""]
      [--heightdaylen ] [--widthdaylen ]
    [--graphalt null|""]
      [--heightalt ] [--widthal ]

  Options:
    help        Shows this message.
    day         Date for which the values are calculated, for a single day
                calculation. Default is the current day.
                Format is DDMMYYYY (e.g. 12012006 for 12 January 2006).
    start       Start day for several days calculations.
                Format is DDMMYYYY (e.g. 12012006 for 12 January 2006).
    end         End day for several days calculations.
                Format is DDMMYYYY (e.g. 12012006 for 12 January 2006).
    longitude   Value between -180 and 180 expressing the longitude of the
                location in degrees. String representations are accepted.
                Positive values in the eastern hemisphere. Default is 0.
    latitude    Value between -90 and 90 expressing the latitude of the
                location in degrees. String representations are accepted.
                Positive values in the northern hemisphere. Default is 0.
    locator     Maidenhead locator of the location. If set, latitude
                and longitude options must not be defined.
    altitude    Real non negative value expressing the height of the observer
                for which the sun altitudes are calculated.
                Expressed in kilometers. Default is 0km (ground level).
    step        Positive integer value representing the interval in days
                between two computations. Default is 1.
    refract     Indicates if the atmospheric refraction is accounted for.
    verbose     Shows legend.
    extended    Shows full date and time (dd MMM YYYY HH:MM:SS).
    mysql       Shows full date and time in mysql format (YYYYMMddHHMMSS).
    gnuplot     Path to the gnuplot executable. If empty, default is:
                on Windows platforms [Program Files Directory]\gnuplot\bin\wgnuplot.exe.
                on Linux platforms /usr/bin/gnuplot.
    graph       Path to the png file that will be created.
                set to null if the image is to be sent to stdout.
                Plot contains sunrise/transit/set/twilights times, day lengths
                and altitudes.
    height      height of the png image, in pixels. Default is 400.
    width       width of the png image, in pixels. Default is 745.
    graphtimes  Path to the Times png file that will be created.
                set to null if the image is to be sent to stdout.
                Plot contains sunrise/transit/set/twilights times.
    heighttimes height of the Times png image, in pixels. Default is 400.
    widthtimes  width of the Times png image, in pixels. Default is 745.
    graphdaylen Path to the  Day Lengths png file that will be created.
                set to null if the image is to be sent to stdout.
                Plot contains day lengths.
    heightdaylen height of the  Day Lengths png image, in pixels. Default is 400.
    widthdaylen width of the Day Lengths png image, in pixels. Default is 745.
    graphalt    Path to the Altitudes png file that will be created.
                set to null if the image is to be sent to stdout.
                Plot contains sun altitudes.
    heightalt   height of the Altitudes png image, in pixels. Default is 400.
    widthalt    width of the Altitudes png image, in pixels. Default is 745.
]]>