HyD2002 - Objectifs - Interface graphique - Les objets du modèle - Fichiers d'entrée-sorties - Tutoriel

Cette partie détaille les différents types de fichiers utilisés. On distingue des :

• fichiers texte : ils peuvent être confectionnés ou exploités sous des traitements de texte ou des tableurs, leur structure est généralement très simple ;

• fichiers objet : ils servent à la sauvegarde et au chargement rapide d'objets spécifiques : totalité d'un aménagement, ensemble des caractéristiques de simulation... Leur structure est propre au langage objet Java.

Remarque Les noms de fichiers peuvent comporter plus de huit caractères avec une extension n'excédant pas trois caractères. Tous les caractères peuvent être utilisés, à l'exception des espaces et des caractères suivants : * ? , ; [ ] + - = \ / : | < >. Le point est employé exclusivement pour séparer le nom du fichier de l'extension.

L'emploi des extensions de noms de fichiers permet de distinguer les divers types de fichiers.

Définition d'hydro-aménagement

Un fichier de ce type donne une description en clair d'un hydro-aménagement. Ces fichiers permettent de sauver ou charger des aménagements définis ou modifiés sous un traitement de texte.

nom conventionnel

L'extension adoptée est .txt.

exemple : Amenagements_A2.txt

structure des fichiers

Les caractéristiques sont séparées par des tabulations ou des retours à la ligne. L'espace n'est pas considéré comme un séparateur. Les dièses # servent à marquer le début de définition d'un composant.

exemple

On distingue le stockage des coordonnées des stations hydro-météorologiques et les fichiers correspondants aux chroniques de données sur ces stations. La localisation des stations est nécessaire pour la gestion des lacunes : si pour un pas de temps, la donnée d'une station est indisponible, il est alors fait référence à la première valeur valide de la station la plus proche.

nom conventionnel

La construction du nom est la suivante :

• coordonnées stations : <Répertoire>\<type>.txy
• chroniques données : <Répertoire>\<type>.t<pas de temps>
  où mo:mois ; 10:décade ; da:jour

Le type est soit :

• ecoulement pour les données d'apports naturels exprimées en hm3.
• lame ecoulee pour les données de pluviométrie exprimées en m.

exemples :

• C:\ActiveHyd\exemples\data-62-90\hm3\ecoulement.txy coordonnées des stations d'écoulement
• C:\ActiveHyd\exemples\data-62-90\m\lame ecoulee.tmo chroniques de pluies mensuelles

structure des fichiers

Fichier localisation

Le fichier comporte une ligne par station. Chaque ligne est constituée par le label, l'abscisse, l'ordonnée d'une station. Les stations sont rangées suivant l'ordre d'entrée des fichiers chroniques.

exemple

DUCLOS    18.855    31.852
TRAVERSE    19.026    30.861
PRISDEAU    19.390    32.164
DAVID130    17.153    30.772
BSABLE    17.635    34.357
LEZARDE    20.011    29.280

Fichier chronique

Le fichier comporte :

• une ligne d'en-tête obligatoire avec les labels des stations ;
• une ligne facultative qui précise les unités ;
• une ligne par pas de temps avec la valeur de la date puis une valeur réelle par station.

exemple

date    DUCLOS    TRAVERSE    PRISDEAU    DAVID130    BSABLE    LEZARDE
    hm3    hm3    hm3    hm3    hm3    hm3
1962-01    14.581    6.040    20.830    13.997    3.155    3.592
1962-02    6.167    2.555    8.811    5.920    1.188    1.776
1962-03    3.203    1.328    4.575    3.075    0.595    1.104
1962-04    8.530    3.533    12.185    8.188    2.387    2.501
1962-05    8.089    3.351    11.555    7.765    2.017    2.424
1962-06    13.859    5.741    19.800    13.305    2.893    3.217
1962-07    14.581    6.040    20.830    13.997    3.594    3.466
1962-08    11.814    4.893    16.877    11.340    3.410    3.233
1962-09    11.130    4.611    15.902    10.687    3.245    3.116
1962-10    7.277    3.016    10.392    6.985    1.894    2.103
1962-11    5.625    2.330    8.035    5.399    1.379    1.804
1962-12    4.060    1.682    5.801    3.897    0.932    1.382
1963-01    4.034    1.671    5.761    3.870    0.967    1.441
1963-02    4.974    2.061    7.108    4.776    1.137    1.577
1963-03    4.462    1.848    6.375    4.283    0.940    1.347
1963-04    8.035    3.328    11.480    7.714    1.957    2.343
1963-05    10.813    4.481    15.446    10.381    2.475    2.820
1963-06    10.132    4.199    14.476    9.728    2.167    2.558
1963-07    9.174    3.801    13.103    8.804    2.499    2.362
1963-08    9.096    3.769    12.996    8.732    2.285    2.386
1963-09    7.965    3.300    11.376    7.644    1.718    2.473
1963-10    5.842    2.421    8.346    5.609    2.103    2.360
1963-11    6.804    2.820    9.720    6.532    1.962    2.716
1963-12    6.037    2.502    8.624    5.796    1.245    1.768

Données graphiques .xmd

Ces fichiers ont été développés pour l'outil ActiveMap qui permet de :

• visualiser et analyser des données dans l'espace et dans le temps, sous forme de cartes / plans / animations ;
• transmettre des synthèses dynamiques de ces informations à des collaborateurs, des clients / fournisseurs, au grand public.

Cet outil est intégré dans la présente version d'HyDrAm pour la visualisation des systèmes d'eau ou peut être utilisé de manière indépendante pour présenter des synthèses de résultats.

nom conventionnel

L'extension adoptée est .xmd.

exemple : Guadeloupe.xmd

structure des fichiers

Les fichiers utilisent le formalisme XML (eXtensible Meta Language) basé sur la création de balises pour définir des structures d'information de manière générique.

Ainsi la balise <map> définit un Document ActiveMap . Cette structure est composée d’objets Couche repérés par la balise <series>. Un document peut contenir une ou plusieurs couches.

Chaque couche correspond à une agrégation d’objets permettant une représentation en 2 dimensions et possédant des informations associées. Ces objets, que nous dénommons Série, repérés par la balise <serie>, sont donc décrits par une série de valeurs x et de valeurs y et les types de valeurs correspondants et par une liste d’informations associées.

Les informations, de type générique Info, sont :

• soit de type simple : Entier, Réel, Texte (dans le sens de chaîne de caractères), URI (Unified Resource Information : adresse de ressource universelle), etc, - balise <spi> -
• soit de type temporel : Variation annuelle - balise <yvi> - ; Chronique - balise <chi> -.

Figure E4.1. Structure de l’information

Le typage de l'information est décrit, à l'intérieur des balises <info>, par des objets Type Simple, repérés par les balises <type>. En pratique, toute information simple fait référence à un objet Type Simple qui définit un label, un format d’affichage sous forme de chaîne de caractères, une unité, une valeur minimale, une valeur maximale, une précision. Les dernières propriétés n’ont de sens que pour des informations numériques. Ces propriétés permettent de restreindre l’ensemble des valeurs légales d’un type de base, elles renseignent sur la plage de validité de l’information.

Il existe d’autres types d’Info Simple que les classes représentées sur le diagramme E4.1. : Booléen, Année, Mois, Décade, Jour. Ces derniers objets définissent des périodes de temps. Ils sont utilisés par les Info Temporelles (Chroniques, variations annuelles) : toute valeur d’une information temporelle fait référence explicitement ou implicitement à une période de temps.

La structure repérée par la balise <classes> regroupent les objets classifications correspondant à différentes légendes, donc autant de vues possibles du document. Une classification définit des classes qui permettent une partition de l'information à des fins d’analyse.

exemple

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<am:ami xmlns:am="http://2ie-technologies.com/active/2001/02/mapXsd" lang="FR" version="0.5">

<map fill="color:lightblue">
<label>Guadeloupe</label>
<desc>Fond de carte de la Guadeloupe</desc>
<series id="physiq" range="0" xRef="guad_lon" yRef="guad_lat" classification="regions;altiC;plmoy_m_y" type="PLOT">
<label>Physique</label>
<desc>L'archipel Guadeloupe</desc>
<serie id="fajou">
<xValues>25.86 25.64 26.47 26.73 27.14 27.34 27.53 27.37 25.86 25.86</xValues>
<yValues>47.78 48.10 49.27 48.85 48.89 48.76 48.39 48.09 47.78 47.78</yValues>
<label>ilet à Fajou</label>
<spi iRef="region_st">Guadeloupe</spi>
<spi iRef="alti_rl">5</spi>
<spi iRef="www_uri">http://www.guadeloupe-fr.com</spi>
</serie>
<serie id="pt">
<xValues>77.22 75.76 75.52 75.83 76.08 77.58 77.95 77.22 77.22</xValues>
<yValues>28.43 28.63 29.00 29.24 29.08 29.00 28.76 28.43 28.43</yValues>
<label>Petite Terre</label>
<spi iRef="region_st">Guadeloupe</spi>
<spi iRef="alti_rl">5</spi>
<spi iRef="www_uri">http://www.guadeloupe-fr.com</spi>
</serie>
...
</series>
<series id="riv" range="1" xRef="guad_lon" yRef="guad_lat" classification="riv" type="PLOT" visible="false">
<label>Cours d'eau</label>
<desc>Principales rivières</desc>
<serie id="laram">
<xValues>8.574 9.229 9.713 10.099 10.364 10.853 11.511 12.175 12.672 13.028 13.426</xValues>
<yValues>41.642 42.260 43.113 44.939 45.288 45.452 45.329 45.435 45.854 46.711 47.209</yValues>
<label>La Ramée</label>
<spi iRef="riv_st">La Ramée</spi>
<spi iRef="region_st">Basse-Terre</spi>
</serie>
...
</series>
<series id="stations" range="2" xRef="guad_lon" yRef="guad_lat" classification="stationType;flow_hm3_mo;etp_mm_m_yv;anDeb;alti;bv" type="PLOT" visible="false">
<label>stations</label>
<desc>stations hydro-météorologiques</desc>
<serie id="Duclos"><xValues>18.855</xValues><yValues>31.852</yValues><label>Duclos</label><spi iRef="type_st">hydro</spi><spi iRef="desc_st">Bras David</spi><spi iRef="alti_rl">110</spi><spi iRef="deb_yr">1973</spi><spi iRef="fin_yr">1987</spi><spi iRef="ans_it">8</spi><spi iRef="zone_st">Basse-Terre</spi><spi iRef="bv_rl">37.5</spi>
</serie>
...
</series>
<series id="sites" range="3" xRef="guad_lon" yRef="guad_lat" classification="siteType;pop;devTourism;dom" type="PLOT" visible="false">
<label>Villes, industries...</label>
<desc>Lieux d'activités</desc>
<serie id="Saint-Louis"><xValues>57.12</xValues><yValues>4.31</yValues><label>Saint-Louis</label><spi iRef="type_st">commune</spi><spi iRef="region_st">Marie-Galante</spi><spi iRef="pop_rl">2500</spi><spi iRef="tourism_st">1</spi><spi iRef="dom_rl">750</spi></serie>
<serie id="Capesterre"><xValues>65.38</xValues><yValues>-1.95</yValues><label>Capesterre</label><spi iRef="type_st">commune</spi><spi iRef="region_st">Marie Galante</spi><spi iRef="pop_rl">5000</spi><spi iRef="tourism_st">2</spi><spi iRef="dom_rl">1500</spi></serie>
...
</series>
<series id="irri" range="4" xRef="guad_lon" yRef="guad_lat" classification="irri2000_ha;irri2010_ha" type="POLYGON" visible="false">
<label>Irrigation</label>
<desc>Périmètres irriguées 2000</desc>
<serie id="P0"><xValues>54 58 58 54</xValues><yValues>44.75 44.75 42 42</yValues>
<label>P0</label><spi iRef="region_st">Est Grande-Terre</spi>
<spi iRef="irri2000_ha">70</spi><spi iRef="irri2010_ha">70</spi>
<spi iRef="mar_ha">35</spi><spi iRef="fou_ha">25</spi><spi iRef="can_ha">10</spi>
</serie>
...
</series>
</map>

<info>
<type id="guad_lon" label="longitude" base="longitude" minValue="0.0" maxValue="90.0" precision="0.01" unit="km;m;dms;deg." reference="Projection;lon:-61.83333;lat:15.91667" format="0.00"/>
<type id="guad_lat" label="latitude" base="latitude" minValue="-10.0" maxValue="70.0" precision="0.01" unit="km;m;dms;deg." reference="Projection;lon:-61.83333;lat:15.91667" format="0.00"/>
<type id="type_st" label="type" base="string"/>
<type id="sstype_st" label="sous-type" base="string"/>
<type id="desc_st" label="description" base="string"/>
<type id="alti_rl" label="altitude" base="real" minValue="0.0" maxValue="1500.0" precision="0.1" unit="m" format="0.#"/>
<type id="pop_rl" label="population" base="real" minValue="0.0" maxValue="500000.0" precision="10" unit="hab" format="0"/>
<type id="tourism_st" label="développement touristique (1-3)" base="string"/>
...
</info>

<classes>
<classification id="regions" iRef="label" font="size:12;family:Dialog;type:bold;color:brown">
<label>Région</label>
<class id="regions1" content="Basse-Terre" fill="color:170,235,170" >Basse-Terre</class>
<class id="regions2" content="Grande-Terre" fill="color:palegreen">Grande-Terre</class>
<class id="regions3" content="La Désirade;Les Saintes;Petite Terre;Marie-Galante;Terre de Haut;Terre de Bas;ilet à Fajou;Grand Ilet" fill="color:220,254,220">îles proches</class>
</classification>
<classification id="altiC" iRef="alti_rl">
<label>Courbes de niveau</label>
<class id="altic_1" minValue="0" maxValue="300"
stroke="width:1;color:black" fill="color:limegreen">inférieure à 300m NGG</class>
<class id="altic_2" minValue="300" maxValue="600"
stroke="width:1;color:black" fill="color:darkgreen">entre 300m et 600m NGG</class>
<class id="altic_3" minValue="600" maxValue="900"
stroke="width:1;color:black" fill="color:sandybrown">entre 600m et 900m NGG</class>
<class id="altic_4" minValue="900" maxValue="1200"
stroke="width:1;color:black" fill="color:brown">entre 900m et 1200m NGG</class>
<class id="altic_5" minValue="1200" maxValue="1500"
stroke="width:1;color:black" fill="color:saddlebrown">supérieure à 1200m NGG</class>
</classification>
<classification id="siteType" iRef="type_st">
<label>Sites</label>
<class id="siteType1" content="commune"
marker="shape:rc;image:ville.gif" font="size:10;family:Dialog;color:131,131,131;x-position:left;y-position:top">Ville</class>
<class id="siteType2" content="Industries-Commerces"
marker="shape:rc;image:industri.gif" font="size:10;family:Dialog;color:black;x-position:left;y-position:top">Industries-Commerces</class>
</classification>
...
</classes>

</am:ami>

Sortie Out.log

Ce fichier stocke le texte correspondant à la sortie standard du modèle. Il conserve une trace des actions réalisées.

nom conventionnel

Le nom consacré est Out.log. Le fichier est créé dans le sous-répertoire /temp du répertoire d'installation du modèle.

exemple : C:\ActiveHyd\temp\Out.log

structure des fichiers

Chaque nouvelle exécution est repérée par sa date suivie de la séquence des actions conservées.

exemple

====== Tue Sep 25 12:35:06 CEST 2001 ======
ActiveHyd - initSystem() - url: file:C:/ActiveHyd/guadelou/Amenagements_A2.hyd
Xe1ProjectionBox.addProjections()
Ressource property tool.item5 not found in com.iie.active.map.resources.map.properties
Canvas.clearMemory(), free memory : 2537656
Canvas.clearMemory(), total memory : 5455872
Loading MapDocument
MapDocument loaded
"C:\ActiveHyd\lib\ActiveHyd.jar"

====== Tue Sep 25 12:55:04 CEST 2001 ======
ActiveHyd - initSystem() - url: file:C:/ActiveHyd/guadelou/Amenagements_A2.hyd
Xe1ProjectionBox.addProjections()
Ressource property tool.item5 not found in com.iie.active.map.resources.map.properties
Canvas.clearMemory(), free memory : 2556592
Canvas.clearMemory(), total memory : 5505024
Loading MapDocument
MapDocument loaded
run() WaterSystem:Amenagements_A2

Erreurs Error.log

Ce fichier stocke le texte correspondant à des erreurs d'exécution du modèle. Il conserve une trace des événements anormaux et constitue donc une aide précieuse pour repérer une source d'erreur.

nom conventionnel

Le nom consacré est Error.log. Le fichier est créé dans le sous-répertoire /temp du répertoire d'installation du modèle.

exemple : C:\ActiveHyd\temp\Error.log

structure des fichiers

Chaque nouvelle exécution est repérée par sa date suivie de la séquence des événements anormaux éventuellement survenus.

exemple

====== Wed Sep 26 17:00:54 CEST 2001 ======
Labels - setLocale - _locale.getLanguage():fr
-1- LOCALE.getLanguage():fr
-2- LOCALE.getLanguage():fr
ActiveMap.getCustomCursor(String), Cursor loading error for Loading default cursor...
Xs1LayersBox, static
java.lang.NullPointerException
at javax.swing.ImageIcon.(Unknown Source)
at com.iie.active.map.Xs1LayersBox.(Xs1LayersBox.java:199)
at com.iie.active.map.Xp1TabbedBar.createLayersBoxInstance(Xp1TabbedBar.java:129)
at com.iie.active.map.Xs1TabbedBar.addLayersBox(Xs1TabbedBar.java:162)
at com.iie.active.map.Xs5TabbedBar.addLayersBox(Xs5TabbedBar.java:147)
at com.iie.active.map.Xs1TabbedBar.addControlPanel(Xs1TabbedBar.java:319)
at com.iie.active.map.Xs1TabbedBar.(Xs1TabbedBar.java:35)
at com.iie.active.map.Xs4TabbedBar.(Xs4TabbedBar.java:36)
at com.iie.active.map.Xs5TabbedBar.(Xs5TabbedBar.java:96)
at com.iie.active.map.Xp1TabbedBar.(Xp1TabbedBar.java:20)
at com.iie.active.map.Xe1TabbedBar.(Xe1TabbedBar.java:37)
at com.iie.active.map.Xe1ActiveMap.createTabbedBarInstance(Xe1ActiveMap.java:114)
at com.iie.active.map.ActiveMap.addTabbedBar(ActiveMap.java:1347)
at com.iie.active.map.ActiveMap.setComponents(ActiveMap.java:743)
at com.iie.active.map.ActiveMap.setDocument(ActiveMap.java:708)
at com.iie.active.map.ActiveMap.(ActiveMap.java:496)
at com.iie.active.map.Xs1ActiveMap.(Xs1ActiveMap.java:25)
at com.iie.active.hydGui.ActiveHyd.definitionToView(ActiveHyd.java:275)
at com.iie.active.hydGui.ActiveHyd.setViewMode(ActiveHyd.java:185)
at com.iie.active.hydGui.ActiveHyd.init(ActiveHyd.java:472)
at com.iie.active.hydGui.ActiveHyd.(ActiveHyd.java:435)
at com.iie.active.hydGui.ActiveHyd.main(ActiveHyd.java:638)
Ressource property opacity.item11 not found in com.iie.active.map.resources.param.properties
Ressource property tool_class.item5 not found in com.iie.active.map.resources.param.properties
Ressource property zoom.item6 not found in com.iie.active.map.resources.param.properties
MapSeries.setClassification(MapClassification) : empty classifications for 2ie-technologies
Xs7Canvas.ResizeListener.componentResized(ComponentEvent)
TabbedBar.setReference(), no url for the current document !

Les fichiers Objets

Ces fichiers peuvent être créés, puis gérés, par :

• l'utilisateur, pour sauver et charger des hydro-aménagements ou des simulations ;
• un traitement interne au logiciel : fichiers de demandes et références hydro-météorologiques.

Ces fichiers possèdent une structure et un format particuliers, propre au langage de programmation objet employé (Java).

Hydro-aménagement

Un fichier de ce type stocke un hydro-aménagement. L'ensemble des caractéristiques du système d'eau et de ses composants est sauvé, y compris les chroniques annuelles et les cumuls mensuels des résultats de simulation.

nom conventionnel

L'extension adoptée est .hyd.

exemple : Amenagements_A1.hyd

Simulation

Un fichier de ce type stocke l'ensemble des caractéristiques propres à la simulation d'un hydro-aménagement, y compris les chroniques annuelles et les cumuls mensuels des résultats de la desserte en eau.

nom conventionnel

La construction du nom est la suivante : <nom de l'hydro-aménagement>.s<numéro de simulation>

exemple : Amenagements_B2.s2

Chroniques de résultats

Un fichier de ce type stocke les chroniques de résultats de simulation pour des pas de temps inférieurs à l'année. Ces fichiers sont créés de manière optionnnelle après la simulation.

nom conventionnel

La construction du nom est la suivante : <nom de l'hydro-aménagement>_<numéro de simulation>\<type du composant>\<nom du composant>.s<pas de temps>

exemple : Amenagements_B2_2/Reservoir/Letaye.smo fichier de résultats mensuels du réservoir de Letaye pour la simulation 2 de l'hydro-aménagement Amenagements_B2

Chroniques de demandes

Un fichier de ce type stocke les chroniques de demande en eau d'une zone irriguée. Il s'agit de besoins théoriques calculés par un bilan hydrique de type RU / RFU.

nom conventionnel

La construction du nom est la suivante : <Répertoire de l'écoulement>\<nom du composant>.d<pas de temps>

exemple : C:\ActiveHyd\exemples\data-62-90\hm3\ban_Pcov.d10 ; fichier de demandes décadaires de la zone irriguée ban_Pcov.

Données hydro-météorologiques objet

On distingue le stockage des coordonnées des stations hydro-météorologiques et les fichiers correspondants aux chroniques de données sur ces stations. Ces fichiers sont créés automatiquement à partir des fichiers texte de données hydro-météo et sont reconstitués en cas de modification de ces fichiers.

nom conventionnel

La construction du nom est la suivante :

• coordonnées stations : <Répertoire>\<type>.sxy
• chroniques données : <Répertoire>\<type>.s<pas de temps>

Le type est soit :

• ecoulement pour les données d'apports naturels exprimées en hm3.
• lame ecoulee pour les données de pluviométrie exprimées en m.

exemples :

• C:\ActiveHyd\exemples\data-62-90\hm3\ecoulement.sxy coordonnées des stations d'écoulement
• C:\ActiveHyd\exemples\data-62-90\m\lame ecoulee.smo chroniques de pluies mensuelles