HydroGenerator (v1.

1)
Guide de lutilisateur



Erwann FILLOL






Mars 2011
erwann.fillol@voila.fr















I. Introduction ........................................................................................................................ 3
II. Mthodologie ..................................................................................................................... 4
III. Utilisation du module HydroGenerator (v1.1) ................................................................... 6
III.1 Structure des rpertoires............................................................................................. 6
III.2 Rcuprations des donnes intrants............................................................................ 7
III.3 Paramtrage de lHydroGenerator (v1.1)................................................................... 9
III.4 Excution du programme ......................................................................................... 10
III.5 Fichiers de sortie ...................................................................................................... 11
Indice daccessibilit moyenne leau............................................................................. 12
Anomalie annuelle de laccessibilit leau.................................................................... 12
III.6 Modification et compilation du programme............................................................. 14
IV. Conclusion........................................................................................................................ 15
Contact ..................................................................................................................................... 15











I. Introduction
Leau, avec le pturage, est une ressource indispensable aux leveurs et aux leveurs
nomades. Dans la zone sub-saharienne, les mares et les points deau de surface se remplissent
de manire priodique durant la saison des pluies. Le taux et la dure de remplissage sont
directement lis la quantit et la rpartition des prcipitations.
Le module HydroGenerator est un outil capable de gnrer des cartes annuelles dindice
dcrivant laccessibilit en eau de surface calcul partir des donnes issues des acquisitions
du capteur VEGETATION embarqu sur la srie des satellites SPOT.
Cet outil de suivi de laccessibilit des eaux de surface en temps rel vient complter la
connaissance sur la quantit de pturage accessible fourni par le module BioGenerator 2.
Lextension spatiale de lHydroGenerator (v1.1) concerne lensemble de lAfrique Sub-
saharienne, la zone tant dcoupe en plusieurs fentres et sous-fentres.
Ce document, destination de lutilisateur, explique la mthodologie utilise, la mise en place
et lutilisation du module HydroGenerator (v1.1), ainsi que les diffrentes fentres spatiales
accessibles.
La principale volution de la version v1.1 par rapport la version prcdente v1 est la
possibilit donne lutilisateur de grer la priode dintgration en dfinissant les dcades de
dbut de fin de priode. Ceci est particulirement utile dans le cas de lAfrique de lEst o il
existe deux saisons de pluies annuelles distinctes.






II. Mthodologie
La mthodologie est base sur lutilisation des produits SWB (Small Water Bodies) accessible
sous forme de dcade 1 km de rsolution et informant de manire boolenne de la prsence
deau de surface.
En utilisant cette information ponctuelle de prsence deau, lHydroGenerator dresse des
cartes annuelles donnant une information statistique du temps de remplissage des mares et des
points deau de surface sur un cycle annuel pondre par la distance au point deau.
Le cycle annuel de rfrence est dfini par dfaut suivant le cycle de saison de croissance de
la vgtation de dbut mars fin fvrier de lanne suivante, lutilisateur pouvant par ailleurs
dfinir la priode dintgration de son choix.
La pondration fonction de la distance au point deau est tablie suivant une gaussienne 2D
dfinie par deux paramtres : le rayon daction et la mi-largeur mi-hauteur HWHM.
Typiquement, le rayon daction est la distance maximale quest capable de parcourir un
leveur nomade pour trouver de leau, soit environs Rayon_Max = 30km. La mi-largeur mi-
hauteur est dfinie comme le tiers de cette distance : 10km. La figure 1 montre lallure de
cette fonction de pondration.





Figure 1 Gaussienne de pondration de lindice de prsence deau en fonction de la distance
au point deau


0
0.01
0.02
0.03
0.04
0.05
-40 -30 -20 -10 0 10 20 30 40
Distance au point d'eau [km]
F
a
c
t
e
u
r

d
e

p
o
n
d

r
a
t
i
o
n

n
o
r
m
a
l
i
s

Le calcul, pour chaque pixel, de lindice de laccessibilit en eau se fait par intgration du
temps de remplissage annuel de toute les mares prsente sur le rayon daction et pondr par
la distance ces mares. Lquation 1 donne la formule analytique utilise pour le calcul de
lindice daccessibilit leau de surface.
(1)
o
(i,j) sont les coordonnes du pixel sur limage
(i
s
,j
s
) sont les coordonnes relatives des pixels dans le rayon daction
R
max
est le rayon daction, R
max
[pixel] = Rayon_Max [km] = 30 km
Ind
Remp
(i
s
,j
s
) est lindice de remplissage du point deau au pixel de position relative
(2)

Pond(i
s
,j
s
) est lindice de pondration normalise en fonction de la position relative
(3)

est la mi-largeur mi-hauteur de la gaussienne [pixel] = 10 km
Temps_Remplissage(i
s
,j
s
) est le nombre de dcades pendant lesquelles le pixel de
position relative (i
s
,j
s
) est en eau durant la saison de croissance (dbut mars fin
fvrier)
( )

=
+
=
=
max
max s
2
s
2
max
2
s
2
max s
R
R i
i R
i R j
s s s s Remp AccesEau
) j , Pond(i ) j , (i Ind j i, Ind
36
) j , lissage(i Temps_Remp
) j , (i Ind
s s
s s Remp
=
2
2
j i
s s
2 e ) j , Pond(i
2
2
s
2
s
=

+

III. Utilisation du module HydroGenerator (v1.1)

Lutilisation de lHydroGenerator (v1.1) est trs similaire lutilisation du module
BioGenerator, et sappui sur une structure de rpertoires et de fichiers intrants et sortants.
III.1 Structure des rpertoires
Il est primordial de respecter la structure et la hirarchie des rpertoires et des fichiers. Le
rpertoire Data/In contient les donnes dentre et le rpertoire Data/Out rceptionne les
donnes de sortie. Lexcutable HydroGenerator.exe se trouve la racine de ce rpertoire.











Figure 1 Organisation des rpertoires de travail du module HydroGenerator (v1.1)
Il est noter que le rpertoire Data/In/DMP et Data/In/NDVI ainsi que les rpertoires
Biomasse/ ne sont pas utiliss par lHydroGenerator (v1.1) mais concernent uniquement le
module indpendant BioGenerator 2 v2 de gnration de cartes de biomasse.
III.2 Rcuprations des donnes intrants
Le VITO (Institut flamand de recherche technologique), au travers le projet europen
DevCoCast (GEONETCast for and by Developing Countries), fourni les dcades SWB (Small
Water Bodies) tlchargeables sur le site www.vgt4africa.org.
La premire tape consiste tlcharger lensemble des dcades SWB accessibles sur le site
internet www.vgt4africa.org en choisissant la rgion gographique Africa. La taille de
chacune des dcades au format compress est denvirons 10 Mo.
La seconde tape consiste dcompresser les fichiers tlchargs et les dcouper sur la
fentre intrant Sub-Sahara en utilisant loutil VGT Extract disponible sur le site internet
www.vgt4africa.org. Le paramtrage de loutil VGT Extract concerne les coordonnes
gographiques de la dcoupe, la nomenclature des fichiers de sorties, ainsi que leur format. La
figure 3 montre la fentre principale de loutil VGT Extract et la figure 4 montre comment
configurer convenablement pour dcompresser et dcouper les dcades SWB au format
attendu par le module HydroGenerator.






Figure 3 Fentre principale de loutil VGT Extract
Les paramtres dfinir sont :
La taille de la fentre de sortie (ROI et Manual Input)
La nomenclature des fichiers de sortie (Output Filename)
Le format des fichiers de sortie (Output Format)
La slection des produits extraire (Product Specific)












Figure 4 Fentres des paramtres de loutil VGT Extract
Tableau 1 Nomenclature des fichiers compresses et dcompresses et taille des fichiers
Les fichiers SWB dcompresss doivent tre copis dans les rpertoires Data/In/SWB/.
Les fichiers .img constitue les donnes images au format brut raw et les fichiers .hdr sont les
fichiers header.
La premire dcade 19990101 doit absolument tre prsente, ainsi que la continuit des
donnes jusqu la dernire disponible.
Produit Nomenclature archives compresses
Nomenclature
fichiers
dcompresss
Rpertoire
de
destination
Taille du
fichier
.img
[octets]
SWB VGT4AFRICA_SWB_aaaammjj_Africa.ZIP
SWB_aaaammjj.img
SWB_aaaammjj.hdr
Data/In/SWB/ 28 462 830
III.3 Paramtrage de lHydroGenerator (v1.1)
Les paramtres accessibles par lutilisateur sont :
Les coefficients de la fonction de pondration du buffer spatial : le rayon du buffer en
pixel, et la mi-largeur en pixel mi-hauteur HWHM dfinissant lallure la gaussienne
de pondration. Le rayon du buffer est un entier en unit de pixel, tandis que la mi-
largeur mi-hauteur peut prendre une valeur dcimale.
La priode dintgration sur le cycle annuel dfinie par la premire et la dernire
dcade. Les valeurs rentres correspondent au numro de dcade compris entre 1 et
36, la correspondance avec les dates est donne par le tableau 2. Dans le cas o la
valeur de la dcade de fin dintgration est infrieure celle de dbut dintgration,
lintgration se fait jusqu la dcade de lanne suivante. Par exemple, les valeurs par
dfaut 7 et 6 signifient que lintgration calcule pour lanne a se fait de la dcade
01/03 de lanne a jusqu la dcade 21/02 de lanne a+1. La priode dintgration
doit au moins tre gale deux dcades.
Parametres HydroGenerator
30 10.0 Rayon_Max(pixel) Mi-Largeur_Mi-Hauteur(pixel) (Dfaut : 30 10.0)
7 6 Decade_Debut_Integration Decade_Fin_Integration (Dfaut : 7 6)
Ces paramtres sont accessibles et modifiables via le fichier Lib/HydroGenerator_Param.txt.
Dans le cas dabsence de ce fichier, ce sont les valeurs par dfaut des paramtres qui seront
utilises. Il convient de manipuler ces coefficients avec prcaution, laugmentation de la taille
du rayon de la fentre glissante (Rayon_Max) dcuple le temps de calcul lors de ltape de
buffering.
Tableau 2 Correspondance entre le numro de dcade et la date de dbut de dcade
Numro
Dcade
Date
Numro
Dcade
Date
Numro
Dcade
Date
1 01/01 13 01/05 25 01/09
2 11/01 14 11/05 26 11/09
3 21/01 15 21/05 27 21/09
4 01/02 16 01/06 28 01/10
5 11/02 17 11/06 29 11/10
6 21/02 18 21/06 30 21/10
7 01/03 19 01/07 31 01/11
8 11/03 20 11/07 32 11/11
9 21/03 21 21/07 33 21/11
10 01/04 22 01/08 34 01/12
11 11/04 23 11/08 35 11/12
12 21/04 24 21/08 36 21/12
III.4 Excution du programme
Lexcution du programme se fait simplement en double-cliquant sur le fichier excutable
HydroGenerator.exe. Une fentre dexcution souvre rcapitulant les paramtres utiliss et
lensemble des dcades repres et servant au calcul ainsi que le nombre dannes calculables
partir de cette srie. Un compteur indique la progression du calcul en pourcentage.
Quatre phases de calcul se succdent, la premire phase est le calcul du masque de prsence
deau sur la fentre globale Sub-Sahara, la seconde est le calcul de lanomalie annuelle de
prsence deau, la troisime est le calcul du buffer autour de ces points deau suivant les
coefficients de paramtrage, et la dernire est la dcoupe suivant les fentres et sous-fentres
de sortie et lcriture des fichiers.







Figure 5 Fentre dexcution du module HydroGenerator (v1.1)
Dpendamment du nombre de dcade disponibles, de la vitesse du processeur et celle du
disque dur, et des paramtres utiliss, le temps de calcul est denvirons 2 3 heures. La
configuration minimale requise concerne essentiellement la mmoire vive disponible avec un
minimum de 1 Go, et lespace disque disponible avec un minimum de 1 Go par anne utilise.
Il est noter que tout le rpertoire de travail peut tre dplac vers nimporte quel rpertoire
de destination, ce qui importe tant la disposition relative des rpertoires et des fichiers. Sans
tre indispensable, il est recommand dutiliser un disque dur externe rapide afin de ne pas
monopoliser le disque dur principal de lordinateur.
III.5 Fichiers de sortie
HydroGenerator (v1.1) produit une carte dindice moyen daccessibilit en eau ainsi que les
anomalies annuelles de cet indice sur 3 fentres gographiques diffrentes. Le tableau 3 donne
la dfinition gographique de ces fentres.
Tableau 3 Coordonnes du centre des pixels des coins des fentres et sous fentres
gographiques des champs de sortie de HydroGenerator (v1.1)
Les fichiers de sortie de daccessibilit en eau et des anomalies annuelles sont au format
GEOTIFF (.tif) en projection gographique plate carre Lat/Lon WGS-84 et avec une
rsolution spatiale de 11 km.
Les fichiers de sortie sont organiss dans le rpertoire Out/ suivant une hirarchie
fentre/sous fentre. Par exemple, les fichiers de sortie concernant la sous fentre Somalie
sont prsents dans le rpertoire Out/Est_Afrique/Somalie/AccesEau/.
Fentre Sous Fentre Haut-Gauche Bas-Droit
Taille
(pixels lignes)
Sub_Sahara Sub_Sahara
-18.000E
27.375N
52.000E
-5.02678611N
7841 3630
Ouest_Afrique
-18.000E
27.375N
16.000E
9.000N
3810 2060
Mali_Burkina
-12.500E
25.000N
5.5000E
9.000N
2018 1794
Niger
0.000E
24.000N
16.000E
11.000N
1794 1458
Ouest_Afrique
Senegal_Mauritanie_
Gambie_Guine
-18.000E
27.375N
-4.500E
10.000N
1514 1948
Centre_Afrique
13.000E
24.000N
39.000E
2.000N
2914 2466
Soudan
21.000E
24.000N
39.000E
3.000N
2018 2354 Centre_Afrique
Tchad_
RepCentreAfrique
13.000E
24.000N
28.000E
2.000N
1682 2466
Est_Afrique
28.000E
18.000N
52.000E
-5.000N
2689 2578
Erythree_Ethiopie
32.000E
18.000N
48.000E
3.000N
1794 1682
Ouganda_Kenya
29.000E
5.000N
42.000E
-5.000N
1458 1122
Rwanda_Burundi
28.000E
-1.000N
31.000E
-5.000N
338 450
Est_Afrique
Somalie
40.000E
12.000N
52.000E
-2.000N
1345 1570
Indice daccessibilit moyenne leau
Pour chacune des fentres et sous-fentres, les fichiers AccesEau/EauAccesMoyenne.tif
reprsentent lindice daccessibilit leau calcul en moyenne sur lensemble des annes
disponibles.
Lunit de lindice daccessibilit est lindex de temps de remplissage du point deau pondr
par un facteur de forme gaussienne fonction de la distance au point deau. Une valeur
minimale 0 de lindice correspond une absence totale deau dans un rayon donn par le
paramtre Rayon_Max, tandis quune valeur maximale 1 correspond une prsence
continuelle de leau lintrieur de ce mme rayon.
Pour des raisons de codage numrique, les valeurs sont multiplies par un facteur 10
8
puis
limites un maximum de 65535.






Figure 6 Carte dindice de laccessibilit eau en moyenne calcule sur lensemble des
annes disponibles
Anomalie annuelle de laccessibilit leau
Pour chacune des fentres et sous-fentres, les fichiers Anomalie/EauAnomalieaaaa.tif et
Anomalie/EauAnomalieEntendueaaaa.tif donnent lanomalie de laccessibilit leau pour
lanne aaaa sous deux reprsentations diffrentes.
Lanomalie est le rapport de lindice daccessibilit leau calcule sur lanne aaaa suivant
les paramtres de priode dintgration par rapport la moyenne de cet indice calcule sur la
mme priode de lensemble des annes disponibles. Lanomalie est exprime en pourcent
[%] avec un seuillage maximal 200%. Sur les zones o laccessibilit leau est toujours
nulle (zones dsertiques), la valeur de sortie du fichier danomalie est fixe 250.
Pour lanne en cours, et dont on ne dispose pas ncessairement des dcades sur lensemble
de la priode, le calcul de lanomalie se fait uniquement sur la priode disponible.
Le fichier EauAnomalieEntendueaaaa.tif donne la carte danomalie en intgrant le buffer de
pondration en fonction de la distance, tandis que le fichier EauAnomalieaaaa.tif donne les
mmes valeurs danomalie mais uniquement sur les points deau de surface et en affectant la
valeur 250 l o il ny a pas de points deau de surface.






Figure 7 Carte danomalie de laccessibilit en eau tendue pour lanne 2010
(EauAnomalieEtendue2010.tif ) calcule en juillet 2010 (dernire dcade 20100721)






Figure 8 Carte danomalie de laccessibilit en eau localise pour lanne 2010
(EauAnomalie2010.tif ) calcule en juillet 2010 (dernire dcade 20100721)






Figure 9 Extraits sur le Nord Mali des cartes danomalies de laccessibilit en eau tendue
( gauche) et localise ( droite) pour lanne 2010 calcule en juillet 2010 (dernire dcade
20100721)
III.6 Modification et compilation du programme
Le code source Fortran de lHydroGenerator (v1.1) est accessible dans le fichier
Sources/HydroGenerator.f. Toutes modifications du code source entranent la ncessit de
recompiler le programme en utilisant ces lignes de commande :
> g77\g77setup.bat
> g77 O Sources\HydroGenerator.f o HydroGenerator.exe

IV. Conclusion
HydroGenerator (v1.1) est un outil bas sur la tldtection satellitaire de prsence de points
deau de surface ponctuels et capable de gnrer, en temps rel, des cartes dindice de
laccessibilit en eau de surface et danomalies annuelles de cet indice.
En fournissant un indice de la situation et les taux de remplissage des mares et des points de
surface, lHydroGenerator complte linformation donn par le module BioGenerator 2 sur la
quantit de biomasse accessible aux leveurs.
Lapplication de lHydroGenerator est double : dune part il permet de gnrer une carte sur
toute la rgion sub-saharienne de laccessibilit moyenne aux point deau de surface pouvant
aider la planification de limplmentation de nouveaux puits, et dautre part, en dressant des
cartes danomalies annuelles de remplissage des mares, il permet dobtenir une vision globale
et en temps rel de la situation saisonnire.
Contact
Pour toute demande dinformation supplmentaire, ou bien pour rapporter des anomalies de
fonctionnement du module HydroGenerator (v1.1), veuillez vous adresser directement au
concepteur du programme.
Concepteur : Dr Erwann FILLOL
Email : erwann.fillol@voila.fr