Service de la consommation et des affaires vtrinaires Section distribution de leau Chemin des Boveresses 155 CH 1066 Epalinges

Document cr par : Ch. Schwaar (8 janvier 2010) Ligne directe : 021 316 43 18 E-mail : christophe.schwaar@vd.ch

ArcGIS to Epanet
Afin deffectuer de la simulation hydraulique partir de donnes SIG au sein dEpanet, un gotraitement sous forme de script Python a t ralis dans le cadre du projet SIRE (Systme dinformation des rseaux deau, projet commun ltat de Vaud et ltablissement cantonal dassurance : www.vd.ch/sire). Le script permet de gnrer un fichier inp (fichier texte) pouvant tre trait par Epanet pour les conduites composant le rseau uniquement (les autres ouvrages devront tre ajouts manuellement par la suite). Un pr requis lutilisation de ce gotraitement est de disposer dun rseau topologiquement propre de qualit irrprochable, il est donc ncessaire de contrler en la topologie du rseau avant de lancer le gotraitement. En effet, Epanet ne tolre pas derreur topologique pour effectuer de la simulation hydraulique. Par topologie propre il est entendu les points suivants : Interruption des conduites au droit de chaque intersection (pas de connexion sur un sommet de vertice de polyligne) Pas de superposition dobjets conduites Pas dobjets conduites multiparties ou de longueur nulle Vrification de la connectivit des conduites les unes aux autres Ce document rsume la procdure de gnration dun fichier inp pour Epanet partir dune feature class de polyligne (conduite) dfinie dans une godatabase dans lenvironnement ArcGIS dESRI. Il traite aussi du processus dinstallation des outils.

1. Licences ncessaires
Le gotraitement dvelopp fonctionne sur les versions 9.3 et 9.3.1 dArcGIS avec une licence Arcview et non sur les versions antrieures sans modification de celui-ci. En fait deux scripts trs similaires ont t dvelopps, la diffrence rside uniquement dans la manire dattribuer les altitudes aux nuds.

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

1. ArcGIS2Epanet_MNT : Ce script attribue les altitudes aux nuds sur base dun Modle Numrique de Terrain (raster, grid). Ce traitement ncessite, la possession dune licence pour lextension Spatial Analyst en plus dune licence Arcview standard. 2. ArcGIS2Epanet_NIV : Ce script attribue les altitudes aux nuds sur base dune couche de courbe de niveau (shape ligne) par jointure spatiale. Aucune licence complmentaire nest ncessaire une simple licence Arcview standard suffit. Une licence Arcview est donc ncessaire pour utiliser le script ArcGIS2Epanet_NIV tandis que lextension Spatial Analyst est ncessaire pour ArcGIS2Epanet_MNT. Les deux scripts mnent au mme rsultat final seule la faon dattribuer les altitudes change ainsi que le type de donne daltitude en entre (raster ou donnes vecteurs linaire).

2. Objectif
Lobjectif est de crer un fichier ASCII avec le suffixe inp selon la structure Epanet pour les conduites. Les autres ouvrages devront tre ajouts manuellement dans Epanet. La structure du fichier produire pour Epanet est la suivante :
[TITLE] [JUNCTIONS] ;ID Elevation 1 0 2 0 . 418 0 [PIPEs] ;ID Node1 0 1 1 3 2 5 . 442 412 BaseDemand DemandPattern ; ; ; LossCoefficient ; ; ; ; InitialStatus ;Description ;Description

Node2 Length Diamter Roughness 2 82.543571112 200 0 4 72.4318000756 125 0 6 30.4882375621 100 0 408 787.113622073 200 0

[COORDINATES] ;Node X-Coord 1 554342.79 . 418 554494.55 [VERTICES] ;Link 0 1 1 1 1 1 1 2 2 2 2 . 442 442 442 442 442 442 [END] X_Coord 554313.71 554330.48 554313.02 554304.13 554293.64 554293.17 554293.09 554292.75 554296.18 554297.72 554301.84 554967.98 554975 554975.08 555000 555014.53 555055.59

Y_Coord 173723.31 173576.82 Y_Coord 173681.53 173291.03 173266.99 173254.97 173241.65 173240.28 173240.04 173562.88 173567.96 173570.54 173575.75 173738.24 173750 173750.15 173800 173836.82 173909.37

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

3. Procdure de Gnration du fichier inp

3.1.Donnes de dpart :
Couches en entre : 1) Feature class polyligne conduites (au sein dune godatabase) 2) MNT raster (grid) OU couche de courbe de niveau (shape) : Pour le canton de Vaud ces
donnes peuvent tre commandes via le portail de lASIT-VD : http://www.asit.vd.ch

Paramtres :

Un attribut contenant la valeur du diamtre des conduites au sein du SIG Un attribut contenant la valeur de la longueur des conduites au sein du SIG Un attribut contenant la valeur de la rugosit associe aux conduites selon le matriau au sein du SIG Un attribut de la couche de rfrence pour les altitudes (MNT, courbe de niveau contenant la valeur de laltitude

Afin de complter le fichier texte pour Epanet, le script reprend les valeurs contenues dans les attributs des objets. Le script remplace les valeurs nulles contenues dans certains champs avec des valeurs par dfaut, le script force les valeurs (100mm pour le diamtre et 0 pour la rugosit => dfinir dans Epanet aprs afin deffectuer la simulation : editer groupe puis remplacer les valeurs 0). Attention aucune longueur nulle nest tolre ! Les valeurs par dfaut peuvent tre modifie dans le script.
Remarque : Lorsque que lapplication est lance (Toolbox contenant le script) une interface apparat permettant de dfinir / choisir quelles sont les couches dentre ainsi que les attributs contenant les valeurs de diamtre, rugosit, longueur et altitude (altitude uniquement pour le script utilisant une couche de courbe de niveau). C.f Ch.5 utilisation du gotraitement pour plus dinfos sur lutilisation de loutil.

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

3.2.Description du processus de gotraitement :

Feature class Polylignes (conduites)

Ajout des champs FROM_PT et TO_PT

INPUT

Output

Calcul des champs (coordonnes) FROM_PT et TO_PT

Extraction valeurs de FROM_PT et TO_PT sous forme de liste

Cration de la Feature class point Noeuds

Ajout des Champs NUD_I et NUD_J

Attribution des altitudes aux Noeuds

Jointure entre la couche des Nuds et des Conduites

(ExtractValuesToPoints)

Extension Spatial Analyst

Jointure Saptiale Courbes et Noeuds

Attribution des IDs de Nuds de dpart et darrive aux conduites (stqckage de des IDs des Nuds dans champs NUD _I et NUD_J)

MNT Raster
ArcGIS2Epanet_MNT

Courbes de niveau
ArcGIS2Epanet_NIV

Gnration du fichier inp EPANET

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

Description du processus: Comme donnes en entre une feature class polyligne conduite (contenue dans une godatabase personnelle) est ncessaire ainsi quune couche de base pour les altitudes : soit un MNT soit une couche de courbe de niveau, cela dpend du script utilis et de la disponibilit ou non de lextension Spatial Analyst. La feature class conduite doit contenir 3 attributs contenant les valeurs de : diamtre, longueur et rugosit des conduites. Comme mentionn plus haut, si ces attributs contiennent des valeurs nulle le script force les valeurs (uniquement pour les diamtres et rugosits) : 100 mm pour les diamtres ; 0 pour les rugosits (les valeur de rugosit sont alors complte en masse dans epanet aprs: slctioner tout puis fonction diter groupe). Les champs textes (attributs) FROM_PT et TO_PT sont ajouts aux conduites. Les valeurs des champs FROM_PT et TO_PT sont calcules, ils contiennent alors les coordonnes des points de dpart et de fin des conduites. Les valeurs des coordonnes de dpart et de fin des conduites sont alors extraites des champs nouvellement crs (FROM_PT et TO_PT) afin den gnrer une liste. Cette liste est ensuite ordonne et les doublons sont supprims : en effet le point darrive dune conduite peut tre aussi le point de dpart dune autre lors de connexion. Sur base de la liste des coordonnes de point de dpart et de fin des conduites sans doublon la feature class point des nuds est cre. Chaque nuds possde alors un identifiant unique. Les champs numriques NUD_I et NUD_J sont ajouts la feature class conduite, ces champs stockeront lidentifiant du nud sis au point de dpart (NUD_I) et au point de fin de la conduite (NUD_J). Deux jointures sur la base des coordonnes des noeuds et des points dbut et fin des conduites entre les feature class Conduite et Nuds sont ralises. Cela afin dattribuer lidentifiant du nuds de dpart la conduite dans le champ NOEUD_I et de fin dans le champ NUD_J. La premire jointure porte sur le champs FROM_PT de la feature class conduite et le champs contenant la coordonne du nuds de la feature class Nuds ; la deuxime porte sur le champs TO _PT de la feature class conduite et le champs contenant la coordonne du noeuds de la feature class Nuds. Les altitudes sont attribues aux nuds selon deux mthodes diffrentes suivant le script utilis. Lattribution des altitudes sur la base dun MNT ncessite de possder lextension Spatial Analyst, dans ce cas la valeur de laltitude du pixel sis sous le nud est attribue celui-ci laide de la fonction ExtractValuesToPoints. Lattribution des altitudes peut se faire sans extension particulire partir dune couche de courbe de niveau, dans ce cas une jointure spatiale entre les nuds et la courbe de niveau la plus proche est ralise puis laltitude de la courbe jointe attribue aux nuds.
Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

A ce stade les feature classes conduite et nuds contiennent lensemble des lments ncessaires la cration du fichier texte pour Epanet. La suite et la fin du gotraitement consiste donc produire/crire le fichier ASCII selon la structure Epanet.

4. Installation
Les scripts et les toolbox (fichier .tbx) sont disponibles en tlchargement sur le site www.vd.ch/sire. Le prsent chapitre traite de linstallation de ces outils dans ArcGIS depuis ArcMap ou ArcCatalog. Il est possible dinstaller directement la toolbox ou alors dinstaller /crer une toolbox partir des script directement. Les deux possibilits sont dcrites ci-dessous :

4.1.Installation dune Toolbox

Les fichiers de toolbox porte lextension .tbx Etapes de linstalation dans ArcCatalog : 1. Ouvrir ArcToolbox

2. Clic droit en haut de larborescence des toolboxes puis slectionner Ajouter une boite outils . Parcourir ensuite les rpertoires afin de slectionner la boite outil installer (endroit de sauvegarde du fichier .tbx)

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

4.2.Installation partir des scripts (rsultat identique linstallation de la toolbox 4.1)

Linstallation partir des scripts permet de mieux apprhender les paramtres du gotraitment, La lecture de ce chapitre facilite la comprhension du fonctionnement du script. Etapes de linstalation dans ArcCatalog : 1. Ouvrir les ArcToolbox 2. Crer une nouvelle bote outil par clic droit en haut de larborescence des toolboxes

3. Clic droit sur la nouvelle bote outil puis slectionner ajouter script

4. Dfinir les paramtres du script ainsi que leurs proprits : le type de ceux-ci sans oublier de dfinir si ce sont des input ou output. Attention : lordre est trs important et doit correspondre lordonnancement des paramtres dfini dans le script (correspond lordre de lecture dans le script). Pour les paramtres de type champs (=attributs) il est ncessaire de dfinir partir de quelle couche ils sont obtenus. Les captures dcran expliquent, avec des exemples de paramtres, cette tape.

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

A) ArcGIS2Epanet_NIV

Champ altitude obtenu partir de la couche courbe_niveau

Fichier Epanet = fichier de sortie => Output

A) ArcGIS2Epanet_MNT

Champ Longueur obtenu partir de la couche conduite

MNT raster est une couche en Input

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

5. Utilisation du gotraitement
Principes dutilisation des script : marche suivre gnrale
1. Slectionner dans le SIG (Arcmap) les conduites que lon veut exporter vers Epanet 2. Exporter les entits conduites slectionnes dans une godatabase

3. Fermer ArcMap et ouvrir ArcCatalog. Le gotraitement ne fonctionne pas depuis ArcMap avec les donnes affiches ! 4. Dans ArcCatalog : Double clic sur le script contenu dans la toolbox de loutil dexport vers Epanet install : une interface apparat permettant de dfinir / choisir quelles sont les couches dentre ainsi que les attributs contenant les valeurs de diamtre, rugosit, longueur et altitude (altitude uniquement pour le script utilisant une couche de courbe de niveau : Arcgis2Epanet_NIV). Il est important de dfinir lendroit ou sera dpos le fichier Epanet et de mettre lextension .inp au nom choisi !

Extension .inp ajouter au nom choisi. Ex : commune.inp

Extension .inp ajouter au nom choisi. Ex : commune.inp

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch

Service de la consommation et des affaires vtrinaires Section distribution de leau

10

5. Lancer le traitement. Le fichier .inp est cr lendroit choisi et il sera utilisable dans Epanet. => Fichier Epanet contenant toutes les conduites cr.

Dpartement de la scurit et de lenvironnement SCAV www.vd.ch/scav Tl. : +41 21 316 43 43 Fax : +41 21 316 43 00 info.labocant@vd.ch