Créer des profils du manteau neigeux - retour accueil
git clone git://bebou.netlib.re/gelinive
Log | Files | Refs | README |
README.md (4693B)
1 
2
3 # Gelinive (A CHANGER)
4
5 Gelinive permet la création de profils stratigraphiques du manteau neigeux.
6 Il cherche à reproduire le comportement du logiciel gelinive, autrefois
7 utilisé par Météo France. Gelinive n'est plus maintenu et ne peut être
8 utilisé que sur des postes windows xp.
9
10 Gelinive est utilisé par l'association [nivose](http://nivose-vosges.org/) et
11 initialement développé à l'Université de Strasbourg.
12
13 ## Installation
14
15 ### Depuis les sources
16
17 Les dépendances notables sont :
18
19 * GNU Make pour la compilation/l'installation
20 * awk
21 * sed
22 * gnuplot 5.4
23 * dash
24
25 Pour tester le logiciel faire
26
27 make test
28
29 gnuplot laisse la gestion des polices au système. Il est donc assez peu
30 probable que les images que votre système génèrera soit strictement identiques
31 à celles présentes dans le dossier de test. Cela ne veut pas dire que le graph
32 n'est pas correct pour autant. Il est donc préférable de tester si tout fonctionne
33 correctement en comparant de visu les images de test et une générée avec :
34
35 < tests/[lieu] ./genilivetest -t "Fichier de test\n[lieu]" -f tests/[lieu]tab -c tests/[lieu]temp > [lieu].png
36
37 Si le résultat est cohérent, et il devrait l'être à partir du moment où le test
38 pour le tableau est passé avec succès, l'erreur peut être ignorée. Alternativement
39 pour le développement et faire des tests il est possible d'écraser les images références
40 du dossier tests par d'autres.
41
42 On peut ensuite construire et installer :
43
44 make
45 make install
46
47 Gelinive a été développé et testé sur debian 12.
48
49 ### Depuis un paquet
50
51 Des paquets Debian sont maintenus et disponibles pour les différentes versions
52 [ici](https://git.unistra.fr/arthur.pons/gelinive/-/releases).
53
54 Une fois téléchargé faire :
55
56 sudo apt install ./gelinive_?.?deb
57
58 En remplaçant les `?` par la version que vous souhaitez.
59
60 ### Désinstallation
61
62 Depuis les sources :
63
64 make uninstall
65
66 Depuis apt :
67
68 apt remove gelinive
69
70 ## Utilisation
71
72 ### En local en ligne de commande
73
74 L'exemple le plus typique serait :
75
76 < profil gelinive -t "Titre" -f tableau -c temperature > image.png
77
78 Avec `profil` étant un fichier texte contenant les données du sondage par
79 battage selon un certain format, tableau un chemin optionnel pour sauvegarder
80 les valeurs calculées de R et e et temperature le chemin vers le fichier
81 contenant les relevés de température. Pour plus d'infos voir le manuel de la
82 commande et le manuel du format :
83
84 man gelinive.1
85 man gelinive.5
86
87 Il est également possible d'utiliser directement geliniveplot sur un fichier de
88 profil déjà complété avec R e et H sans avoir à passer par gelinive (pour des
89 bases déjà existantes par exemple ) :
90
91 < profil geliniveplot "titre" temp > image.png
92
93 ### En montant un service web
94
95 Pour monter le service web il faut d'abord installer gelinive sur le serveur.
96
97 Une fois gelinive installé de quelque manière que ce soit, vous pouvez utiliser
98 le contenu du dossier cgi pour faire tourner un service web rudimentaire. Son
99 installation la plus basique consiste simplement à servir le dossier cgi
100 par un serveur web :
101
102 busybox httpd -p 80 -h cgi
103
104 Il faut ensuite remplir le formulaire et le soumettre pour obtenir le rendu de
105 gelinive.
106
107 **ATTENTION** : En l'état le service ne sauvegarde rien du tout sur le serveur.
108 A chaque génération de graphique tout est écrasé par les nouvelles données. Si
109 vous voulez conserver les données et le graphique il est essentiel de les
110 copier/coller.
111
112 Il est possible de modifier la destination des fichiers et leur donner des noms
113 uniques afin de les conserver en éditant le script `cgi/cgi-bin/gelinive.cgi`.
114 Chaque projet le fera en fonction de son besoin.
115
116 ## Les fichiers
117
118 * gelinivetest : le script depuis lequel le script final est généré. Il calculera R, e,
119 éventuellement les sauvera puis génèrera l'image
120 * geliniveplot : le script gnuplot qui génère l'image
121 * mail : le mail initiant la demande
122 * makefile : le makefile pour générer le manuel, lancer les tests et
123 installer le script/le man
124 * gelinive.? : les pages du manuel
125 * tests/test : le script lançant les tests
126 * tests/[lieu] : les jeux de données de tests
127 * tests/[lieu]tab : les jeux de données contre lesquels vérifier le bon calcul de d, de R et de H
128 * tests/[lieu]temp : les jeux de données contenant les températures
129 * tests/[lieu].png : les images contre lesquelles vérifier la bonne génération de l'image
130 * cgi/* : la page html et le cgi nécessaires pour faire tourner gelinive en service web
131 * README.md : ce fichier
132
133 ## Exemple de sortie
134
135 