SunAzimuth

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

les heures de lever et de coucher du soleil
l'azimut du soleil lors de son lever ou de son coucher

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

SunAzimuth affiche les heures de lever et de coucher du soleil, ainsi que l'azimut du soleil au moment du lever et du coucher.

Exemple :

>SunAzimuth.exe --day 12082007 --latitude 40 --longitude 3 --altitude 0.2 --verbose
Location: 40° 00' 00.00" N  003° 00' 00.00" E  (JN10MA)
Values for 12/08/2007 at 0.20 km height.
True horizon -0.4540° below the astronomical horizon
Refraction effect: -0.6740°

Sunrise : 04:53:05	Azimuth : 068.88°
Sunset  : 18:52:26	Azimuth : 290.88°

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

Les résultats sont formatés sur cinq colonnes :

la colonne 1 est le jour (JJ/MM/AAAA).
la colonne 2 est l'heure du lever du soleil.
la colonne 3 est l'azimut du soleil lors du lever.
la colonne 4 est l'heure du coucher du soleil.
la colonne 5 est l'azimut du soleil lors du coucher.

Example:

>SunAzimuth.exe --start 01082007 --end 10082007 --latitude 40 --longitude 3 --altitude 0.2 --verbose
Location: 40° 00' 00.00" N  003° 00' 00.00" E  (JN10MA)
Values between 01/08/2007 and 10/08/2007 at 0.20 km height.
True horizon -0.4540° below the astronomical horizon
Interval is 1 day.
Refraction effect: -0.6740°

  Column 1  is the day (DD/MM/YYYY).
  Column 2  is the sunrise time.
  Column 3  is the sunrise azimuth.
  Column 4  is the sunset time.
  Column 5  is the sunset azimuth.

          	--- Sunrise ---		--- Sunset ----
Day       	Time   	Azimuth		Time   	Azimuth
01 Aug 2007	04:43	064.76°		19:05	295.03°
02 Aug 2007	04:44	065.11°		19:04	294.68°
03 Aug 2007	04:45	065.46°		19:03	294.33°
04 Aug 2007	04:45	065.82°		19:02	293.97°
05 Aug 2007	04:46	066.18°		19:01	293.60°
06 Aug 2007	04:47	066.55°		19:00	293.23°
07 Aug 2007	04:48	066.93°		18:59	292.85°
08 Aug 2007	04:49	067.31°		18:57	292.47°
09 Aug 2007	04:50	067.69°		18:56	292.08°
10 Aug 2007	04:51	068.08°		18:55	291.68°

Génération d'un graphique combiné

SunAzimuth 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 lever et de coucher.
Le graphique du milieu contient les durées du jour, du level au coucher.
Le graphique du bas contient les azimuts du soleil à son lever et à son coucher.

Exemple :

>SunAzimuth.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 lever et de coucher

L'axe des abscisses correspond aux jours.
Les courbes grises correspondent aux heures UTC de lever et de coucher.

Exemple :

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

Exemple de Graphique d'heures SunAzimuth

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.

Exemple :

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

Exemple de Graphique de durée du jour SunAzimuth

Génération d'un graphique de l'azimut du soleil

L'axe des abscisses correspond aux jours.
Les courbes vertes correspondent aux azimuts du soleil lors du lever et du coucher.

Exemple :

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

Exemple de Graphique d'azimuts du soleil SunAzimuth

Téléchargement

La version actuelle est 1.0.0.0.

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

SunAzimuth 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  [--norefract|-r] [--verbose|-v]
    [--extended|-e] [--mysql|-m]
    [--fromsouth]
    [--gnuplot ""]
    [--graph null|""]
      [--height ] [--width ]
    [--graphtimes null|""]
      [--heighttimes ] [--widthtimes ]
    [--graphdaylen null|""]
      [--heightdaylen ] [--widthdaylen ]
    [--graphaz null|""]
      [--heightaz ] [--widthaz ]

  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 positions 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.
    norefract   Disable accounting for atmospheric refraction effect.
    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).
    fromsouth   Measure azimuth from south, westward positive.
                By default azimuth is measured from north, eastward positive.
    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/set times, day length and
                sunrise/set azimuths.
    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.
    graphaz     Path to the Azimuths png file that will be created.
                set to null if the image is to be sent to stdout.
                Plot contains sun azimuths at sunrise and sunset.
    heightaz    height of the Azimuths png image, in pixels. Default is 400.
    widthaz     width of the Azimuths png image, in pixels. Default is 745.
]]>