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

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

;Description

787.113622073

[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

DemandPattern
;
;

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

200

LossCoefficient
;
;
;

InitialStatus

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

[END]

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

;Description

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)

INPUT

Output

Ajout des champs

FROM_PT et
TO_PT

Calcul des champs

(coordonnes)
FROM_PT et
TO_PT

Extraction valeurs
de FROM_PT et
TO_PT sous forme
de liste

Ajout des Champs

NUD_I et
NUD_J

Jointure entre la
couche des Nuds
et des Conduites

Attribution des IDs de

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

Cration de la
Feature class
point Noeuds

Attribution des
altitudes aux
Noeuds

Extension Spatial
Analyst

(ExtractValuesToPoints)

Jointure Saptiale
Courbes et Noeuds

MNT Raster

Courbes de niveau

ArcGIS2Epanet_MNT

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

ArcGIS2Epanet_NIV

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

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

MNT raster est une

couche en Input

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

10

Section distribution de leau

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