SunAltitude

SunAltitude est un logiciel en ligne de commande qui calcule :

• la hauteur du soleil (sun altitude), c'est-à-dire l'angle entre l'horizon et le centre du soleil
• l'altitude minimale d'éclairement solaire (minimum sun visibility height), c'est-à-dire l'altitude par rapport au sol à partir de laquelle le bord supérieur du soleil est visible

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 d'un tableau de données

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

• la colonne 1 est l'heure (HH:MM:SS)
• la colonne 2 est l'angle entre l'horizon et le centre du soleil, en degrés
• la colonne 3 est l'altitude par rapport au sol à partir de laquelle le bord supérieur du soleil est visible, en km

Exemple :

>SunAltitude.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.
Interval is 600 seconds.

Column 1 is the time (HH:MM:SS).
Column 2 is the sun center angle with respect to the horizon, in degrees.
Column 3 is the minimum height at which the sun upper limb is visible, in km.

Time     	Alt (°)	Height (km)
00:00:00	-34.38	1365.54
00:10:00	-34.26	1354.97
00:20:00	-34.05	1335.50
00:30:00	-33.74	1307.53
00:40:00	-33.34	1271.59
00:50:00	-32.85	1228.35
01:00:00	-32.26	1178.58
01:10:00	-31.59	1123.14
01:20:00	-30.83	1062.95
01:30:00	-29.99	998.92
01:40:00	-29.08	931.99
01:50:00	-28.09	863.08
02:00:00	-27.03	793.05
...

Génération d'un graphique

L'axe des abscisses est l'heure du jour considéré.
La courbe rouge est l'angle entre l'horizon et le centre du soleil, en degrés, selon l'axe gauche des ordonnées
La courbe verte est l'altitude minimale d'éclairement solaire, en km, selon l'axe droit des ordonnées

Exemple :

>SunAltitude.exe --day 12082007 --latitude 40 --longitude 3 --altitude 0.2 --graph 'test.png'

Téléchargement

La version actuelle est 1.0.1.0.

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

SunAltitude a été développé en C# sous MonoDevelop 2.0. Il peut aussi être compilé sous Visual Studio 2008.
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]
              [--gnuplot ""] [--graph null|]
              [--height ] [--width ]

  Options:
    help      Shows this message.
    day       Date for which the values are calculated.
              Format is DDMMYYYY (e.g. 12012006 for 12 January 2006).
    start     Start time of the calculations range.
              Format is HH:mm (e.g. 04:30). Default is 00:00.
    end       End time of the calculations range.
              Format is HH:mm (e.g. 18:15). Default is 24:00.
    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 seconds
              between two computations. Default is 600 (10 minutes).
    refract   Indicates if the atmospheric refraction is accounted for.
    verbose   Shows legend.
    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 -- requires gnuplot
              set to null or true if the image is to be sent to stdout.
    height    height of the png image, in pixels. Default is 400.
    width     width of the png image, in pixels. Default is 745.
]]>