Simulation Maree v6p2

EDF R&D
LABORATOIRE NATIONAL D'HYDRAULIQUE ET ENVIRONNEMENT

SIMULATION MULTIDIMENSIONNELLE ET MODELISATION PHYSIQUE EN HYDRAULIQUE FLUVIALE ET MARITIME
6 quai Watier - 78401 CHATOU CEDEX, +33 (1) 30 87 79 46
7 fvrier 2013
Page de garde
Mthodologie pour la simulation de la mare avec la version 6.2 de TELEMAC-

2D et TELEMAC-3D
Chi-tun PHAM
Sbastien BOURBAN HR Wallingford
Nomie DURAND HR Wallingford
Michael TURNBULL HR Wallingford
H-P74-2012-02534-FR 1.0
De nombreuses tudes d'ouvrages ctiers modlisent la mare grce des simulations numriques.
partir de la version 6.1 de TELEMAC-2D, des dveloppements ont t intgrs afin de pouvoir
traiter la modlisation de la mare pour deux raisons :
- proposer des sous-programmes pour traiter la mare dans la version standard de TELEMAC de la
manire la plus automatique possible, ce qui facilite le lancement des simulations et permet de limiter
le risque d'erreurs potentielles ;
- fournir la communaut des utilisateurs de TELEMAC une base de constantes harmoniques de
mare gratuite.
La version 6.2 de TELEMAC (2D et 3D) permet l'utilisation de trois bases de constantes
harmoniques. Elles incluent l'atlas rgional NEA (pour North East Atlantic), ralis par
NOVELTIS/LEGOS qui couvre la partie nord-est de l'Atlantique, de la Mauritanie au sud de la
Norvge, ainsi que la solution globale de mare TPXO et d'autres solutions rgionales ou locales
provenant de l'Universit de l'tat de l'Oregon ou Oregon State University (OSU). Elles fournissent
la fois des hauteurs d'eau et les composantes horizontales de vitesse des constantes harmoniques
avec une rsolution spatiale plutt bonne.
l'intrieur de la prsente note sont notamment dcrits les trois ensembles de bases de constantes
harmoniques actuellement disponibles dans la version 6.2 de TELEMAC (2D et 3D), les
dveloppements mens sur TELEMAC pour chacune des bases de constantes harmoniques et les
mots-cls utiles pour la simulation de la mare avec TELEMAC.
Ce document constitue un guide mthodologique pour les tudes avec modlisation de la mare avec
TELEMAC-2D ou TELEMAC-3D en version 6.2. Ce livrable a t ralis dans le cadre du projet PHE
(P10VU).
Accessibilit : Libre Mention Spciale : Dclassement :

Page de garde Page I sur IV EDF SA 2013
EDF R&D
NATIONAL HYDRAULICS AND ENVIRONMENT LABORATORY
NUMERICAL AND PHYSICAL MODELLING IN RIVER AND COASTAL HYDRODYNAMICS
6 quai Watier - 78401 CHATOU CEDEX, +33 (1) 30 87 79 46
February 7 2013
Front Page
Methodology to model tides with version 6.2 of TELEMAC-2D and TELEMAC-3D
Chi-tun PHAM
Sbastien BOURBAN HR Wallingford
Nomie DURAND HR Wallingford
Michael TURNBULL HR Wallingford
H-P74-2012-02534-FR 1.0
Many studies of waterworks use numerical modelling of tides. Since version 6.1 of TELEMAC-2D,
some developments have been integrated in order to deal with modelling of tides for two reasons:
- to propose some subroutines to deal with tides in the most automatic way as possible in the standard
version of Telemac-2D. This may facilitate calculations and may also decrease the number of potential
errors,
- to supply a database of harmonic constants to the community of TELEMAC users for free.
The version 6.2 of TELEMAC (2D and 3D) enables the use of three databases of harmonic constants.
These include the regional NEA atlas (North East Atlantic), processed by NOVELTIS/LEGOS, which
covers an area from Mauritania to the south of Norway, as well as the TPXO global tidal solution and
other regional or local solutions from Oregon State University (OSU). They provide the water depths
and horizontal velocity components of harmonic constants with a quite good spatial resolution. In this
report, the three sets of databases of harmonic constants currently available in the version 6.2 of
TELEMAC (2D and 3D) are described, as well as the developments carried out in TELEMAC for each
database and the keywords to model tides in TELEMAC.
This document is a manual for studies modelling tides with the version 6.2 of TELEMAC 2D and 3D.
This deliverable was carried out in the frame of the PHE project (P10VU).
Accessibility : Free Special Mention : Declassification :

Front page Page II of IV EDF SA 2013
EDF R&D Mthodologie pour la simulation de la mare avec la version 6.2 de TELEMAC-2D et TELEMAC-3D H-P74-2012-02534-FR
Version 1.0
AVERTISSEMENT / CAUTION
Laccs ce document, ainsi que son utilisation, sont strictement limits aux personnes expressment
habilites par EDF.
EDF ne pourra tre tenu responsable, au titre d'une action en responsabilit contractuelle, en
responsabilit dlictuelle ou de toute autre action, de tout dommage direct ou indirect, ou de quelque
nature qu'il soit, ou de tout prjudice, notamment, de nature financire ou commerciale, rsultant de
l'utilisation d'une quelconque information contenue dans ce document.
Les donnes et informations contenues dans ce document sont fournies "en l'tat" sans aucune
garantie expresse ou tacite de quelque nature que ce soit.
Toute modification, reproduction, extraction dlments, rutilisation de tout ou partie de ce document

sans autorisation pralable crite dEDF ainsi que toute diffusion externe EDF du prsent document
ou des informations quil contient est strictement interdite sous peine de sanctions.
-------
The access to this document and its use are strictly limited to the persons expressly authorized to do
so by EDF.
EDF shall not be deemed liable as a consequence of any action, for any direct or indirect damage,
including, among others, commercial or financial loss arising from the use of any information
contained in this document.
This document and the information contained therein are provided "as are" without any warranty of
any kind, either expressed or implied.
Any total or partial modification, reproduction, new use, distribution or extraction of elements of this
document or its content, without the express and prior written consent of EDF is strictly forbidden.
Failure to comply to the above provisions will expose to sanctions.
Accessibilit : Libre Page 1 sur 47 EDF SA 2013

Version 1.0
Synthse
De nombreuses tudes douvrages ctiers modlisent la mare grce des simulations numriques.
Pour les besoins dEDF, on peut citer par exemple :
- les tudes dimpact thermique des rejets des centrales de production dnergie sur
lenvironnement ;
- les tudes de transport de colmatants de circuits de refroidissement (algues, sable, groseilles
de mer), de nappes dhydrocarbures ou deffluents ;
- les tudes de caractrisation des courants de mare et destimation du productible de parcs
dhydroliennes
Avant la version 6.1 de TELEMAC-2D, les utilisateurs de TELEMAC souhaitant modliser la
propagation de la mare devaient dvelopper leurs propres traitements de calcul de conditions aux
limites de mare (variables en temps et en espace) dans le sous-programme BORD ( partir de sries
temporelles dlvation de surface libre ou de bases de constantes harmoniques de mare),
ventuellement en reproduisant des sous-programmes Fortran pour TELEMAC-2D dj utiliss pour
des tudes prcdentes. Un certain nombre de modifications taient ncessaires chaque simulation
suivant le type de mare simuler, ce qui tait susceptible de faire apparatre des erreurs. En outre,
la procdure pour gnrer les constantes harmoniques ntait pas trs simple.
- proposer des sous-programmes pour traiter la mare dans la version standard de TELEMAC
de la manire la plus automatique possible, ce qui facilite le lancement des simulations et
permet de limiter le risque derreurs potentielles ;
- fournir la communaut des utilisateurs de TELEMAC des bases de constantes harmoniques
de mare gratuites ou accs sous conditions.
Une mthodologie pour la simulation de la mare en Manche et proche Atlantique avec TELEMAC-2D
en version 6.1 a t rdige. Depuis la version 6.1 de TELEMAC-2D, les utilisateurs peuvent ainsi
utiliser une base de constantes harmoniques pour calculer les conditions aux limites de modles
locaux dans lensemble de la Manche et du Proche Atlantique.
La version 6.2 de TELEMAC (2D et 3D) permet en plus lutilisation dautres bases de constantes
harmoniques sur des domaines plus grands. Ces bases de donnes incluent latlas rgional NEA
(pour North East Atlantic), ralis par NOVELTIS/LEGOS, qui couvre la partie nord-est de lAtlantique,
de la Mauritanie au sud de la Norvge, ainsi que la solution globale de mare TPXO et dautres
solutions rgionales ou locales provenant de lOregon State University (OSU).
Les trois bases de constantes harmoniques actuellement utilisables dans la version 6.2 de TELEMAC
(2D et 3D) sont dcrites dans la prsente note. Les dveloppements raliss dans TELEMAC pour
chacune des bases de constantes harmoniques sont explicits. Ces bases de donnes fournissent
la fois les hauteurs deau et les composantes horizontales de vitesse des constantes harmoniques
avec une rsolution spatiale plutt bonne. En particulier, latlas NEA permet de traiter 47 composantes
harmoniques pour sa solution hydrodynamique a priori et 15 composantes harmoniques pour sa
solution assimile avec des observations satellitaires. Les solutions proposes par lOSU permettent
de traiter environ 11 composantes harmoniques pour les solutions couvrant les ctes franaises par
exemple.
Ce document constitue un guide mthodologique pour les tudes avec modlisation de la mare avec
TELEMAC-2D ou TELEMAC-3D en version 6.2.

Version 1.0
Sommaire / Summary
PAGE DE GARDE ....................................................................................................................................I
FRONT PAGE ..........................................................................................................................................II
CIRCUIT DE VALIDATION .....................................................................................................................III
PRE-DIFFUSION .....................................................................................................................................III
LISTE DE DIFFUSION ........................................................................................................................... IV
AVERTISSEMENT / CAUTION ...............................................................................................................1
SYNTHSE ..............................................................................................................................................2
SOMMAIRE / SUMMARY ........................................................................................................................3
1. INTRODUCTION ...............................................................................................................................5
2. LEMENTS DE THEORIE UTILISES POUR MODELISER LA MAREE ........................................5

2.1. LES COURANTS DE MAREE ................................................................................................................5
2.2. MISE EN EQUATIONS.........................................................................................................................6
2.3. BASES DE CONSTANTES HARMONIQUES DISPONIBLES.........................................................................7
2.3.1. Modle de simulation des courants de mare en Manche et proche Atlantique (JMJ) .........7
2.3.2. Atlas Nord-Est Atlantique du LEGOS (NEA) ..........................................................................8
2.3.3. La solution globale TPXO et les solutions rgionales et locales de lOregon State
University (OSU) ...................................................................................................................................9
2.4. SIMULATION DE MAREES REELLES , A PARTIR DUN JOUR PRECIS DU CALENDRIER .........................10
2.5. SIMULATION DE MAREES TYPES.......................................................................................................10
2.6. SIMULATION AVEC LE MODULE TPXO ..............................................................................................11
3. APPLICATION DANS TELEMAC ..................................................................................................12
3.1. SOUS-PROGRAMME DE COMMANDE TIDAL_MODEL_T2D OU TIDAL_MODEL_T3D ......................13
3.2. SOUS-PROGRAMME DE GENERATION DES CONSTANTES HARMONIQUES DE MAREE BORD_TIDAL_BC14
3.3. SOUS-PROGRAMMES POUR LE CALCUL DES CONDITIONS AUX LIMITES DE MAREE BORD_TIDE ET
BORD_TIDE_LEGOS.............................................................................................................................15
3.3.1. Mares types avec BORD_TIDE..........................................................................................16
3.3.2. Mares relles , partir dun jour prcis du calendrier, avec BORD_TIDE ou
BORD_TIDE_LEGOS .........................................................................................................................16
3.4. SOUS-PROGRAMMES DE CALCUL DE FACTEURS NODAUX POUR LES BASES JMJ ET NEA ....................16
3.5. SOUS-PROGRAMMES DE CONVERSION DE SYSTEMES GEOGRAPHIQUES .............................................17
3.6. MODULE TPXO .............................................................................................................................17
4. FICHIERS DENTREE DU MODELE NUMERIQUE TELEMAC ....................................................18
4.1. FICHIER DES PARAMETRES .............................................................................................................18
4.1.1. Paramtres gnraux de mare...........................................................................................19
4.1.2. Paralllisme ..........................................................................................................................20
4.1.3. Fichiers de donnes de mare .............................................................................................20
4.1.4. Origine des temps et conditions initiales ..............................................................................20
4.1.5. Coordonnes et systme gographique ..............................................................................21
4.1.6. Coefficients de calage de la mare ......................................................................................22
4.2. FICHIER DES CONDITIONS AUX LIMITES ............................................................................................22
4.3. FICHIER FORTRAN ..........................................................................................................................22
4.4. FICHIER DES CONSTANTES HARMONIQUES DE MAREE .......................................................................22

Version 1.0
5. MODE OPERATOIRE POUR GENERER LE FICHIER DES CONSTANTES HARMONIQUES DE

MAREE ...................................................................................................................................................24
6. SIMULATION DE LA MAREE EN VERSION 6.2 ...........................................................................27
7. QUELQUES ERREURS A NE PAS COMMETTRE .......................................................................28
8. MOTS-CLES ET FICHIERS POUR LUTILISATION DES DIFFERENTES BASES DE

CONSTANTES HARMONIQUES ..........................................................................................................29
8.1. TOUTE BASE DE CONSTANTES HARMONIQUES DE MAREE ..................................................................29
8.2. SOLUTIONS PROVENANT DE LOSU .................................................................................................30
8.3. BASE JMJ .....................................................................................................................................30
8.4. ATLAS NEA ...................................................................................................................................30
9. CONCLUSION ET PERSPECTIVES ..............................................................................................31
10. REFERENCES ............................................................................................................................31
ANNEXE 1 : EXEMPLES DE SOUS-PROGRAMMES TIDAL_MODEL_T2D ET TIDAL_MODEL_T3D

POUR UNE SIMULATION DE LA MAREE AVEC TELEMAC EN VERSION 6.2 ................................33
ANNEXE 2 : EXEMPLE DE FICHIER DES CONDITIONS AUX LIMITES ...........................................43
ANNEXE 3 : EXEMPLE DE FICHIER DES CONSTANTES HARMONIQUES DE MARE POUR LA

BASE JMJ ..............................................................................................................................................44
ANNEXE 4 : EXEMPLE DE FICHIER DES CONSTANTES HARMONIQUES DE MARE POUR

LATLAS NEA ........................................................................................................................................45
ANNEXE 5 : EXEMPLE DE FICHIER DES PARAMTRES POUR TELEMAC-2D .............................46

Version 1.0
Notation : dans lintgralit de cette note, TELEMAC dsignera indiffremment les logiciels
TELEMAC-2D et/ou TELEMAC-3D.
1. Introduction
Avant la version 6.1 de TELEMAC-2D, les utilisateurs de TELEMAC souhaitant modliser la
propagation de la mare sur un domaine dtude maritime ou proximit dun estuaire devaient
dvelopper leurs propres traitements de calcul de conditions aux limites de mare (variables en temps
et en espace) dans le sous-programme BORD ( partir de sries temporelles dlvation de surface
libre ou de bases de constantes harmoniques de mare), ventuellement en reproduisant des sous-
programmes Fortran pour TELEMAC-2D dj utiliss pour des tudes prcdentes. Un certain
nombre de modifications taient ncessaires chaque simulation suivant le type de mare simuler,
ce qui tait susceptible de faire apparatre des erreurs. En outre, la procdure pour gnrer les
constantes harmoniques ntait pas trs simple.
- proposer des sous-programmes pour traiter la mare dans la version standard de TELEMAC
de la manire la plus automatique possible (avec mots-cls), ce qui facilite le lancement des
simulations et permet de limiter le risque derreurs potentielles ;
- fournir la communaut des utilisateurs de TELEMAC des bases de constantes harmoniques
de mare gratuites ou accs sous conditions.
Une mthodologie pour la simulation de la mare en Manche et proche Atlantique avec TELEMAC-2D
en version 6.1 a t rdige [1]. Depuis la version 6.1 de TELEMAC-2D, les utilisateurs peuvent ainsi
utiliser une base de constantes harmoniques pour calculer les conditions aux limites de modles
locaux dans lensemble de la Manche et du Proche Atlantique grce la base de constantes
harmoniques dite de Jean-Marc Janin (JMJ).
La version 6.2 de TELEMAC permet en plus lutilisation dautres bases de constantes harmoniques
sur des domaines plus grands. Ces bases de donnes incluent latlas rgional NEA (pour North East
Atlantic), ralis par NOVELTIS/LEGOS, qui couvre la partie nord-est de lAtlantique, de la Mauritanie
au sud de la Norvge, ainsi que la solution globale de mare TPXO et dautres solutions rgionales ou
locales provenant de lOregon State University (OSU).
Dans un premier temps, la thorie utilise dans cette mthodologie pour modliser la mare dans
TELEMAC est prsente pour les diffrentes bases de donnes disponibles, notamment la possibilit
de reprsenter des mares types ou des mares partir dun jour prcis du calendrier (aussi
appeles mares relles ) ; en outre les trois bases de constantes harmoniques utilisables en
version 6.2 de TELEMAC sont dcrites. Dans une deuxime partie, les dveloppements raliss dans
TELEMAC en version 6.2 pour appliquer ces lments de thorie de la mare sont explicits et les
diffrents paramtres renseigner pour une simulation de la mare avec TELEMAC sont dcrits. Les
sections 4, 5 et 6 dcrivent les fichiers dentre de calculs TELEMAC de modlisation de la mare (en
particulier la sous-section 4.1 dcrit lensemble des mots-cls utiliss par cette mthodologie de
modlisation de la mare) ainsi que les deux tapes de gnration du fichier des constantes et de
calcul des conditions aux limites de mare. Les deux dernires parties recensent quelques erreurs
viter pour lutilisation de cette base de donnes ainsi que les mots-cls et fichiers indispensables ou
utiles pour lutilisation des diffrentes bases de constantes harmoniques. Ce rapport indique en outre
les dveloppements envisags pour les versions suivantes. Un exemple de cas test est fourni en
version 6.2 de TELEMAC-2D et de TELEMAC-3D.
2. lments de thorie utiliss pour modliser la mare
2.1. Les courants de mare

Les mares ocaniques peuvent tre considres comme la superposition dun ensemble dondes

Version 1.0
lmentaires, appeles aussi composantes harmoniques, rpertories en fonction de leur priode

approximative et de leur origine physique.
On distingue quatre types de composantes harmoniques :
- les ondes de longues priodes, mensuelles, semestrielles ou annuelles ;
- les ondes diurnes, dont la priode est voisine de vingt-quatre heures ;
- les ondes semi-diurnes, ayant une priode denviron douze heures ;
- les ondes suprieures et composes de priodes quart-diurne, tiers-diurne
Dans la plupart des cas, les ondes diurnes et semi-diurnes sont nettement prdominantes. Elles
gnrent la forme gnrale des mares. Toutefois, dans les zones de faible profondeur, les ondes
suprieures et composes peuvent jouer un rle important.
On parle de mares de type semi-diurne lorsque les composantes diurnes sont ngligeables devant
les composantes semi-diurnes. Il y a alors deux pleines mers et deux basses mers par jour,
dimportances sensiblement gales. Ce type de mare est, par exemple, prpondrant en Atlantique
et en Manche.
Les trois principales composantes harmoniques semi-diurnes sont :
- M2 ou onde lunaire principale, de priode 44 714 s (12 h 25 min 14 s) ;
- S2 ou onde solaire principale, de priode 43 200 s (12 h) ;
- N2 ou onde lunaire elliptique majeure, de priode 45 570 s (12 h 39 min 30 s).
Les harmoniques dordre plus lev peuvent rsulter dinteractions non linaires des ondes entre
elles. Ainsi, linteraction de londe M2 avec elle-mme cre londe M4 ainsi quune rsiduelle
constante. Londe M4, appele premire harmonique de M2, est une onde quart-diurne (de priode
22 357 s = 6 h 12 min 37 s).
2.2. Mise en quations

La thorie utilise pour reprsenter la mare dans TELEMAC en version 6.2 provient trs
majoritairement de Janin et al. [2] et de Schureman [3]. Le lecteur est notamment invit lire ces
ouvrages pour complter la prsente note.
Deux catgories de mares peuvent tre simules avec TELEMAC en version 6.2 :
- des mares types (uniquement pour la base de donnes dite de Jean-Marc Janin JMJ) :
o mare de vive-eau exceptionnelle (coefficient de mare !""#$%
o mare de vive-eau moyenne (coefficient de mare !&'$%
o mare moyenne (coefficient de mare !(#$%
o mare de morte-eau moyenne (coefficient de mare !)'$%
o mare de morte-eau exceptionnelle (coefficient de mare !*#$ ;
- des mares relles , partir dun jour prcis du calendrier.
NB : on appellera partir de maintenant mare relle , une mare partir dun jour prcis du
calendrier.
La hauteur deau h et les composantes de vitesse horizontale U et V sont calcules de la manire
suivante, au point M et au temps t :
F ( M , t ) " ! Fi ( M , t ) , (1)
i
avec :

Version 1.0
( t %
Fi ( M , t ) " AF i ( M ) cos&& 2+ ) * Fi ( M ) ## , (2)
' Ti $
pour des mares types,
( t %
Fi ( M , t ) " f i (t ) AF i ( M ) cos&& 2+ ) * Fi ( M ) , ui0 , vi (t ) ## , (3)
' Ti $
pour des mares relles , partir dun jour prcis du calendrier,
o la grandeur F dsigne la hauteur deau h ou une des composantes de vitesse horizontale U ou V, i
dsigne londe considre, Ti reprsente la priode de londe, AFi dsigne lamplitude de la hauteur ou
dune des composantes de vitesse horizontale de londe (donne dans le fichier des constantes
harmoniques dans TELEMAC, voir la sous-section 4.4, ou directement interpole), sa phase *Fi, fi(t) et
vi(t) dsignent les facteurs nodaux et ui0 dsigne la phase lorigine des temps pour la simulation (voir
sous-section 2.4) pour des mares relles , partir dun jour prcis du calendrier. Pour des mares
relles , la phase cite ci-dessus est directement la phase de londe donne dans le fichier des
constantes harmoniques dans TELEMAC. Pour des mares types, la phase est obtenue en sommant
la phase donne dans le fichier des constantes harmoniques et le dphasage donn dans le Tableau
1.
Les hauteurs et les vitesses de chaque onde considre sont donc ensuite sommes pour obtenir les
hauteurs deau et vitesses imposer comme conditions aux limites du domaine :
- h " ! hi ) z f , z moy , (4)

i
- U " !U i , (5)
i
- V " ! Vi , (6)
i
o zf est la cote du fond et zmoy est un niveau pour caler les niveaux de mer (dans le mme rfrentiel,
par exemple en m CM Cartes Marines , MSL Mean Sea Level ou IGN69).
Les coefficients AFi et *Fi sont des constantes par rapport au temps et ne dpendent que de la position
du point M. Ces valeurs, dont la qualit est trs importante, sont trs utilises pour la modlisation de
la propagation de la mare et des bases de constantes harmoniques existent pour diffrentes zones.
Trois dentre elles sont disponibles pour des calculs avec TELEMAC en version 6.2.
2.3. Bases de constantes harmoniques disponibles
2.3.1. Modle de simulation des courants de mare en Manche et

proche Atlantique (JMJ)
Jean-Marc Janin (JMJ) et Xavier Blanchard ont ralis la simulation dterministe de la mare sur un
mois afin de calculer des champs de courants sous forme de constantes harmoniques dans
l'ensemble de la Manche et du Proche Atlantique pour les quatre ondes M2, S2, N2 et M4 [2]. Ces
constantes constituent ainsi une base de donnes utilise pour le calcul de conditions aux limites de
modles numriques plus locaux. Le domaine d'tude, qui s'tend au-del du plateau continental (voir
Figure 1), comporte 29 229 lments triangulaires avec des tailles de maille dcroissant de 40 km au
large 2 km la cte. La prcision obtenue est ainsi de lordre de 5 10 cm [2].

Version 1.0
Figure 1 : Emprise du modle dit de Jean-Marc Janin [2].

Le modle JMJ considre quatre ondes (M2, S2, N2 et M4) et donne les amplitudes et phases pour la
hauteur deau et pour deux composantes horizontales de vitesse.
2.3.2. Atlas Nord-Est Atlantique du LEGOS (NEA)

Les conditions aux limites peuvent aussi provenir de latlas rgional NEA (Nord-Est Atlantique) ralis
par NOVELTIS/LEGOS dans le cadre du projet COMAPI financ par le CNES [4], [5]. Latlas couvre la
partie nord-est de lAtlantique, de la Mauritanie au sud de la Norvge (voir Figure 2) et donne les
amplitudes et les phases pour la hauteur deau et pour les deux composantes horizontales de vitesse.
Le modle hydrodynamique qui a servi pour raliser cet atlas est bas sur le logiciel T-UGOm [7] qui
utilise la technique des lments finis. La dernire version (printemps 2010) donne 47 composantes
harmoniques (2MK6, 2MN6, 2MS6, 2N2, 2Q1, 2SM2, 2SM6, -2, J1, K1, K2, KJ2, L2, .2, M1, M2, M4,
M6, Mf, MK3, MK4, MKS2, Mm, MN4, MO3, MP1, MS4, MSK6, MSN2, MSN6, MSqm, Mtm, /2, N2,
02, O1, P1, Q1, R2, 11, S2, S4, 21, SK4, SN4, T2 et Z0). La rsolution approximative est de 20-25 km
dans locan jusqu 4 km prs de la cte (avec un raffinement local jusqu 1 ou 2 km dans les
pertuis).

Version 1.0
Figure 2 : Emprise de latlas NEA [6].

En plus des solutions hydrodynamiques a priori, latlas NEA fournit une solution de 15 composantes
harmoniques (2N2, K1, K2, L2, M2, M4, MS4, /2, N2, 02, O1, P1, Q1, S2 et T2) amliore par
assimilation dobservations satellitaires. Lassimilation de donnes, construite avec la mthode des
reprsentants, est base sur le logiciel SpEnOI [7]. Latlas NEA (et dautres atlas rgionaux comme la
mer Mditerrane, le golfe persique, le plateau de lAmazonie) peuvent tre tlchargs sur le site
web de Sirocco (un service communautaire INSU) sous conditions [8].
2.3.3. La solution globale TPXO et les solutions rgionales et

locales de lOregon State University (OSU)
LOregon State University (OSU) fournit une solution de mare globale (appele TPXO) et plusieurs
solutions rgionales et locales [9]. Par exemple, pour modliser les ctes franaises ou britanniques, il
existe les solutions de lOcan Atlantique (Atlantic Ocean AO) ou du plateau europen (European
Shelf ES voir Figure 3) qui couvre la partie nord-est de locan Atlantique, dfinis sur des grilles
structures avec 11 composantes harmoniques (M2, S2, N2, K2, K1, O1, P1, Q1, M4, MS4 et MN4)
ou 13 pour la solution globale TPXO (mmes composantes harmoniques + Mf et Mm). Les solutions
donnes sur grilles rgulires, fournissent les amplitudes et phases pour la hauteur deau et des
termes de transport qui correspondent au produit de la hauteur deau par les composantes
horizontales de vitesse. Ces dernires peuvent donc tre obtenues par division des termes de
transport par la hauteur deau (attention aux divisions par 0 qui peuvent donner des vitesses
anormalement leves !). Les rsolutions des diffrents modles sont, par exemple, de degr pour
la solution globale TPXO, 1/12 de degr pour la solution rgionale Atlantic Ocean et 1/30 de degr
pour la solution locale European Shelf. Il est notamment conseill dutiliser des solutions locales (par
exemple lEuropean Shelf le long des ctes franaises, lorsque cest possible) en cas de prsence de
bancs dcouvrants dans ces solutions au niveau du modle numrique local en zone ctire. Le
lecteur pourra lire le site web [9] pour plus dinformations.

Version 1.0
Figure 3 : Emprise de la solution locale European Shelf [9].
2.4. Simulation de mares relles , partir dun jour prcis

du calendrier
Pour des mares relles , chaque onde considre peut se mettre sous la forme (voir formule
( 3 )) :
( t %
Fi ( M , t ) " f i (t ) AF i ( M ) 3 cos&& 2+ ) * Fi ( M ) , ui0 , vi (t ) ## , (7)
' Ti $
avec fi(t) et vi(t) qui dsignent les facteurs nodaux et ui0 dsigne la phase lorigine des temps pour la
simulation. Ces facteurs nodaux sont prendre en compte pour corriger les variations lentes induites
par linclinaison de lorbite de la Lune sur lquateur [10]. Pour des ondes solaires, comme S2, il ny a
pas de correction (fi(t) = 1 et vi(t) = ui0 = 0 chaque instant t). Par contre, pour les ondes lunaires ou
les ondes composes avec au moins une onde lunaire, ces facteurs sont calculer. Les formules
utilises ici sont celles de Pugh [11] pour la base JMJ, de Schureman [3] pour latlas NEA et sont
celles codes originellement dans le logiciel OTPS (OSU Tidal Prediction Software) [9] pour les
solutions provenant de lOSU, aux corrections de bugs prs (cf. sous-section 3.6).
Quelques paramtres sont calculs directement dans TELEMAC : la longitude moyenne de la lune, la
longitude moyenne du soleil, la longitude du prige lunaire, la longitude du nud ascendant lunaire.
Les facteurs nodaux sont ensuite calculs partir de ces paramtres (cf. formules de Pugh [11] ou la
note en version 6.1 [1] pour la base JMJ, ou les formules de Schureman [3] pour latlas NEA). Les
formules sur ui0 et fi(t) diffrent lgrement suivant les auteurs.
On peut trouver des valeurs des facteurs fi(t) tabules (cf. Tableau 11 de [2] ou Tableau 14 en annexe
de [3]) au jour correspondant au milieu de lanne. Avant davoir des moyens de calcul assez
performants, ces facteurs nodaux fi(t) pouvaient tre considrs comme constants sur toute une
anne. Ceci est en particulier possible en figeant le paramtre N la mme valeur tout au long de
lanne.
2.5. Simulation de mares types

La version 6.2 de TELEMAC offre la possibilit de simuler des mares types (uniquement pour la
base de donnes JMJ) :

Version 1.0
- mare de vive-eau exceptionnelle (coefficient de mare !""#$ ;

- mare de vive-eau moyenne (coefficient de mare !&'$ ;
- mare moyenne (coefficient de mare !(#$ ;
- mare de morte-eau moyenne (coefficient de mare !)'$ ;
- mare de morte-eau exceptionnelle (coefficient de mare !*#$+
On rappelle que seules quatre composantes harmoniques (M2, S2, N2 et M4) sont prises en compte
par la base de constantes harmoniques dite de Jean-Marc Janin.
Lors de la modlisation des mares de morte-eau et de vive-eau moyennes au niveau des sites en
bord de mer, les harmoniques M2, S2 et M4 sont considres ; pour les mares exceptionnelles la
contribution de londe N2 est ajoute (cf. Tableau 1). Seules les ondes M2 et M4 sont prises en
compte pour une mare moyenne. Certains types de mares ncessitent dimposer un dphasage de
180 une ou deux des ondes considres, comme on peut le voir dans le Tableau 1.
Tableau 1 : Dphasages de chacune des ondes afin de simuler un type de mares

donn. Tableau extrait du rapport [2].
2.6. Simulation avec le module TPXO

La thorie utilise avec les solutions de lOSU est lgrement diffrente (travail dans lespace des
complexes). La formule (7) devient ainsi :
( (( t %%%
F j ( M , t ) " f j (t ) Re& AF j ( M ) exp& i& 2+ , * F j ( M ) , u 0j , v j (t ) # # # . (8)
& & & Tj ###
' '' $$$
Pour lutilisation de ses solutions de constantes harmoniques, lOSU met des sources la libre
disposition du public sur son site web [9]. La thorie utilise est donc exactement la mme que celle
fournie par lOSU.
En particulier, ce ne sont pas les vitesses qui sont fournies sous forme de constantes harmoniques,
mais des termes de transport (produit de la hauteur deau par les composantes horizontales de
vitesse). Pour obtenir les composantes de vitesse, il faut donc diviser ces termes de transport par la
hauteur deau, ce qui peut poser problme dans des zones de bancs dcouvrants (en pratique, un
seuil minimum de 10 cm de hauteur deau est utilis pour viter des divisions par 0, ce qui peut

Version 1.0
nanmoins entraner des valeurs de vitesses trop importantes et physiquement incorrectes). En outre,
pour le calcul des facteurs nodaux, comme dj dit la sous-section 2.4, les formules utilises sont
celles codes originellement dans le logiciel OTPS (OSU Tidal Prediction Software) [9] pour les
solutions provenant de lOSU, aux corrections de bugs prs (cf. sous-section 3.6).
3. Application dans TELEMAC

Comme il est dcrit plus loin dans les sections 5 et 6, la mthodologie propose dans le prsent
rapport comporte deux phases pour la base JMJ ; pour latlas NEA, seule la deuxime phase de
calculs des conditions aux limites est concerne. Enfin, pour les bases provenant de lOSU, cest une
autre mthodologie qui est employe : les deux phases sont incluses directement dans le module
Fortran TPXO, sans passage par un fichier intermdiaire contenant les constantes harmoniques de
mare. Les deux phases sont ainsi :
- la gnration du fichier des constantes harmoniques de mare (uniquement pour la base JMJ
dans la prsente note) ;
- le calcul des conditions aux limites des nuds de frontire maritime pour les composantes
horizontales de vitesse et/ou pour la hauteur deau, variables en temps et en espace.
Afin de pouvoir traiter les lments de thorie dcrits dans la section 2, onze sous-programmes ainsi
quun module ont t intgrs la version 6.2 :
- un module Fortran TPXO qui contient notamment le sous-programme BORD_TIDE_TPXO pour
le calcul des conditions aux limites aux nuds de frontire maritime pour les solutions
provenant de lOSU ;
- deux sous-programmes de commande TIDAL_MODEL_T2D en 2D et TIDAL_MODEL_T3D en
3D ;
- trois sous-programmes principaux (gnration des constantes harmoniques pour la base JMJ
et calcul des conditions aux limites aux nuds de frontire maritime pour les deux bases JMJ
et NEA) BORD_TIDAL_BC, BORD_TIDE et BORD_TIDE_LEGOS ;
- quatre sous-programmes de calcul de facteurs nodaux NODALUPV_PUGH, NODALF_PUGH,
NODALUPV_SCHUREMAN et NODALF_SCHUREMAN ;
- deux sous-programmes de conversion de systmes plans en systme gographique
longitude/latitude CONV_LAMBERT_TO_DEGDEC et CONV_MERCATOR_TO_DEGDEC.
Ainsi, les sous-programmes de commande TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D appellent
(ventuellement) celui de gnration du fichier des constantes harmoniques (BORD_TIDAL_BC, pour
la base JMJ uniquement) et ceux de calcul des conditions aux limites des nuds de frontire maritime
(BORD_TIDE, BORD_TIDE_LEGOS ou BORD_TIDE_TPXO du module TPXO). Les sous-programmes
NODALUPV_PUGH et NODALF_PUGH (resp. NODALUPV_SCHUREMAN et NODALF_SCHUREMAN) sont
appels pour la simulation de mares relles , partir dun jour prcis du calendrier, lintrieur du
sous-programme BORD_TIDE (resp. BORD_TIDE_LEGOS). Les deux sous-programmes de conversion
de systmes gographiques CONV_LAMBERT_TO_DEGDEC et CONV_MERCATOR_TO_DEGDEC sont
appels chaque interpolation des coordonnes du modle local sur les bases de donnes de
constantes harmoniques, par exemple dans le sous-programme BORD_TIDAL_BC ou dans le module
TPXO (sous-programmes BORD_TIDE_TPXO ou CONDI_TPXO), afin de pouvoir traiter de modles
numriques construits dans des systmes de coordonnes varis. Larbre dappels de ces sous-
programmes est prsent ci-aprs. Plus de dtails sur ces sous-programmes sont donns dans le
reste de cette section.

Version 1.0
3.1. Sous-programme de commande TIDAL_MODEL_T2D ou

TIDAL_MODEL_T3D
Selon que le mot-cl OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE est activ ou non
(par un entier compris entre 1 et 7, voir sous-section 4.1), le sous-programme BORD en 2D (resp.
BORD3D en 3D) appelle le sous-programme TIDAL_MODEL_T2D (resp. TIDAL_MODEL_T3D). Par
dfaut, ce mot-cl est mis 0 (pas de prise en compte de la mare par la mthodologie dcrite dans
cette note).
Ce sous-programme contient les paramtres lis la mare renseigner pour gnrer le fichier des
constantes harmoniques (uniquement pour la base JMJ) et/ou calculer les conditions aux limites des
nuds de frontire maritime. Ces paramtres sont ceux qui nexistent pas en mot-cl du dictionnaire
de TELEMAC de la version 6.2. Ils sont dcrits plus en dtails dans les sections 5 et 6, suivant que
lon gnre le fichier des constantes harmoniques ou que lon calcule les conditions aux limites de
mare :
- TIDALBCGEN : logique qui permet de choisir si le fichier des constantes harmoniques
est gnr (= .TRUE.) ou pas (= .FALSE. par exemple lors dune simulation pour
laquelle le fichier des constantes harmoniques de mare a dj t gnr
prcdemment), pour la base JMJ uniquement en version 6.2 ;
- NODALCORR : entier qui indique comment sont calculs les facteurs nodaux fi(t) pour
la simulation de mares relles , partir dun jour prcis du calendrier (ne
concerne que les bases JMJ et NEA) ;
- ICALHW : entier qui donne le numro de nud de frontire maritime par rapport
auquel les ondes sont dphases pour dbuter la simulation aux environs dune
pleine mer, uniquement pour des mares types (aussi appel nud de rfrence

Version 1.0
pour le dphasage des ondes), donc pour la base JMJ uniquement en version 6.2 ;
- XSHIFT et YSHIFT : rels flottants qui sont les coordonnes du vecteur de translation
appliquer ventuellement en cas de dcalage entre le modle numrique local et le
modle qui sert interpoler lors de la gnration du fichier des constantes
harmoniques de mare (voir section 5 et Figure 4), donc pour la base JMJ
uniquement en version 6.2 ;
- BETA en 2D, ou BETA0 en 3D : rel flottant qui est langle de rotation appliquer
ventuellement en cas de dcalage entre le modle numrique local et le modle qui
sert interpoler lors de la gnration du fichier des constantes harmoniques de
mare (voir section 5 et Figure 5), pour la base JMJ uniquement en version 6.2 ;
- TM2S2N2EQUAL : boolen qui indique si les priodes des ondes M2, S2 et N2 sont
prises gales ou non pour la simulation de mares types uniquement (et uniquement
pour la base JMJ donc en version 6.2).
En outre, cest ce sous-programme qui appelle (ventuellement suivant la valeur du logique
TIDALBCGEN) le sous-programme BORD_TIDAL_BC pour la gnration du fichier des constantes
harmoniques et lun des sous-programmes BORD_TIDE, BORD_TIDE_LEGOS ou BORD_TIDE_TPXO
du module TPXO pour le calcul des conditions aux limites des nuds de frontire maritime.
Lutilisateur peut imposer une rampe de vitesse en dbut de simulation pour diminuer la dure de la
phase transitoire si les vitesses sont trop grandes pendant cette phase (un exemple de rampe sur
1 800 s = 30 min est laiss en commentaires en version 6.2). En pratique, ce sont alors les deux
composantes de vitesse de la mare qui sont multiplies par cette fonction rampe en dbut de calcul.
3.2. Sous-programme de gnration des constantes

harmoniques de mare BORD_TIDAL_BC
Le sous-programme BORD_TIDAL_BC nest utilis que pour la base de constantes harmoniques dite
de Jean-Marc Janin [2]. Il lit les deux fichiers de gomtrie et de constantes harmoniques de mare
du modle dit de Jean-Marc Janin [2], puis interpole les constantes harmoniques de mare aux
nuds de frontire maritime du modle numrique local. Cette interpolation est de type lments
finis. Ensuite, ce sous-programme crit les quelques lignes en en-tte du fichier des constantes
harmoniques de mare qui seront utiles lors de calculs en parallle. Il sagit du nombre de frontires
maritimes, ainsi que du numro local des extrmits de ces frontires maritimes (voir sous-section 4.4
+ Annexe 3).
Des paramtres de recalage sont dfinis dans le sous-programme TIDAL_MODEL_T2D en 2D (ou
TIDAL_MODEL_T3D en 3D) du fichier Fortran et utiliss dans le sous-programme BORD_TIDAL_BC
(plus de dtails seront donns en section 5) :
- XSHIFT et YSHIFT ;
- BETA en 2D (resp. BETA0 en 3D).
Ces paramtres modifier ventuellement sont surligns en cyan dans les exemples de sous-
programme TIDAL_MODEL_T2D et TIDAL_MODEL_T3D inclus en Annexe 1 pour la gnration du
fichier des constantes harmoniques.
Les coordonnes du modle numrique local sont transformes dabord en longitude/latitude (./*) par
lappel aux sous-programmes CONV_MERCATOR_TO_DEGDEC ou CONV_LAMBERT_TO_DEGDEC, puis
transformes en projection de Mercator (parfois appele coordonnes Mercator pour TELEMAC )
avec la relation :
xM = R.. (9)
yM = R.(log(tan(*/2++/4))-log(tan(48+/360++/4))) ( 10 )
avec R = 6 370 km le rayon de la Terre, la longitude . et la latitude * tant exprims en radians ici.

Version 1.0
Le sous-programme crit enfin le fichier des constantes harmoniques.

En version 6.2, cette phase de gnration des constantes harmoniques de mare nest possible quen
mode squentiel (pas de mode parallle possible en version 6.2). Cependant, la gnration du fichier
des constantes harmoniques nest ncessaire au plus quune fois pour un mme fichier de gomtrie
et un mme fichier des conditions aux limites associs.
3.3. Sous-programmes pour le calcul des conditions aux

limites de mare BORD_TIDE et BORD_TIDE_LEGOS
Pour lutilisation de la base de constantes harmoniques JMJ (resp. NEA), le sous-programme
BORD_TIDE (resp. BORD_TIDE_LEGOS) lit le fichier des constantes harmoniques de mare pour
chaque nud de la frontire maritime et pour chacune des ondes de mare considre (ainsi que des
informations utiles pour des calculs en mode parallle le nombre de frontires maritimes et les
numros locaux des extrmits de ces frontires maritimes). Ensuite, chaque pas de temps, le
sous-programme BORD_TIDE (resp. BORD_TIDE_LEGOS) permet de calculer les conditions aux
limites dues aux ondes de mare (hauteur deau et/ou composantes horizontales de vitesse, variables
en temps) imposer en chaque nud de frontire maritime du domaine dtude, conformment ce
qui est dcrit dans la section 2. Ce sous-programme fonctionne en modes squentiel et parallle.
Le mot-cl OPTION POUR LES CONDITIONS LIMITES DE MAREE (voir sous-section 4.1) permet de
dterminer les traitements spcifiques pour le calcul des conditions aux limites de mare de la
simulation de mares types (uniquement pour la base JMJ) ou de mares relles , partir dun jour
prcis du calendrier (en particulier, les ondes considres parmi les quatre disponibles et la phase
prendre en compte pour la simulation de mares types avec la base JMJ).
Des paramtres de dphasage des ondes et doptions de calcul des facteurs nodaux et des priodes
des ondes sont dfinis dans le sous-programme TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D (voir
sous-section 3.1) du fichier Fortran et utiliss dans le sous-programme BORD_TIDE (plus de dtails
seront donns dans la section 6) :
- NODALCORR (uniquement pour la simulation de mares relles , partir dun jour
prcis du calendrier, et seulement pour les bases JMJ et NEA) ;
- ICALHW (uniquement pour la simulation de mares types et donc pour la base JMJ en
version 6.2),
- TM2S2N2EQUAL (uniquement pour la simulation de mares types et donc pour la
base JMJ en version 6.2).
Ces paramtres modifier ventuellement sont surligns en jaune dans les exemples de sous-
programmes TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D inclus en Annexe 1 pour le calcul des
conditions aux limites de mare.
Avec les coefficients de calage dfinis en mots-cls et leurs mnmos (voir sous-section 4.1), les
relations ( 4 ) ( 6 ) deviennent en pratique :
h " CTIDE! hi ) z f , MSL ( 11 )

i
U " CTIDEV! U i ( 12 )
i
V " CTIDEV! Vi ( 13 )
i
Ce sont ces expressions qui ont t codes dans les sous-programmes BORD_TIDE et
BORD_TIDE_LEGOS.

Version 1.0
3.3.1. Mares types avec BORD_TIDE

La modlisation de mares types nest possible quavec la base JMJ en version 6.2.
Pour la simulation de mares types, toutes les ondes sont dphases linstant initial t = 0 au
dmarrage du calcul (pour toutes les variables hauteur deau h et composantes horizontales de
vitesse U et V). Ce dphasage constant pour toutes les ondes et tous les nuds de frontire maritime
correspond la phase de la hauteur en un nud particulier de la frontire. Son indice de nud est
fix par le paramtre ICALHW (gnralement vers le milieu de la (ou des) frontire(s) maritime(s) du
modle). On soustrait au dphasage de chaque onde la phase de la composante harmonique de la
hauteur en ce nud (que lon peut appeler nud ou point de rfrence). Par dfaut, si la valeur
ICALHW (pour Indice de Calage de la Pleine Mer, High Water en anglais) est laisse 0, le code
dtermine automatiquement un indice de nud situ la moiti de la numrotation des nuds de
frontire maritime. Lutilisateur peut donc ventuellement modifier ce choix de nud de rfrence par
dfaut si besoin. Ce paramtre ICALHW nest utilis que pour la simulation de mares types.
Pour des mares types, la phase *i a t code en version 6.1 comme tant la somme de la phase
donne par le fichier des constantes harmoniques de TELEMAC et dun dphasage suivant le type de
mare simul (voir sous-section 2.4). Dans ce cas-l, la simulation dmarre autour dune pleine mer
t = 0. Si lon ne souhaite pas commencer le calcul durant la pleine mer t = 0, il faut alors ajouter un
autre dphasage de lensemble des ondes (cf. Tableau 2 ou Tableau 9 de [2]) pour faire concider
linstant t = 0 avec un autre instant de la mare (par exemple la basse mer, le mi-montant ou le mi-
descendant). Lutilisateur est alors invit modifier le sous-programme BORD_TIDE en consquence.
Mi-montant ou Mi-descendant
Pleine mer ou Basse mer ou
mi-mare ou mi-mare
mare haute mare basse
descendante montante
phi () 0 90 180 270
Tableau 2 : Dphasage de lensemble des ondes afin dimposer la phase de la mare

t = 0.
3.3.2. Mares relles , partir dun jour prcis du calendrier,

avec BORD_TIDE ou BORD_TIDE_LEGOS
Les mots-cls DATE DE L'ORIGINE DES TEMPS et HEURE DE L'ORIGINE DES TEMPS (voir sous-
section 4.1) ainsi que le paramtre NODALCORR dfini dans TIDAL_MODEL_T2D en 2D ou
TIDAL_MODEL_T3D en 3D sont des arguments uniquement utiliss pour la simulation de mares
relles . Ils servent pour le calcul des facteurs nodaux dtermins dans les sous-programmes
NODALUPV_PUGH et NODALF_PUGH appels dans BORD_TIDE pour la base JMJ (voir sous-section
3.4) ou dans les sous-programmes NODALUPV_SCHUREMAN et NODALF_SCHUREMAN appels dans
BORD_TIDE_LEGOS pour latlas NEA.
Remarque : en version 6.2, un bug a t repr pour lutilisation du mot-cl HEURE DE
LORIGINE DES TEMPS avec la base JMJ. La prise en compte de ce mot-cl nest correcte
que pour les heures 0 h UTC et 12 h UTC. Ce bug sera corrig partir de la version suivante
de TELEMAC.
3.4. Sous-programmes de calcul de facteurs nodaux pour les

bases JMJ et NEA
Les facteurs nodaux pour la simulation de mares relles , partir dun jour prcis du calendrier,
sont calculs partir des formules de Pugh [11] pour la base JMJ ou de Schureman [3] pour latlas
NEA (voir sous-section 2.4). Elles ont t codes dans les sous-programmes NODALUPV_PUGH et

Version 1.0
NODALUPV_SCHUREMAN pour les termes ui0 et vi(t) et dans les sous-programmes NODALF_PUGH et
NODALF_SCHUREMAN pour les termes fi(t).
Les facteurs nodaux vi(t) et le dphasage lorigine ui0 ne sont calculs quune seule fois en dbut de
calcul en fonction des date et heure renseignes par les mots-cls DATE DE L'ORIGINE DES TEMPS
et HEURE DE L'ORIGINE DES TEMPS (voir sous-section 4.1).
En fonction du choix fait par lutilisateur pour le paramtre NODALCORR dans le sous-programme
TIDAL_MODEL_T2D en 2D ou TIDAL_MODEL_T3D en 3D, les facteurs nodaux fi(t) sont calculs
linstant de lorigine des temps de la simulation (choix 1 par dfaut) ou au milieu de lanne de lorigine
des temps de la simulation (choix 2, voir sous-section 2.4) et gards constants pendant toute la
simulation. Depuis la version 6.2 de TELEMAC, ils peuvent galement tre recalculs chaque pas
de temps (choix 0). Nanmoins, sur une courte dure de simulation, ces facteurs ne varient pas trop
(la diffrence relative des corrections reste au pire infrieure 2,5 % sur une anne complte, donc
bien moindre sur une priode plus courte comme quelques jours).
Remarque : en version 6.2, un bug a t repr pour lutilisation du mot-cl HEURE DE
LORIGINE DES TEMPS avec la base JMJ (voir remarque de la sous-sous-section 3.3.2).
3.5. Sous-programmes de conversion de systmes

gographiques
Pour utiliser les dveloppements intgrs en version 6.2 de TELEMAC, il est conseill de construire le
modle numrique dans un des systmes de coordonnes gographiques prciser par le mot-cl
SYSTEME GEOGRAPHIQUE, voir sous-section 4.1. On les nonce une premire fois ici :
- systme WGS84 gographique (longitude/latitude en degrs dcimaux) : choix 1 ;
- systme WGS84 plan UTM (nord ou sud) : choix 2 pour nord ou 3 pour sud ;
- systme NTF plan Lambert (Lambert 1 nord, 2 centre, 2 tendu, 3 sud, 4 Corse) :
choix 4. La projection Lambert 93 na pas encore t implmente en version 6.2 ;
- projection de Mercator (parfois aussi appele Mercator pour TELEMAC ) : choix 5
(en renseignant les mots-cls LONGITUDE DU POINT ORIGINE et LATITUDE DU
POINT ORIGINE).
Les sous-programmes CONV_LAMBERT_TO_DEGDEC et CONV_MERCATOR_TO_DEGDEC convertissent
les coordonnes de points de systmes gographiques plans WGS84 UTM ou Lambert, en systme
WGS84 gographique (longitude/latitude en degrs dcimaux). Ils utilisent les algorithmes disponibles
sur le site de lIGN [12-14]. Un petit biais a t utilis dans le sous-programme
CONV_LAMBERT_TO_DEGDEC pour le calcul de la latitude lors dune conversion partir du systme
Lambert afin de se recaler par rapport au logiciel Circ de lIGN.
Lutilisateur a la possibilit de dfinir un systme de coordonnes personnel quil peut coder dans les
sous-programmes BORD_TIDAL_BC, BORD_TIDE_TPXO ou CONDI_TPXO du module TPXO (par
exemple, conversion dans un repre local et rotation dun certain angle par commodit, qui est le cas
de lexemple cod dans les sous-programmes prcdemment cits pour la valeur 0 pour le mot-cl
SYSTEME GEOGRAPHIQUE).
3.6. Module TPXO

Pour lutilisation de ses solutions de constantes harmoniques, lOSU met des sources la libre
disposition du public sur son site web [9]. Les sous-programmes utiles ont ainsi t repris par HR
Wallingford, complts pour leur utilisation dans TELEMAC puis intgrs en version 6.2. Quelques
modifications sur les sous-programmes originaux ont nanmoins t apportes :
- la prcision des variables et constantes a t augmente de la simple prcision la double
prcision (pour les flottants et les complexes) lorsque ctait possible (hors lecture de donnes
binaires notamment) ;

Version 1.0
- quelques bugs ont t corrigs dans les sous-programmes ARGUMENTS et INFER_MINOR du

module TPXO pour le calcul des facteurs nodaux :
o les ondes !1, "2, M3 ntant pas solaires, les facteurs nodaux ne sont pas triviaux
(voir sous-section 2.4),
o le facteur multiplicatif f pour londe compose MS4 (= M2+S2) est le facteur f de M2
(pas celui de londe compose MN4 (= M2+N2) qui est le carr de celui de M2),
o le facteur nodal de phase u pour londe compose 2SM2 (= 2S2-M2) est loppos de
celui de M2, pas celui de M2.
lextrieur du module TPXO, ce sont les sous-programmes BORD_TIDE_TPXO et CONDI_TPXO qui
sont appels. Le premier est appel par les sous-programmes TIDAL_MODEL_T2D ou
TIDAL_MODEL_T3D au mme niveau que les sous-programmes BORD_TIDE pour la base JMJ et
BORD_TIDE_LEGOS pour latlas NEA. Il effectue le calcul des conditions aux limites dues aux ondes
de mare chaque pas de temps (hauteur deau et/ou composantes horizontales de vitesse,
variables en temps) imposer en chaque nud de frontire maritime du domaine dtude.
Contrairement aux sous-programmes BORD_TIDE et BORD_TIDE_LEGOS, aucun autre paramtre ne
doit tre dfini dans les sous-programmes TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D (en particulier,
les facteurs nodaux sont calculs chaque pas de temps). Les mots-cls DATE DE L'ORIGINE DES
TEMPS et HEURE DE L'ORIGINE DES TEMPS doivent tre renseigns (voir sous-section 4.1). Le
deuxime sous-programme CONDI_TPXO est utilis pour le calcul des conditions initiales si loption de
calcul des conditions initiales ALTIMETRIE SATELLITE TPXO est active (voir sous-section 4.1).
Ces sous-programmes fonctionnent en modes squentiel et parallle.
Les solutions de constantes harmoniques tant dfinies sur grilles rgulires, linterpolation des
valeurs se fait de manire bilinaire (voir le sous-programme BSI_WEIGHTS du module TPXO).
4. Fichiers dentre du modle numrique TELEMAC

Afin de raliser une simulation de propagation de la mare sur un domaine dtude, TELEMAC a
besoin dun certain nombre de fichiers dentre, en particulier des fichiers des paramtres, des
conditions aux limites, Fortran et des constantes harmoniques (+ ventuellement les fichiers de base
de donnes de mare).
4.1. Fichier des paramtres

Dans ce fichier figurent les mots-cls de la simulation. Afin de modliser la mare sur un domaine, il
faut en particulier prciser tout ou partie des mots-cls suivants :
- OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE ;
- BASE DE DONNEES DE MAREE ;
- FICHIER DES CONSTANTES HARMONIQUES ;
- INTERPOLATION DE COMPOSANTES MINEURES
- PROCESSEURS PARALLELES ;
- BASE BINAIRE 1 DE DONNEES DE MAREE ;
- BASE ASCII DE DONNEES DE MAREE (pour la gnration du fichier des constantes
harmoniques pour la base JMJ) ;
- FICHIER DU MODELE DE MAREE (pour la gnration du fichier des constantes
harmoniques pour la base JMJ) ;
- DATE DE L'ORIGINE DES TEMPS (pour la simulation de mares relles , partir
dun jour prcis du calendrier) ;

Version 1.0
- HEURE DE L'ORIGINE DES TEMPS (pour la simulation de mares relles ,

partir dun jour prcis du calendrier) ;
- CONDITIONS INITIALES ;
- SYSTEME GEOGRAPHIQUE ;
- NUMERO DE FUSEAU OU PROJECTION DANS LE SYSTEME GEOGRAPHIQUE ;
- LONGITUDE DU POINT ORIGINE ;
- LATITUDE DU POINT ORIGINE ;
- COEFFICIENT DE CALAGE DU MARNAGE ;
- COEFFICIENT DE CALAGE DES VITESSES DE COURANT ;
- COEFFICIENT DE CALAGE DU NIVEAU DE MER.
Un exemple de fichier des paramtres pour TELEMAC-2D est donn en Annexe 5 avec lutilisation
dune solution provenant de lOSU comme base de constantes harmoniques. Les mots-cls pour la
modlisation de la mare ont t surligns en jaune.
4.1.1. Paramtres gnraux de mare

Par dfaut, le mot-cl OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE est mis 0 (pas
de prise en compte de la mare par la mthodologie dcrite dans cette note). Pour activer les
dveloppements de traitement de la mare, il faut alors indiquer le type de mares simules par un
entier compris entre 1 et 7 : un des cinq choix prsents en sous-section 2.4 pour des mares types
(2 6) ou un des deux choix pour des mares relles , cest--dire la simulation de mares partir
dun jour prcis du calendrier (1 ou 7). Pour la version 6.2 de TELEMAC, les choix 2 7 ne sont
possibles que pour la base JMJ :
- 1 : mare relle (mthodologie recommande) ;
- 2 : mare de vive-eau exceptionnelle (coefficient de mare !110) ;
- 3 : mare de vive-eau moyenne (coefficient de mare !"#$ ;
- 4 : mare moyenne (coefficient de mare !%&$ ;
- 5 : mare de morte-eau moyenne (coefficient de mare !'#$ ;
- 6 : mare de morte-eau exceptionnelle (coefficient de mare !(&$ ;
- 7 : mare relle (mthodologie davant 2010 au LNHE).
Avec le mot-cl OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE dans TELEMAC, il est
ncessaire de bien distinguer le type 7 pour lequel les constantes harmoniques gnres sont au
format projection de composantes suivant x et y (format rectangulaire qui est celui dorigine de la base
de donnes dite de Jean-Marc Janin [2]) et les autres types pour lesquels le format des constantes
harmoniques est (amplitude, phase).
partir de la version 6.2 de TELEMAC, il est donc possible dutiliser trois bases de donnes de
constantes harmoniques. Le choix de la base est donn par le mot-cl BASE DE DONNEES DE
MAREE :
- 1 : base JMJ ;
- 2 : solutions provenant de lOSU (solution globale TPXO ou solutions rgionales ou
locales, par exemple : Atlantic Ocean ou European Shelf) ;
- 3 : atlas NEA du LEGOS.
Avec les bases JMJ et NEA, le fichier des constantes harmoniques doit obligatoirement exister avec le
chemin indiqu par le mot-cl FICHIER DES CONSTANTES HARMONIQUES et ventuellement tre
vide sil na pas t cr prcdemment (avec lutilisation des scripts Perl, ce fichier est dfini comme
READ-WRITE dans le dictionnaire de TELEMAC). Il contient les constantes harmoniques de chaque

Version 1.0
onde de mare en chaque nud de frontire maritime (voir descriptif en sous-section 4.4 ou
Annexes 3 et 4), ce qui permet dviter de stocker et manipuler les bases de constantes harmoniques
chaque calcul.
Si une solution provenant de lOSU est utilise comme base de constantes harmoniques, il y a une
possibilit dinterpoler des composantes mineures (non existantes dans les fichiers de solution de
constantes harmoniques, par exemple : 2Q1, #1, $1, M1, %&1, '1, (1, %!1, J1, OO1, 2N2, )2, *2, "2,
L2 et T2) partir de celles lues dans les fichiers correspondant aux mots-cls BASE BINAIRE 1 DE
DONNEES DE MAREE et BASE BINAIRE 2 DE DONNEES DE MAREE. Il faut alors activer le mot-cl
INTERPOLATION DE COMPOSANTES MINEURES (valeur par dfaut : NON). Cependant, il faut se
souvenir que lextension du spectre par fonctions dadmittance devient moins prcise dans les rgions
faibles profondeurs. Aussi, des composantes non linaires supplmentaires peuvent tre requises
pour reproduire prcisment la mare et les courants dans certaines rgions, typiquement lintrieur
de la Manche.
4.1.2. Paralllisme
Si lon souhaite effectuer une simulation de la mare avec TELEMAC en mode parallle, il faut
indiquer une valeur suprieure ou gale 2 pour le mot-cl PROCESSEURS PARALLELES.
Pour la base JMJ, seule la partie calcul des conditions aux limites de mare peut tre ralise en
mode parallle en version 6.2, une fois le fichier des constantes harmoniques gnr et crit une
premire fois. Si lon souhaite seulement gnrer ce fichier des constantes harmoniques, ou que lon
souhaite gnrer ce fichier des constantes harmoniques puis dans la continuit raliser une simulation
de la mare avec un mme calcul TELEMAC, il est uniquement possible de faire un calcul squentiel
(PROCESSEURS PARALLELES = 0) en version 6.2 (sinon, un message derreur saffiche). On
conseille donc lutilisateur de gnrer le fichier des constantes harmoniques une premire fois en
squentiel, puis, une fois ce fichier cr, de raliser les simulations sans gnrer ce fichier nouveau
chaque fois, ce qui permet dutiliser le mode parallle.
4.1.3. Fichiers de donnes de mare

Pour la base JMJ uniquement, les deux mots-cls FICHIER DU MODELE DE MAREE et BASE ASCII
DE DONNEES DE MAREE (ancien nom en version 6.1 : BASE DE DONNEES DE MAREE) sont
prciser si le fichier des constantes harmoniques nexiste pas ou si lon souhaite gnrer ce fichier. Le
fichier de gomtrie sur lequel le modle local vient interpoler les constantes harmoniques est
renseign par le mot-cl FICHIER DU MODELE DE MAREE ; cest un fichier binaire au format Srafin
qui est le fichier de gomtrie servant au cas-test de TELEMAC-2D dit Onde M2 . En chaque
nud de ce fichier de gomtrie, les constantes harmoniques de mare du modle dit de Jean-Marc
Janin [2] ont t stockes dans le fichier ASCII correspondant au mot-cl BASE DE DONNEES DE
MAREE.
Pour lutilisation de solutions provenant de lOSU (par exemple TPXO), par exemple pour le calcul des
conditions aux limites de mare ou des conditions initiales avec loption ALTIMETRIE SATELLITE
TPXO, les deux mots-cls BASE BINAIRE 1 DE DONNEES DE MAREE et BASE BINAIRE 2 DE
DONNEES DE MAREE sont prciser. Ces fichiers binaires servent pour linterpolation des
constantes harmoniques aux nuds de frontires ouvertes du modle local ou sur lintgralit des
nuds du modle local si ces solutions sont utilises pour le calcul des conditions initiales (hauteur
deau et composantes horizontales de vitesse). La base n1 est cense contenir les constantes
harmoniques de hauteur deau alors que la base n2 est cense contenir les constantes harmoniques
de transport (produit de la hauteur deau par les deux composantes horizontales de vitesse). Attention
bien tlcharger les fichiers au format binaire (et donc pas au format NetCDF), seul format pour ces
bases de constantes harmoniques de lOSU qui peut tre utilis avec la version 6.2 de TELEMAC.
4.1.4. Origine des temps et conditions initiales

Pour la simulation de mares relles , cest--dire la simulation de la mare partir dun jour prcis
du calendrier, la date de dbut de simulation est spcifie par le mot-cl DATE DE L'ORIGINE DES

Version 1.0
TEMPS (au format anne ; mois ; jour, par exemple 2011 ; 10 ; 22 pour le 22 octobre 2011). En
version 6.2, la simulation peut commencer nimporte quelle heure pour les bases provenant de
lOSU ou latlas NEA en prcisant le mot-cl HEURE DE LORIGINE DES TEMPS (valeur par dfaut :
0 ; 0 ; 0). En revanche pour la base JMJ avec la version 6.2, il faut commencer la simulation lheure
0 h UTC ou 12 h UTC, un bug existant pour tout autre choix dheure. Nanmoins, ce bug sera corrig
dans la prochaine version de TELEMAC.
Pour la simulation de mares relles , partir dun jour prcis du calendrier, si les fichiers de bases
binaires de donnes de mare provenant des solutions de lOSU sont renseigns, il y a une nouvelle
option pour initialiser la fois les hauteurs deau et les composantes de vitesse en cohrence avec la
date et lheure de dbut de simulation. Pour cela, il faut utiliser loption ALTIMETRIE SATELLITE
TPXO pour le mot-cl CONDITIONS INITIALES. noter quil est possible dutiliser cette option mme
si lon utilise dautres bases de constantes harmoniques pour le calcul des conditions aux limites de
mare (JMJ ou NEA par exemple).
Remarque : En version 6.2, un bug a t dtect en 3D sur linitialisation des vitesses dans le
cas de loption ALTIMETRIE SATELLITE TPXO ainsi que sur linitialisation des hauteurs deau
dans le cas de bathymtries qui ne sont pas rfrences par rapport au niveau moyen de la
mer en 2D et 3D (en particulier le mot-cl COEFFICIENT DE CALAGE DU NIVEAU DE MER
nest pas pris en compte, ce qui rend incohrent les conditions aux limites et conditions initiales
sur la hauteur deau en cas de rfrence de la bathymtrie par rapport au zro
hydrographique). Ces bugs seront corrigs dans une prochaine version de TELEMAC.
4.1.5. Coordonnes et systme gographique

Le systme de coordonnes gographiques dans lequel le modle numrique a t construit doit tre
prcis par le mot-cl SYSTEME GEOGRAPHIQUE, en particulier lorsque des constantes
harmoniques de mare doivent tre interpoles (ex. : gnration du fichier des constantes
harmoniques ou calcul des conditions initiales avec loption ALTIMETRIE SATELLITE TPXO). Les
cas actuellement prvus sont :
- 1 : systme WGS84 gographique (longitude/latitude en degrs dcimaux) ;
- 2 : systme WGS84 plan UTM nord ;
- 3 : systme WGS84 plan UTM sud ;
- 4 : systme NTF plan ;
- 5 : projection de Mercator (parfois aussi appele Mercator pour TELEMAC ) pour
lutilisation des coordonnes sphriques par exemple. Ne pas oublier de renseigner
alors les mots-cls LONGITUDE DU POINT ORIGINE et LATITUDE DU POINT
ORIGINE.
Lutilisateur a la possibilit de dfinir un systme de coordonnes personnel quil peut coder dans les
sous-programmes BORD_TIDAL_BC, BORD_TIDE_TPXO ou CONDI_TPXO du module TPXO (par
exemple, conversion dans un repre local et rotation dun certain angle par commodit, qui est le cas
de lexemple cod dans les sous-programmes prcdemment cits pour la valeur 0 du mot-cl
SYSTEME GEOGRAPHIQUE). Il est nanmoins conseill de construire le modle numrique dans un
systme de coordonnes standard pour viter des erreurs de conversion lors de transformations de
coordonnes.
Dans le cas de systmes plans (WGS84 UTM ou Lambert), le numro de fuseau (pour WGS84 UTM)
ou la projection plane de type Lambert correspondant(e) doit tre indiqu(e) par le mot-cl NUMERO
DE FUSEAU OU PROJECTION DANS LE SYSTEME GEOGRAPHIQUE en cohrence avec le mot-
cl SYSTEME GEOGRAPHIQUE :
- directement le numro de fuseau pour le systme WGS84 plan UTM entre 1 et 60
(entre 30 et 32 par exemple pour la France dans le systme WGS84 plan UTM nord) ;
- pour le systme NTF plan Lambert :
1 : Lambert 1 nord,

Version 1.0
2 : Lambert 2 centre,
22 : Lambert 2 tendu,
3 : Lambert 3 sud,
4 : Lambert 4 Corse.
La projection Lambert 93 na pas encore t implmente au moment de la rdaction de cette note.
Dans le cas de lutilisation de la projection de Mercator comme systme gographique, les mots-cls
LONGITUDE DU POINT ORIGINE ou LATITUDE DU POINT ORIGINE doivent tre renseigns avec
les coordonnes du point origine de rfrence pour cette projection.
4.1.6. Coefficients de calage de la mare

Le mot-cl COEFFICIENT DE CALAGE DU MARNAGE contient un coefficient multiplicateur du signal
de mare impos en chaque nud de frontire maritime et permet dajuster lamplitude du marnage.
Par dfaut, sa valeur est 1. Son mnmo (nom de variable associ au mot-cl dans TELEMAC et
dclar dans le module DECLARATIONS_TELEMAC2D ou DECLARATIONS_TELEMAC3D) est CTIDE.
Le calage de lamplitude du marnage peut en particulier tre rajust pour chaque type de mares
types simule.
Le mot-cl COEFFICIENT DE CALAGE DES VITESSES DE COURANT contient un coefficient
multiplicateur du signal de la vitesse des ondes de mare impos en chaque nud de frontire
maritime et permet dajuster lamplitude des vitesses de courant. Par dfaut, sa valeur est 999 999, ce
qui signifie que cest la racine carre de la valeur du mot-cl COEFFICIENT DE CALAGE DU
MARNAGE qui est prise, car la vitesse de londe de mare est proportionnelle la racine carre de sa
hauteur, en premire approximation, mais il peut donc tre modifi. Son mnmo est CTIDEV.
Le mot-cl COEFFICIENT DE CALAGE DU NIVEAU DE MER correspond un niveau moyen de la
mer et peut aussi tre fix de manire caler au mieux les niveaux de la mer (par exemple par
rapport un ou des port(s) de rfrence). Ce coefficient est gnralement pris gal au niveau moyen
de la mer dans un port de rfrence proximit du site dtude. Son mnmo est MSL.
4.2. Fichier des conditions aux limites

Il est important de bien vrifier que la dernire colonne du fichier des conditions aux limites (numro
de nud frontire) correspond au numro de la ligne dans le fichier avant partitionnement ventuel.
Ceci est indispensable pour le bon fonctionnement dun calcul en parallle et interdit lutilisation
particulire du tableau BOUNDARY_COLOUR pour les bases JMJ et NEA.
LAnnexe 2 montre un exemple de fichier des conditions aux limites. Afin de pouvoir utiliser le
traitement des conditions aux limites de mare de la version 6.2 de TELEMAC, les nuds de frontire
maritime doivent obligatoirement avoir les codes 5 4 4 (hauteur deau impose et composantes de
vitesse U et V libres), 4 6 6 (composantes de vitesse U et V imposes et hauteur deau libre) ou 5 6 6
(hauteur deau et composantes de vitesse U et V imposes simultanment) dans les trois premires
colonnes du fichier des conditions aux limites (surlignes en jaune dans lAnnexe 2).
4.3. Fichier Fortran

Le fichier Fortran contient tous les sous-programmes modifis par lutilisateur. Dans ce type de
simulations de mare, il peut gnralement contenir le sous-programme TIDAL_MODEL_T2D ou
TIDAL_MODEL_T3D en version 6.2 de TELEMAC dans lequel les paramtres lis la mare sont
renseigns.
4.4. Fichier des constantes harmoniques de mare

Le fichier des constantes harmoniques de mare (indiqu par le mot-cl FICHIER DES

Version 1.0
CONSTANTES HARMONIQUES dans le fichier des paramtres, voir sous-section 4.1), qui est un
fichier de donnes format ASCII, est uniquement utilis pour les bases JMJ et NEA. Ce fichier
contient les constantes harmoniques pour chaque onde de mare considre, en chaque nud de
frontire maritime correspondant un site donn sur lemprise des bases de constantes harmoniques.
Il peut tre gnr par le sous-programme BORD_TIDAL_BC pour la base JMJ ou lextrieur de
TELEMAC avec les outils COMODO [15] pour latlas NEA la rdaction de la prsente note. La
lecture de ce fichier est effectue l'intrieur du sous-programme BORD_TIDE (resp.
BORD_TIDE_LEGOS) pour la simulation de la mare avec la base JMJ (resp. NEA). Deux exemples
de fichiers des constantes harmoniques de mare sont donns en Annexe 3 et 4 (pour les bases JMJ
et NEA). En outre, la cration de ce fichier des constantes harmoniques de mare partir de la base
JMJ est dtaille dans la section 5. Pour latlas NEA, en version 6.2 de TELEMAC, la procdure doit
se faire de manire externe avec les outils COMODO [15] et nest pas dtaille ici. Ce fichier des
constantes harmoniques permet dconomiser de la mmoire (localement, le stockage et la
duplication ventuelle de fichiers en mode parallle, qui peuvent tre trs volumineux, sont ainsi
supprims) ; ne sont alors gardes que les informations minimales ncessaires aux simulations (les
constantes harmoniques de mare aux nuds de frontire maritime du modle numrique). Cette
possibilit na pas t traite pour les solutions provenant de lOSU en version 6.2.
Pour la base JMJ, on dcrit ci-aprs ce fichier des constantes harmoniques de mare.
Les premires lignes comportent le nombre de frontires sur lesquelles on impose la mare puis les
numros locaux des bornes de ces frontires (une ligne comprenant les indices des bornes pour
chaque frontire).
Ensuite, dans le cas du mot-cl OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE
compris entre 1 et 6, pour chaque nud de frontire maritime, il y a un bloc de cinq lignes au format
suivant :
i Zf(i)
AHM2(i) (HM2(i) AUM2(i) (UM2(i) AVM2(i) (VM2(i)
AHS2(i) (HS2(i) AUS2(i) (US2(i) AVS2(i) (VS2(i)
AHN2(i) (HN2(i) AUN2(i) (UN2(i) AVN2(i) (VN2(i)
AHM4(i) (HM4(i) AUM4(i) (UM4(i) AVM4(i) (VM4(i)
avec :
- en premire ligne : i le numro local du nud frontire et Zf(i) la cote du fond (en
m CM) interpole dans le modle de simulation des courants de mare en Manche et
proche Atlantique (modle dit de Jean-Marc Janin [2]) ;
- pour les quatre lignes suivantes : les constantes harmoniques (un type donde, parmi
M2, S2, N2 ou M4, par ligne) avec pour chaque ligne, lamplitude (A) et la phase (()
de chaque type de signal (hauteur deau H en m ou composante horizontale de
vitesse U ou V en m/s).
Dans le cas du mot-cl OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE gal 7, pour
chaque nud de frontire maritime, il y a un bloc de cinq lignes au format suivant :
i Zf(i)
HFXM2(i) HFYM2(i) UFXM2(i) UFYM2(i) VFXM2(i) VFYM2(i)
HFXS2(i) HFYS2(i) UFXS2(i) UFYS2(i) VFXS2(i) VFYS2(i)
HFXN2(i) HFYN2(i) UFXN2(i) UFYN2(i) VFXN2(i) VFYN2(i)
HFXM4(i) HFYM4(i) UFXM4(i) UFYM4(i) VFXM4(i) VFYM4(i)
avec :
- en premire ligne : i le numro local du nud frontire et Zf(i) la cote du fond (en m

Version 1.0
CM) interpole dans le modle de simulation des courants de mare en Manche et

proche Atlantique (modle dit de Jean-Marc Janin [2]) ;
- pour les quatre lignes suivantes : les constantes harmoniques (un type donde, parmi
M2, S2, N2 ou M4, par ligne) avec pour chaque ligne, les projections selon x et y (FX
et FY) de la composante de chaque type de signal (hauteur deau H en m ou
composante horizontale de vitesse U ou V en m/s).
Pour latlas NEA, on dcrit ci-aprs ce fichier des constantes harmoniques de mare.
Les premires lignes comportent le nombre de frontires sur lesquelles on impose la mare puis les
numros locaux des bornes de ces frontires (une ligne comprenant les indices des bornes pour
chaque frontire) et enfin sur une mme ligne le nombre de nuds de frontire maritime, le nombre
dondes disponibles dans le fichier et lunit utilise (M pour mtre).
Ensuite, pour chaque onde, il y a un bloc de NPTFRL+1 lignes o NPTFRL est le nombre de nuds de
frontire au format suivant :
Nom de londe
LON(1) LAT(1) AH(1) (H(1) AU(1) (U(1) AV(1) (V(1)

LON(N) LAT(N) AH(N) (H(N) AU(N) (U(N) AV(N) (V(N)
avec :
- en premire ligne le nom de londe (quatre caractres maximum) ;
- pour chaque ligne (NPTFRL lignes, une pour chaque numro local de nud
frontire) : la longitude (LON) et la latitude (LAT) du nud frontire, les constantes
harmoniques en amplitude (A) et phase (() de chaque type de signal (hauteur deau
H en m ou composante horizontale de vitesse U ou V en m/s).
5. Mode opratoire pour gnrer le fichier des

constantes harmoniques de mare
Rappel : cette section ne concerne que lutilisation de la base de constantes harmoniques du
modle dit de Jean-Marc Janin (JMJ). Comme dit en sous-section 4.4, la gnration du fichier
des constantes harmoniques de mare avec latlas NEA ne peut se faire qu lextrieur de
TELEMAC avec les outils COMODO [15] en version 6.2.
Avant deffectuer des simulations de propagation de la mare dans un domaine avec la base JMJ, il
est tout dabord ncessaire de gnrer le fichier des constantes harmoniques de mare. Comme dj
dit en sous-section 4.1, la gnration du fichier des constantes harmoniques de mare nest possible
quen mode squentiel en version 6.2 (mot-cl PROCESSEURS PARALLELES = 0).
Le fichier des constantes harmoniques de mare est gnr partir dun calcul TELEMAC ayant pour
donnes dentre les fichiers de gomtrie et de conditions aux limites du modle numrique sur
lequel on souhaite modliser la mare, ainsi que le fichier de gomtrie et une base de donnes de
constantes harmoniques associe pour un domaine de plus grande emprise (ici le modle de la
Manche et du proche Atlantique [2], voir la sous-section 4.1 pour les mots-cls employs). Ces
dernires donnes sont interpoles sur les nuds de frontire maritime. La gnration du fichier des
constantes harmoniques de mare seffectue lors dune courte simulation TELEMAC, qui permet de
lire la base de donnes de constantes harmoniques de Jean-Marc Janin et dinterpoler ces
informations sur les nuds de la frontire maritime du domaine modliser (interpolation de type
lments finis). Le fichier format de constantes harmoniques est ainsi cr (il se peut que la
simulation finisse par une erreur, ce qui nest pas rdhibitoire, limportant est quelle gnre ce fichier
format).

Version 1.0
Comme dit en sous-section 4.2, afin de pouvoir utiliser le traitement des conditions aux limites de
mare de la version 6.2 de TELEMAC, les nuds de frontire maritime doivent obligatoirement avoir
les codes 5 4 4 (hauteur deau impose et composantes de vitesse U et V libres), 4 6 6 (composantes
de vitesse U et V imposes et hauteur deau libre) ou 5 6 6 (hauteur deau et composantes de vitesse
U et V imposes simultanment) dans les trois premires colonnes du fichier des conditions aux
limites.
Quelques paramtres du sous-programme TIDAL_MODEL_T2D en 2D ou TIDAL_MODEL_T3D en 3D

sont renseigner lors de la gnration du fichier des constantes harmoniques aux nuds de frontire
maritime (ils sont surligns en cyan, ou vert dans le cas de la variable TIDALBCGEN en Annexe 1) :
- TIDALBCGEN (logique mis alors .TRUE. vrai) ;
- XSHIFT et YSHIFT ventuellement en cas de dcalage de translation entre le modle
local et le modle qui sert interpoler ;
- BETA (resp. BETA0) ventuellement en cas de dcalage en angle entre le modle
local et le modle qui sert interpoler en 2D (resp. en 3D).
Si, lors du droulement du calcul TELEMAC, la mention ERROR WHEN INTERPOLATION, K=

apparat, cest quun ou plusieurs nuds de frontire maritime se trouve(nt) en dehors de lemprise du
modle de la base de donnes. Il peut sagir parfois dune erreur de conversion de coordonnes ou
souvent dun lger dcalage du fait que le trait de cte du modle ayant servi construire la base est
assez grossier (dcalage ventuel entre le trait de cte grossier du modle dit de Jean-Marc Janin [2]
et le modle local). Dans ce cas, il est recommand de dterminer une petite translation imposer
aux coordonnes des nuds de frontire, ce qui peut tre fait avec les paramtres XSHIFT et
YSHIFT du sous-programme TIDAL_MODEL_T2D en 2D ou TIDAL_MODEL_T3D en 3D. Le dcalage
peut tre visualis en dcommentant les lignes comportant le nombre 57 (trois au total) dans le sous-
programme BORD_TIDAL_BC, ce qui permet de gnrer un fichier format de coordonnes dans le
systme de coordonnes du modle de la Manche et du proche Atlantique et que lon peut visualiser
en superposition du fichier de gomtrie de ce dernier modle. Sur la Figure 4 sont reprsents en
trait continu noir (resp. en pointills rouges, en pointills bleus) le trait de cte du modle dit de Jean-
Marc Janin (resp. les nuds de frontire du modle local sans changements, les nuds de frontire
du modle local aprs translation du vecteur (XSHIFT, YSHIFT)).
Si lon neffectue pas de translation malgr le (ou les) message(s) davertissement, cest partir de
llment le plus proche que se fait linterpolation.

Version 1.0
YSHIFT
XSHIFT
Figure 4 : Application du vecteur de translation (XSHIFT-YSHIFT) sur un exemple.

Si le modle numrique local est tourn par rapport celui du modle dit de Jean-Marc Janin
(construit en projection de Mercator), langle BETA (resp. BETA0) dans le sous-programme
TIDAL_MODEL_T2D (resp. TIDAL_MODEL_T3D) peut tre ajust afin de tenir compte de cette
rotation. La Figure 5 montre lemprise du modle numrique du cas test fourni avec TELEMAC-2D et
TELEMAC-3D en version 6.2. Dans le systme WGS84 longitude/latitude, les deux cts gauche et
droit suivent deux mridiens, alors que le ct suprieur suit un parallle. Dans la projection Lambert
utilise, on constate une rotation entre les deux directions nord (de la projection Lambert et du
systme WGS84) dun angle BETA. Cest cet angle quil faut reporter dans les sous-programmes
TIDAL_MODEL_T2D et TIDAL_MODEL_T3D.
BETA
Figure 5 : Exemple de modle numrique local tourn par rapport celui du modle
dit de Jean-Marc Janin [2].

Version 1.0
la fin, on obtient ainsi un fichier contenant les constantes harmoniques de la hauteur deau et des
composantes horizontales de vitesse U et V (amplitude et phase, ou projection suivant x et y, suivant
le type de mare simuler) pour chaque type donde (M2, S2, N2 ou M4), pour chaque nud de
frontire maritime du domaine (voir une courte description du fichier dans la sous-section 4.4 ou en
Annexe 3).
Afin de ne pas multiplier les fichiers de constantes harmoniques lors de lutilisation de la base JMJ et
de ne pas se tromper dans lutilisation de ces fichiers, il est conseill de ne gnrer et de nutiliser que
des fichiers de constantes harmoniques au format (amplitude, phase) et non pas au format
projections suivant x et y (qui tait le format utilis prcdemment lors de la simulation de mares
relles au LNHE) ; il est donc prfrable de choisir le mot-cl OPTION POUR LES CONDITIONS
LIMITES DE MAREE compris entre 1 et 6.
6. Simulation de la mare en version 6.2

Une fois que le fichier des constantes harmoniques a t gnr (pour les bases JMJ ou NEA) ou
directement pour les solutions provenant de lOSU, lutilisateur peut lancer un calcul de simulation de
la mare. Le mot-cl OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE doit tre choisi
entre 1 et 7 (voir sous-section 4.1) :
- 1 : mare relle , partir dun jour prcis du calendrier (mthodologie
recommande) ;
- 2 : mare de vive-eau exceptionnelle (coefficient de mare !))&$!*
- 3 : mare de vive-eau moyenne (coefficient de mare !"#$!*
- 4 : mare moyenne (coefficient de mare !%&$!*
- 5 : mare de morte-eau moyenne (coefficient de mare !'#$!*
- 6 : mare de morte-eau exceptionnelle (coefficient de mare !(&$!*
- 7 : mare relle (mthodologie davant 2010 au LNHE).
En version 6.2, les choix 2 7 ne sont possibles quavec la base de constantes harmoniques JMJ.
Ces simulations peuvent tre effectues en modes squentiel ou parallle (mot-cl PROCESSEURS
PARALLELES).
Comme dit en sous-section 4.2, afin de pouvoir utiliser le traitement des conditions aux limites de
mare de la version 6.2 de TELEMAC, les nuds de frontire maritime doivent obligatoirement avoir
les codes 5 4 4 (hauteur deau impose et composantes de vitesse U et V libres), 4 6 6 (composantes
de vitesse U et V imposes et hauteur deau libre) ou 5 6 6 (hauteur deau et composantes de vitesse
U et V imposes simultanment) dans les trois premires colonnes du fichier des conditions aux
limites.
Quelques paramtres du sous-programme TIDAL_MODEL_T2D en 2D ou TIDAL_MODEL_T3D en 3D
sont renseigner lors du calcul des conditions aux limites aux nuds de frontire maritime (ils sont
surligns en jaune en Annexe 1) :
- NODALCORR (uniquement pour la simulation de mares relles , partir dun jour
prcis du calendrier, et seulement pour les bases JMJ et NEA) ;
- ICALHW ( changer ventuellement, uniquement pour la simulation de mares
types) ;
- TM2S2N2EQUAL ( changer ventuellement, uniquement pour la simulation de
mares types).
Le paramtre NODALCORR est un entier qui indique comment sont calculs les facteurs nodaux fi(t)
pour la simulation de mares relles (uniquement pour les bases JMJ et NEA ; pour les solutions
provenant de lOSU, les facteurs nodaux sont calculs chaque pas de temps obligatoirement) :
- 0 : calcul chaque pas de temps (possible depuis la version 6.2 de TELEMAC) ;

Version 1.0
- 1 (valeur par dfaut) : calcul linstant de lorigine des temps de la simulation et

gards constants pendant toute la simulation ;
- 2 : calcul au milieu de lanne de lorigine des temps de la simulation (voir sous-
section 2.4) et gards constants pendant toute la simulation ;
Nanmoins, sur une courte dure de simulation, ces facteurs ne varient pas trop (la diffrence relative
des corrections reste au pire infrieure 2,5 % sur une anne complte, donc est bien moindre sur
une priode plus courte comme quelques jours).
Les mots-cls DATE DE L'ORIGINE DES TEMPS et HEURE DE L'ORIGINE DES TEMPS sont
renseigner pour la simulation de mares relles , partir du jour prcis du calendrier (voir sous-
section 4.1 et en particulier la mise en garde si lon utilise la base JMJ).
Le paramtre spcifique ICALHW donne lindice de nud de frontire maritime par rapport auquel
toutes les ondes sont dphases pour tous les nuds de frontire maritime ; il est aussi appel nud
de rfrence pour le dphasage des ondes. Ce dphasage permet de dbuter la simulation aux
environs dune pleine mer. Il est dcrit dans la sous-sous-section 3.3.1. Il est uniquement utilis dans
le cas de la simulation de mares types et donc de la base JMJ en version 6.2.
Le paramtre spcifique TM2S2N2EQUAL indique si les priodes des ondes M2, S2 et N2 sont prises
gales ou non pour la simulation de mares types uniquement (et uniquement pour la base JMJ donc
en version 6.2). La priode de londe M4 est toujours prise moiti moindre que celle de londe M2.
Ceci permet davoir un signal de mare priodique de priode TM2 (cf. sous-sous-section 7.2.1 de
[2]).
Remarque :
Afin de caler les modles numriques TELEMAC dans des zones o la mare a une influence,
certaines donnes peuvent tre utiles :
- des donnes de marnage, de niveau moyen de la mer ou de niveaux de la mer des
instants prcis de la mare dans un port de rfrence proximit du site dtude (par
exemple partir de donnes de margraphes, de cartes marines ou de bases de
donnes du SHOM disponibles sur leur site internet [16]) ;
- des vitesses de courants de mare en plusieurs points de la zone dtude (par
exemple partir de mesures ralises avec des ADCP, des annuaires de courant de
mare du SHOM [16] ou des indications sur les cartouches de certaines cartes marines
dites par le SHOM).
7. Quelques erreurs ne pas commettre

Pour la gnration du fichier des constantes harmoniques de mare :
- les nuds de la frontire sur lesquels on souhaite imposer des conditions de mare doivent
avoir le code 5 4 4 i. e. hauteur deau impose et vitesses libres , 4 6 6 i. e. hauteur deau
libre et vitesses imposes ou 5 6 6 i. e. hauteur deau et vitesses imposes , si lon
souhaite utiliser le traitement quasi automatique de la mare dans TELEMAC ;
- si le systme gographique choisi est de type WGS84 UTM (nord ou sud) ou Lambert, il faut
prciser le numro du fuseau ou la projection en adquation.
Pour les simulations de mares :
- bien vrifier que la dernire colonne du fichier des conditions aux limites (numro de nud
frontire) correspond au numro de la ligne dans le fichier si lon utilise les bases JMJ et NEA.
Ceci est indispensable pour le bon fonctionnement dun calcul en parallle ;
- le nom du fichier des constantes harmoniques de mare doit tre indiqu par mot-cl
(FICHIER DES CONSTANTES HARMONIQUES) dans le fichier des paramtres (pour les
bases JMJ et NEA) ;
- il est ncessaire de vrifier que ce fichier des constantes harmoniques a bien t gnr par

Version 1.0
la procdure automatique de mare pour la base JMJ (en particulier que les premires lignes
comprennent le nombre des frontires o lon impose des conditions de mares, ainsi que les
indices des bornes de ces frontires) ou est au bon format pour latlas NEA ;
- si le modle a subi une transformation locale (par exemple, une rotation), bien appliquer cette
transformation aux composantes de vitesse ;
- il est important de garder des formats homognes entre ltape de gnration du fichier des
constantes harmoniques de mare et ltape de calcul qui utilise ce fichier pour la base JMJ.
En particulier, il faut sassurer que pour des mares de type i i compris entre 1 et 6 les
constantes harmoniques sont dans le format amplitude-phase (et pas projection selon x et y),
et que pour des mares relles de type 7, les constantes harmoniques sont dans le format
de projection selon x et y (et pas amplitude-phase). Pour viter de manipuler deux fichiers de
constantes harmoniques crits diffremment et de commettre dventuelles erreurs, si lon
souhaite simuler des mares relles , il est donc recommand de choisir le type 1.
8. Mots-cls et fichiers pour lutilisation des diffrentes

bases de constantes harmoniques
Dans cette section est synthtise la liste des mots-cls et fichiers, indispensables ou utiles,
renseigner pour lutilisation des dveloppements autour des bases de constantes harmoniques pour la
modlisation de la mare dans TELEMAC. Il est nanmoins conseill au lecteur de lire lensemble de
la prsente note pour plus de dtails dutilisation notamment.
8.1. Toute base de constantes harmoniques de mare

2 mots-cls indispensables :
- OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE ;
- BASE DE DONNEES DE MAREE.
En cas de simulation de mares relles , partir dun jour prcis du calendrier (indispensable) :
- DATE DE L'ORIGINE DES TEMPS ;
- HEURE DE L'ORIGINE DES TEMPS.
3 coefficients de calage (utiles pour le calage) :
- COEFFICIENT DE CALAGE DU MARNAGE ;
- COEFFICIENT DE CALAGE DES VITESSES DE COURANT ;
- COEFFICIENT DE CALAGE DU NIVEAU DE MER.
Si CONDITIONS INITIALES = ALTIMETRIE SATELLITE TPXO, entre 3 et 5 mots-cls
supplmentaires indispensables :
- SYSTEME GEOGRAPHIQUE :
o si SYSTEME GEOGRAPHIQUE = 2, 3 ou 4, prciser alors NUMERO DE FUSEAU
OU PROJECTION DANS LE SYSTEME GEOGRAPHIQUE,
o si SYSTEME GEOGRAPHIQUE = 5, prciser alors LATITUDE DU POINT ORIGINE
et LONGITUDE DU POINT ORIGINE.

Version 1.0
8.2. Solutions provenant de lOSU

Entre 3 et 5 mots-cls indispensables :
et LONGITUDE DU POINT ORIGINE.
Pour lutilisateur avanc :
- INTERPOLATION DE COMPOSANTES MINEURES (par dfaut = NON).
8.3. Base JMJ

1 mot-cl indispensable :
- FICHIER DES CONSTANTES HARMONIQUES.
Pour la phase de gnration du fichier des constantes harmoniques, entre 3 et 5 mots-cls
indispensables :
- BASE ASCII DE DONNEES DE MAREE (fichier bdd_jmj) ;
- FICHIER DU MODELE DE MAREE (fichier geofin) ;
et LONGITUDE DU POINT ORIGINE ;
- ainsi que le paramtre TIDALBCGEN mis .TRUE. dans le sous-programme
TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D :
o si besoin de recalage en translation ou rotation, 3 paramtres utiles : XSHIFT,
YSHIFT, BETA (en 2D) ou BETA0 (en 3D) dans le sous-programme
TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D.
Pour le calcul des conditions aux limites aux nuds de frontire maritime, quelques paramtres
modifier ventuellement dans le sous-programme TIDAL_MODEL_T2D ou TIDAL_MODEL_T3D :
- pour la simulation de mares relles , partir dun jour prcis du calendrier : NODALCORR
(0, 1 ou 2) ;
- pour la simulation de mares types, 2 paramtres utiles : ICALHW ou TM2S2N2EQUAL.
8.4. Atlas NEA

1 mot-cl indispensable :
- FICHIER DES CONSTANTES HARMONIQUES.
1 paramtre modifier ventuellement dans le sous-programme TIDAL_MODEL_T2D ou
TIDAL_MODEL_T3D :
- pour la simulation de mares relles , partir dun jour prcis du calendrier : NODALCORR

Version 1.0
(0 ou 1).
9. Conclusion et perspectives
Un travail de comparaison dutilisation de ces diffrentes bases de constantes harmoniques pour le
calcul des conditions aux limites ouvertes a t ralis avec TELEMAC-2D en version 6.2 [18]. Les
rsultats de hauteur deau et de vitesses sont donns pour un mme domaine dtude pour les trois
bases de donnes. Lutilisation de latlas NEA ou de la solution locale European Shelf de lOSU
comme base de constantes harmoniques amliore grandement les rsultats, en particulier pour les
vitesses de courant, par rapport lutilisation de la base JMJ.
Pour la version 6.3, la prise en compte correcte de lheure de lorigine des temps avec la base JMJ
(en dehors de 0 h et 12 h UTC), le traitement plus correct des conditions initiales partir des solutions
de lOSU (en 3D et pour des bathymtries non rfrences par rapport au niveau moyen de la mer),
linterpolateur optimiser, en parallle notamment, la possibilit de traiter des modles en
coordonnes Lambert 93, sont regarder. Une rflexion pourrait tre porte sur la possibilit de
gnrer le fichier des constantes harmoniques en mode parallle (dveloppement dans le programme
partel ?) pour les bases JMJ et NEA. La possibilit dutiliser le modle mondial FES2004 14 ondes
(juste pour les cotes) ou FES2012 voire FES2013 ( la fois pour les cotes et les vitesses horizontales)
[18] sera regarde. Certains dveloppements seront intgrs en version 6.3.
10. Rfrences
[1] Pham C.-T. (2012). Mthodologie pour la simulation de la mare en Manche et proche
Atlantique avec TELEMAC-2D. Rapport EDF R&D-LNHE H-P74-2011-02581-FR.
[2] Janin, J.-M., Blanchard, X. (1992). Simulation des courants de mare en Manche et proche
Atlantique Rapport final. Rapport EDF R&D-LNH HE-42/92.58 (rfrence Eureka H-E40-
1992-02916-FR).
[3] Schureman P. (1924, rdition 1971). Manual of harmonic analysis and prediction of tides.
U.S. Coast and Geodetic Survey.
[4] Pairaud I. L., Lyard, F., Auclair, F., Letellier, T., Marsaleix, P. (2008). Dynamics of the semi-
diurnal and quarter-diurnal internal tides in the Bay of Biscay. Part 1: Barotropic tides.
Continental Shelf Research vol. 28 (1011), pp. 12941315.
[5] Pairaud, I. L., Auclair, F., Marsaleix, P., Lyard, F., Pichon, A. (2010). Dynamics of the semi-
diurnal and quarter-diurnal internal tides in the Bay of Biscay. Part 2: Baroclinic tides.
Continental Shelf Research vol. 30 (3-4), pp. 253269.
[6] http://sirocco.omp.obs-mip.fr/outils/Tugo/Produits/TugoProduits.htm
[7] http://www.legos.obs-mip.fr/recherches/equipes/ecola/outils-produits
[8] sirocco@aero.obs-mip.fr
[9] http://volkov.oce.orst.edu/tides
[10] Simon, B. (2007). La mare ocanique ctire. Institut ocanographique diteur.
[11] Pugh, D. T. (1987, rdition 1996). Tides, Surges and Mean Sea-Level. John Wiley & Sons.
[12] Service de godsie et nivellement de lIGN (1995). Projection cartographique Mercator
Transverse. Algorithmes. Note technique NT/G 76. Disponible sur le site internet de lIGN :
http://geodesie.ign.fr/contenu/fichiers/documentation/algorithmes/notice/NTG_76.pdf
[13] Service de godsie et nivellement de lIGN (1995). Projection cartographique conique
conforme de Lambert. Algorithmes. Note technique NT/G 71. Disponible sur le site internet de
lIGN : http://geodesie.ign.fr/contenu/fichiers/documentation/algorithmes/notice/NTG_71.pdf
[14] Service de godsie et nivellement de lIGN (1995). Changement de systme godsique.
Algorithmes. Note technique NT/G 80. Disponible sur le site internet de lIGN :

Version 1.0
http://geodesie.ign.fr/contenu/fichiers/documentation/algorithmes/notice/NTG_80.pdf
[15] http://www.legos.obs-mip.fr/recherches/equipes/ecola/outils-produits/comodo-tools
[16] Site internet du SHOM : http://www.shom.fr
[17] Pham, C.-T., Lyard, F. (2012). Use of tidal harmonic constants databases to force open
boundary conditions in TELEMAC. 19th TELEMAC-MASCARET User Conference
Proceedings, Oxford, UK.
[18] http://www.legos.obs-mip.fr/recherches/equipes/ecola/projets/fes2012

Version 1.0
ANNEXE 1: EXEMPLES DE SOUS-PROGRAMMES

TIDAL_MODEL_T2D ET TIDAL_MODEL_T3D POUR UNE
SIMULATION DE LA MAREE AVEC TELEMAC EN VERSION 6.2
! **************************
SUBROUTINE TIDAL_MODEL_T2D
! **************************
!
!
!***********************************************************************
! TELEMAC2D V6P2 28/10/2010
!***********************************************************************
!
!brief FINDS TIDAL BOUNDARY CONDITIONS AT THE OPEN SEA BOUNDARIES
!+
!
!history C-T PHAM (LNHE)
!+ 30/05/2011
!+ V6P1
!+
!
!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
!| |-->|
!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
!
USE BIEF
USE DECLARATIONS_TELEMAC
USE DECLARATIONS_TELEMAC2D
USE INTERFACE_TELEMAC2D
USE TPXO
!
IMPLICIT NONE
INTEGER LNG,LU
COMMON/INFO/LNG,LU
!
!+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
!
!
!+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
!
INTEGER K,NODALCORR,ICALHW
DOUBLE PRECISION XSHIFT,YSHIFT,BETA
LOGICAL TIDALBCGEN,TM2S2N2EQUAL
!
!-----------------------------------------------------------------------
!
! PARAMETERS FOR TIDAL BOUNDARY CONDITIONS
!
! CTIDEV: COEFFICIENT TO CALIBRATE THE VELOCITIES
! DEFAULT = SQRT(CTIDE)
!
! ACCORDING TO DV, IF A CORRECTION COEFFICIENT CTIDE IS APPLIED
! FOR WATER DEPTHS, ANOTHER ONE MUST BE APPLIED FOR VELOCITIES
! = SQRT(CTIDE)
!
IF(CTIDEV.EQ.999999.D0) CTIDEV = SQRT(CTIDE)
!

Version 1.0
! NODALCORR: OPTION FOR CALCULATION OF NODAL FACTOR CORRECTION F

! IN SUBROUTINES BORD_TIDE AND BORD_TIDE_LEGOS
! DEFAULT = 1 (FROZEN AT THE DATE MARDAT + HOUR MARTIM +
TEMPS)
! 0: NOT FROZEN, COMPUTED AT EACH TIME STEP
! 1: FROZEN WITH VALUE AT THE BEGINNING OF THE SIMULATION
! 2: FROZEN WITH VALUE AT THE MIDDLE OF THE YEAR IN MARDAT
! (SINGLE FORMER POSSIBILITY FOR TIDALTYPE = 7)
! IN THE STEERING FILE, THE KEYWORDS 'ORIGINAL DATE OF TIME'
! AND 'ORIGINAL HOUR OF TIME' HAVE TO BE SET
! WARNING, FORMAT: YEAR, MONTH, DAY
!
NODALCORR = 1
!
! TIDALBCGEN: LOGICAL FOR GENERATION OF TIDAL BOUNDARY CONDITIONS OR
NOT
! CURRENTLY WORKS ONLY FOR SCALAR COMPUTATIONS
! FOR JMJ DATA BASE ONLY AT THE MOMENT
!
TIDALBCGEN = .FALSE.
!
! ICALHW: NUMBER THAT MAY BE CHOSEN BY THE USER TO CALIBRATE HIGH WATER
! OR AUTOMATICALLY CHOSEN, WHEN MODELLING A SCHEMATIC TIDE
! IN SUBROUTINE BORD_TIDE
! DEFAULT = 0 (AUTOMATICALLY CHOSEN)
!
ICALHW = 0
!
! TM2S2N2EQUAL: LOGICAL TO IMPOSE THE PERIODS OF S2 AND N2 WAVES
! TO BE EQUAL TO THE PERIOD OF M2 WAVE
! DEFAULT = .FALSE.
! FOR SCHEMATIC TIDES MODELLING ONLY!
!
TM2S2N2EQUAL = .FALSE.
!
! OPTIONAL SHIFT OF COORDINATES
!
XSHIFT = 0.D0
YSHIFT = 0.D0
!
! BETA: OPTIONAL ANGLE (IN DEGREES) BETWEEN LAMBERT AND MERCATOR-JMJ
! REFERENCES (EAST OR X AXES, TRIGONOMETRIC)
! DEFAULT = 0.D0 DEGREES
!
BETA = 0.D0
!
! FILES:
!
! T2DBDD: TIDE DATA BASE
! T2DHAR: HARMONIC CONSTANTS FILE
! T2DTID: TIDAL MODEL FILE
!
!-----------------------------------------------------------------------
!

Version 1.0
! AUTOMATIC TIDAL BOUNDARY CONDITIONS

!
IF(TIDALDB.EQ.1) THEN
IF(TIDALBCGEN) THEN
IF(T2D_FILES(T2DBDD)%NAME(1:1).EQ.' ') THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'POUR GENERER LE FICHIER DES CONSTANTES'
WRITE(LU,*) 'HARMONIQUES POUR LA BASE DE DONNEES DE JMJ,'
WRITE(LU,*) 'DONNER LE FICHIER'
WRITE(LU,*) 'BASE ASCII DE DONNEES DE MAREE.'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'TO GENERATE THE HARMONIC CONTANTS FILE'
WRITE(LU,*) 'FOR JMJ DATA BASE, PLEASE GIVE'
WRITE(LU,*) 'ASCII DATABASE FOR TIDE FILE.'
ENDIF
CALL PLANTE(1)
STOP
ENDIF
IF(T2D_FILES(T2DTID)%NAME(1:1).EQ.' ') THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'DONNER LE FICHIER DU MODELE DE MAREE.'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'THE TIDAL MODEL FILE'
ENDIF
CALL PLANTE(1)
STOP
ENDIF
IF(T2D_FILES(T2DHAR)%NAME(1:1).EQ.' ') THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'DONNER LE FICHIER DES CONSTANTES HARMONIQUES'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'PLEASE GIVE THE HARMONIC CONTANTS FILE.'
ENDIF
CALL PLANTE(1)
STOP
ENDIF
CALL BORD_TIDAL_BC(MESH%NBOR%I,LIHBOR%I,LIUBOR%I,
& NPTFR,KENT,KENTU,
& MESH,GEOSYST,NUMZONE,LAMBD0,PHI0,
& TIDALTYPE,BOUNDARY_COLOUR,MAXFRO,
& T2D_FILES(T2DBDD)%LU,
& T2D_FILES(T2DTID)%LU,
& T2D_FILES(T2DHAR)%LU,XSHIFT,YSHIFT,BETA)
ENDIF
!
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'DONNER LE FICHIER DES CONSTANTES HARMONIQUES.'
ENDIF
IF(LNG.EQ.2) THEN

Version 1.0
ENDIF
CALL PLANTE(1)
STOP
ENDIF
CALL BORD_TIDE(ZF%R,MESH%NBOR%I,LIHBOR%I,LIUBOR%I,
& NPOIN,NPTFR,AT,DT,NCOTE,NVITES,
& NUMLIQ%I,KENT,KENTU,
& T2D_FILES(T2DIMP)%NAME,TIDALTYPE,
& CTIDE,MSL,CTIDEV,NODALCORR,T2D_FILES(T2DHAR)%LU,
& BOUNDARY_COLOUR,
& HBTIDE,UBTIDE,VBTIDE,NUMTIDE,ICALHW,
& MARDAT,MARTIM,TM2S2N2EQUAL)
ELSEIF(TIDALDB.EQ.2) THEN
CALL BORD_TIDE_TPXO(ZF%R,MESH%NBOR%I,LIHBOR%I,LIUBOR%I,
& NPOIN,NPTFR,AT,NCOTE,NVITES,
& NUMLIQ%I,KENT,KENTU,MESH,
& CTIDE,MSL,CTIDEV,NODALCORR,
& BOUNDARY_COLOUR,
& MARDAT,MARTIM,T2D_FILES,T2DBB1,T2DBB2,
& X,Y,GEOSYST,NUMZONE,LAMBD0,PHI0,INTMICON)
IF(LNG.EQ.1) THEN
ENDIF
IF(LNG.EQ.2) THEN
ENDIF
CALL PLANTE(1)
STOP
ENDIF
CALL BORD_TIDE_LEGOS(ZF%R,MESH%NBOR%I,LIHBOR%I,LIUBOR%I,
& NPOIN,NPTFR,AT,DT,NCOTE,NVITES,
& T2D_FILES(T2DHAR)%LU,BOUNDARY_COLOUR,
& MARDAT,MARTIM)
ELSEIF(TIDALDB.EQ.-1) THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'VALEUR PAR DEFAUT INCORRECTE POUR LA BASE'
WRITE(LU,*) 'DE DONNEES DE MAREE. CHOIX POSSIBLES :'
WRITE(LU,*) ' -1 : JMJ ;'
WRITE(LU,*) ' -2 : TPXO ;'
WRITE(LU,*) ' -3 : LEGOS-NEA.'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'INCORRECT DEFAULT VALUE FOR TIDAL DATA BASE.'
WRITE(LU,*) 'POSSIBLE CHOICES:'
WRITE(LU,*) ' -1: JMJ,'
WRITE(LU,*) ' -2: TPXO,'
WRITE(LU,*) ' -3: LEGOS-NEA.'
ENDIF
CALL PLANTE(1)
STOP

Version 1.0
ELSE
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'BASE DE DONNEES DE MAREE NON TRAITEE.'
WRITE(LU,*) 'CHOIX POSSIBLES :'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'TIDAL DATA BASE NOT TAKEN INTO ACCOUNT.'
ENDIF
CALL PLANTE(1)
STOP
ENDIF
!
!-----------------------------------------------------------------------
!
DO K=1,NPTFR
IF(NUMTIDE%I(K).GT.0) THEN
! POSSIBLE SMOOTHING AT THE BEGINNING
! IF(AT.LT.1800.D0) THEN Multiplication de la
! UBTIDE%R(K) = UBTIDE%R(K)*(AT/1800.D0) vitesse de la mare
! VBTIDE%R(K) = VBTIDE%R(K)*(AT/1800.D0) par une ventuelle
! ENDIF fonction rampe
Projection
IF(LIUBOR%I(K).EQ.KENTU) THEN
! UBOR%R(K) = UBTIDE%R(K)*COS(ALF) + VBTIDE%R(K)*SIN(ALF) ventuelle
! VBOR%R(K) = -VBTIDE%R(K)*SIN(ALF) + VBTIDE%R(K)*COS(ALF) de la vitesse
UBOR%R(K) = UBTIDE%R(K) sur les axes
VBOR%R(K) = VBTIDE%R(K) du repre
U%R(MESH%NBOR%I(K)) = UBOR%R(K) local
V%R(MESH%NBOR%I(K)) = VBOR%R(K)
ENDIF
IF(LIHBOR%I(K).EQ.KENT) THEN
HBOR%R(K) = HBTIDE%R(K)
H%R(MESH%NBOR%I(K)) = HBOR%R(K)
ENDIF
ENDIF
ENDDO
!
!-----------------------------------------------------------------------
!
RETURN
END
! **************************
SUBROUTINE TIDAL_MODEL_T3D
! **************************
!
!
!***********************************************************************
! TELEMAC3D V6P2 27/09/2011
!***********************************************************************
!
!brief FINDS TIDAL BOUNDARY CONDITIONS AT THE OPEN SEA BOUNDARIES

Version 1.0
!+
!
!history C-T PHAM (LNHE)
!+ 27/09/2011
!+ V6P2
!+
!
!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
!| |-->|
!~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
!
USE BIEF
USE DECLARATIONS_TELEMAC
USE DECLARATIONS_TELEMAC3D
USE INTERFACE_TELEMAC2D
USE TPXO
!
IMPLICIT NONE
INTEGER LNG,LU
COMMON/INFO/LNG,LU
!
!+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
!
!
!+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
!
INTEGER K,NODALCORR,ICALHW,NP,IBORD
DOUBLE PRECISION XSHIFT,YSHIFT,BETA0
LOGICAL TIDALBCGEN,TM2S2N2EQUAL
!
!-----------------------------------------------------------------------
!
! PARAMETERS FOR TIDAL BOUNDARY CONDITIONS
!
! CTIDEV: COEFFICIENT TO CALIBRATE THE VELOCITIES
! DEFAULT = SQRT(CTIDE)
!
! ACCORDING TO DV, IF A CORRECTION COEFFICIENT CTIDE IS APPLIED
! FOR WATER DEPTHS, ANOTHER ONE MUST BE APPLIED FOR VELOCITIES
! = SQRT(CTIDE)
!
IF(CTIDEV.EQ.999999.D0) CTIDEV = SQRT(CTIDE)
!
! NODALCORR: OPTION FOR CALCULATION OF NODAL FACTOR CORRECTION F
! IN SUBROUTINES BORD_TIDE AND BORD_TIDE_LEGOS
! DEFAULT = 1 (FROZEN AT THE DATE MARDAT + HOUR MARTIM +
TEMPS)
! 0: NOT FROZEN, COMPUTED AT EACH TIME STEP
! 1: FROZEN WITH VALUE AT THE BEGINNING OF THE SIMULATION
! 2: FROZEN WITH VALUE AT THE MIDDLE OF THE YEAR IN MARDAT
! (SINGLE FORMER POSSIBILITY FOR TIDALTYPE = 7)
! IN THE STEERING FILE, THE KEYWORDS 'ORIGINAL DATE OF TIME'
! AND 'ORIGINAL HOUR OF TIME' HAVE TO BE SET
! WARNING, FORMAT: YEAR, MONTH, DAY
!
NODALCORR = 1
!

Version 1.0
! TIDALBCGEN: LOGICAL FOR GENERATION OF TIDAL BOUNDARY CONDITIONS OR

NOT
! CURRENTLY WORKS ONLY FOR SCALAR COMPUTATIONS
!
TIDALBCGEN = .FALSE.
!
! ICALHW: NUMBER THAT MAY BE CHOSEN BY THE USER TO CALIBRATE HIGH WATER
! OR AUTOMATICALLY CHOSEN, WHEN MODELLING A SCHEMATIC TIDE
! IN SUBROUTINE BORD_TIDE
! DEFAULT = 0 (AUTOMATICALLY CHOSEN)
!
ICALHW = 0
!
! TM2S2N2EQUAL: LOGICAL TO IMPOSE THE PERIODS OF S2 AND N2 WAVES
! TO BE EQUAL TO THE PERIOD OF M2 WAVE
! DEFAULT = .FALSE.
! FOR SCHEMATIC TIDES MODELLING ONLY!
!
TM2S2N2EQUAL = .FALSE.
!
! OPTIONAL SHIFT OF COORDINATES
!
XSHIFT = 0.D0
YSHIFT = 0.D0
!
! BETA0: OPTIONAL ANGLE (IN DEGREES) BETWEEN LAMBERT AND MERCATOR-JMJ
! REFERENCES (EAST OR X AXES, TRIGONOMETRIC)
! DEFAULT = 0.D0 DEGREES
!
BETA0 = 0.D0
!
! FILES:
!
! T3DBDD: TIDE DATA BASE
! T3DHAR: HARMONIC CONSTANTS FILE
! T3DTID: TIDAL MODEL FILE
!
!-----------------------------------------------------------------------
!
! AUTOMATIC TIDAL BOUNDARY CONDITIONS
!
IF(TIDALDB.EQ.1) THEN
IF(TIDALBCGEN) THEN
IF(T3D_FILES(T3DBDD)%NAME(1:1).EQ.' ') THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'DONNER LE FICHIER'
WRITE(LU,*) 'BASE ASCII DE DONNEES DE MAREE.'
ENDIF
IF(LNG.EQ.2) THEN

Version 1.0
WRITE(LU,*) 'ASCII DATABASE FOR TIDE FILE.'

ENDIF
CALL PLANTE(1)
STOP
ENDIF
IF(T3D_FILES(T3DTID)%NAME(1:1).EQ.' ') THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'DONNER LE FICHIER DU MODELE DE MAREE.'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'THE TIDAL MODEL FILE'
ENDIF
CALL PLANTE(1)
STOP
ENDIF
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'DONNER LE FICHIER DES CONSTANTES HARMONIQUES'
ENDIF
IF(LNG.EQ.2) THEN
ENDIF
CALL PLANTE(1)
STOP
ENDIF
CALL BORD_TIDAL_BC(MESH2D%NBOR%I,LIHBOR%I,LIUBOL%I,
& NPTFR2,KENT,KENTU,
& MESH2D,GEOSYST,NUMZONE,LATIT,LONGIT,
& TIDALTYPE,BOUNDARY_COLOUR,MAXFRO,
& T3D_FILES(T3DBDD)%LU,
& T3D_FILES(T3DTID)%LU,
& T3D_FILES(T3DHAR)%LU,XSHIFT,YSHIFT,BETA0)
ENDIF
!
IF(LNG.EQ.1) THEN
ENDIF
IF(LNG.EQ.2) THEN
ENDIF
CALL PLANTE(1)
STOP
ENDIF
CALL BORD_TIDE(ZF%R,MESH2D%NBOR%I,LIHBOR%I,LIUBOL%I,
& NPOIN2,NPTFR2,AT,DT,NCOTE,NVIT,
& CTIDE,MSL,CTIDEV,NODALCORR,T3D_FILES(T3DHAR)%LU,
& BOUNDARY_COLOUR,
& MARDAT,MARTIM,TM2S2N2EQUAL)
CALL BORD_TIDE_TPXO(ZF%R,MESH2D%NBOR%I,LIHBOR%I,LIUBOL%I,

Version 1.0
& NPOIN2,NPTFR2,AT,NCOTE,NVIT,
& NUMLIQ%I,KENT,KENTU,MESH2D,
& BOUNDARY_COLOUR,
& MARDAT,MARTIM,T3D_FILES,T3DBB1,T3DBB2,
& X,Y,GEOSYST,NUMZONE,LATIT,LONGIT,INTMICON)
IF(LNG.EQ.1) THEN
ENDIF
IF(LNG.EQ.2) THEN
ENDIF
CALL PLANTE(1)
STOP
ENDIF
CALL BORD_TIDE_LEGOS(ZF%R,MESH2D%NBOR%I,LIHBOR%I,LIUBOL%I,
& NPOIN2,NPTFR2,AT,DT,NCOTE,NVIT,
& T3D_FILES(T3DHAR)%LU,BOUNDARY_COLOUR,
& MARDAT,MARTIM)
ELSEIF(TIDALDB.EQ.-1) THEN
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'VALEUR PAR DEFAUT INCORRECTE POUR LA BASE'
WRITE(LU,*) 'DE DONNEES DE MAREE. CHOIX POSSIBLES :'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'INCORRECT DEFAULT VALUE FOR TIDAL DATA BASE.'
ENDIF
CALL PLANTE(1)
STOP
ELSE
IF(LNG.EQ.1) THEN
WRITE(LU,*) 'BASE DE DONNEES DE MAREE NON TRAITEE.'
WRITE(LU,*) 'CHOIX POSSIBLES :'
ENDIF
IF(LNG.EQ.2) THEN
WRITE(LU,*) 'TIDAL DATA BASE NOT TAKEN INTO ACCOUNT.'

Version 1.0
ENDIF
CALL PLANTE(1)
STOP
ENDIF
!
!-----------------------------------------------------------------------
!
DO K=1,NPTFR2
IF(NUMTIDE%I(K).GT.0) THEN
! POSSIBLE SMOOTHING AT THE BEGINNING
! IF(AT.LT.1800.D0) THEN Multiplication de la
! UBTIDE%R(K) = UBTIDE%R(K)*(AT/1800.D0) vitesse de la mare
! VBTIDE%R(K) = VBTIDE%R(K)*(AT/1800.D0) par une ventuelle
! ENDIF fonction rampe
IF(LIUBOL%I(K).EQ.KENTU) THEN
DO NP=1,NPLAN Projection
IBORD=(NP-1)*NPTFR2+K ventuelle
! UBORL%R(IBORD) = UBTIDE%R(K)*COS(ALF)+VBTIDE%R(K)*SIN(ALF) de la
! VBORL%R(IBORD) = -VBTIDE%R(K)*SIN(ALF)+VBTIDE%R(K)*COS(ALF) vitesse sur
UBORL%R(IBORD) = UBTIDE%R(K) les axes du
VBORL%R(IBORD) = VBTIDE%R(K)
repre local
WBORL%R(IBORD) = 0.D0
ENDDO
ENDIF
IF(LIHBOR%I(K).EQ.KENT) THEN
HBOR%R(K) = HBTIDE%R(K)
ENDIF
ENDIF
ENDDO
!
!-----------------------------------------------------------------------
!
RETURN
END

Version 1.0
ANNEXE 2 : EXEMPLE DE FICHIER DES CONDITIONS AUX

LIMITES
Attention : il est ncessaire de bien respecter les codes imposer :
- 5 6 6 pour hauteur deau et composantes de vitesse imposes,
- 4 6 6 pour des composantes de vitesse imposes,
- 4 5 5 pour un dbit impos,
- 5 4 4 pour une hauteur deau impose,
- 2 2 2 pour une paroi solide.
En particulier, au niveau des frontires liquides sur lesquelles la vitesse de la mare est impose, on
veillera bien mettre le code 4 6 6 ou 5 6 6 (voir ci-dessous, surlign en jaune).
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 1 1

2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 106 2
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 118 3
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 368 4
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 94 5
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 284 245

2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 190 246
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 45 247
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 7 248
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 58 249
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 354 255
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 216 256
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 292 257
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 227 258
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 121 259 Frontire
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 157 260 sur
laquelle
on
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 379 335 impose
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 44 336 la mare
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 325 337
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 250 338
5 6 6 0.000000 0.000000 0.000000 0.000000 5 0.000000 0.000000 0.000000 210 339
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 313 340
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 287 341
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 269 342
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 79 343
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 48 344
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 1979 345
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 377 400

2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 299 401
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 882 402
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 863 403
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 870 404
2 2 2 0.000000 0.000000 0.000000 0.000000 2 0.000000 0.000000 0.000000 273 405

Version 1.0
ANNEXE 3 : EXEMPLE DE FICHIER DES CONSTANTES

HARMONIQUES DE MARE POUR LA BASE JMJ
1 Nombre de frontires continues sur lesquelles on impose la mare
250 339 Bornes des frontires sur lesquelles on impose la mare (ici,
250 -0.88 une seule ligne car une seule frontire)
3.245 159.2 0.605 85.0 0.852 266.4
1.277 207.3 0.236 132.1 0.337 314.9
0.619 141.7 0.109 67.8 0.157 249.8
0.068 263.1 0.045 209.8 0.061 27.4
251 -3.26 Numro local du nud de frontire + cote du fond interpole
3.241 159.1 0.656 85.3 0.852 267.6 AHM2, (HM2, AUM2, (UM2, AVM2, (VM2
1.275 207.2 0.256 132.2 0.339 315.9 A HS2, (HS2, AUS2, (US2, AVS2, (VS2
0.618 141.6 0.119 68.0 0.157 251.0 AHN2, (HN2, AUN2, (UN2, AVN2, (VN2
0.067 262.5 0.049 210.8 0.060 27.5 AHM4, (HM4, AUM4, (UM4, AVM4, (VM4
252 -5.80
3.237 159.1 0.693 85.7 0.849 268.4
1.273 207.1 0.271 132.3 0.338 316.7
0.618 141.6 0.125 68.3 0.157 251.7
0.067 262.2 0.052 211.6 0.059 27.4
304 -56.17
2.937 155.9 1.044 112.3 0.177 216.4
1.155 203.0 0.431 155.6 0.062 263.1
0.565 137.8 0.201 93.0 0.031 193.6
0.038 233.3 0.047 212.3 0.009 12.0
305 -57.33 51e nud (= 305-250+1) de la
2.926 155.5 1.030 112.2 0.171 208.8 frontire sur laquelle on impose
1.150 202.6 0.425 155.4 0.059 254.0 la mare : nud de rfrence
0.564 137.4 0.198 92.8 0.030 185.1 choisi pour le dphasage des
0.038 230.3 0.046 212.6 0.007 9.3 ondes, pour la simulation de
306 -59.08 mares types.
2.915 155.1 1.000 112.3 0.175 202.4
1.146 202.1 0.412 155.4 0.061 245.9
0.562 137.0 0.192 93.0 0.031 178.6
0.038 227.1 0.045 214.3 0.006 2.7
337 -3.78
2.977 149.7 0.571 87.3 0.213 97.0
1.164 196.2 0.218 127.6 0.082 136.2
0.573 131.5 0.102 67.4 0.038 76.8
0.049 209.8 0.034 221.6 0.012 221.4
338 -1.98
2.977 149.6 0.557 86.1 0.208 94.2
1.165 196.2 0.212 126.4 0.079 133.3
0.574 131.5 0.099 66.2 0.037 74.0
0.049 209.7 0.033 222.5 0.012 222.4
339 -0.18
2.977 149.6 0.545 84.9 0.204 91.2
1.165 196.1 0.206 125.1 0.078 130.3
0.574 131.4 0.096 65.0 0.036 70.9
0.049 209.6 0.033 223.5 0.012 223.5

Version 1.0
ANNEXE 4 : EXEMPLE DE FICHIER DES CONSTANTES

HARMONIQUES DE MARE POUR LATLAS NEA
1 Nombre de frontires continues sur lesquelles on impose la mare
Bornes des frontires sur lesquelles on impose la mare (ici,
525 701
une seule ligne car une seule frontire)
177 47 M Nombre de nuds de frontires maritimes NPTFRL, nombre
2MK6 dondes disponibles dans le fichier et unit (M = en mtres)
-2.886149 48.701096 0.013936 317.977203 0.003326 197.947632 0.003823 23.528519
-2.881960 48.702286 0.013931 318.020996 0.003261 198.111374 0.003886 24.619614
-2.877318 48.703606 0.013931 318.170380 0.003116 198.791656 0.004025 27.123814
NPTFRL lignes
-3.333333 48.837246 0.008914 282.450378 0.006761 199.499924 0.002344 202.080338
-3.333335 48.834553 0.008914 282.449951 0.006761 199.484482 0.002344 202.057068
-3.333334 48.831860 0.008800 282.073975 0.006869 186.737930 0.002900 186.343658
2MN6 Nom de londe (quatre caractres maximum)
-2.886149 48.701096 0.033758 246.402710 0.008611 143.746552 0.009938 326.549591
-2.881960 48.702286 0.033736 246.449341 0.008427 144.115219 0.010091 327.315491
-2.877318 48.703606 0.033721 246.613495 0.008031 145.207092 0.010424 329.088348
NPTFRL lignes
-3.333333 48.837246 0.021493 210.969345 0.015119 140.050003 0.005300 145.719666
-3.333335 48.834553 0.021492 210.968796 0.015119 140.037186 0.005301 145.696487
-3.333334 48.831860 0.021175 210.515213 0.015594 129.543930 0.006591 130.120193
Longitude, Latitude, AH, (H, AU, (U, AV, (V
Z0
-2.886149 48.701096 0.044377 180.000000 0.059249 180.000000 0.056397 -0.000000
-2.881960 48.702286 0.044339 180.000000 0.059517 180.000000 0.056592 -0.000000
-2.877318 48.703606 0.044083 180.000000 0.059405 180.000000 0.056424 -0.000000
NPTFRL lignes
-3.333333 48.837246 0.032909 180.000000 0.026094 360.000000 0.013002 180.000000
-3.333335 48.834553 0.032906 180.000000 0.026047 360.000000 0.013000 180.000000
-3.333334 48.831860 0.030719 180.000000 0.008657 180.000015 0.011139 180.000000

Version 1.0
ANNEXE 5 : EXEMPLE DE FICHIER DES PARAMTRES POUR

TELEMAC-2D
PROCESSEURS PARALLELES : 12
/----------------------------------------------------------------------/
/ ENVIRONNEMENT INFORMATIQUE
/----------------------------------------------------------------------/
FICHIER FORTRAN : princi.f
FICHIER DES CONDITIONS AUX LIMITES : conlim
FICHIER DE GEOMETRIE : geo
BASE BINAIRE 1 DE DONNEES DE MAREE : hf.ES2008.out
BASE BINAIRE 2 DE DONNEES DE MAREE : uv.ES2008.out
FICHIER DES RESULTATS : res2d
/----------------------------------------------------------------------/
/ OPTIONS GENERALES
/----------------------------------------------------------------------/
VARIABLES POUR LES SORTIES GRAPHIQUES : 'U,V,H,M'
PAS DE TEMPS : 20.
NOMBRE DE PAS DE TEMPS : 120960
PERIODE POUR LES SORTIES GRAPHIQUES : 30
PERIODE DE SORTIE LISTING : 4320
BILAN DE MASSE : OUI
/----------------------------------------------------------------------/
/ CONDITIONS INITIALES
/----------------------------------------------------------------------/
/ YEAR, MONTH, DAY
DATE DE L'ORIGINE DES TEMPS : 2012;12;17
HEURE DE L'ORIGINE DES TEMPS : 0;0;0
CONDITIONS INITIALES : 'ALTIMETRIE SATELLITE TPXO'
/----------------------------------------------------------------------/
/ CONDITIONS AUX LIMITES
/----------------------------------------------------------------------/
OPTION POUR LES FRONTIERES LIQUIDES : 2
/----------------------------------------------------------------------/
/ CONDITIONS DE MAREE
/----------------------------------------------------------------------/
OPTION POUR LES CONDITIONS AUX LIMITES DE MAREE : 1

Version 1.0
BASE DE DONNEES DE MAREE : 2

COEFFICIENT DE CALAGE DU MARNAGE : 1.06
COEFFICIENT DE CALAGE DES VITESSES DE COURANT : 1.10
SYSTEME GEOGRAPHIQUE : 4
NUMERO DE FUSEAU OU PROJECTION DANS LE SYSTEME GEOGRAPHIQUE : 1
/----------------------------------------------------------------------/
/ OPTIONS PHYSIQUES
/----------------------------------------------------------------------/
LOI DE FROTTEMENT SUR LE FOND : 3
COEFFICIENT DE FROTTEMENT : 27.
/
CORIOLIS : OUI
COEFFICIENT DE CORIOLIS : 1.10E-4
/----------------------------------------------------------------------/
/ OPTIONS NUMERIQUES
/----------------------------------------------------------------------/
DISCRETISATIONS EN ESPACE : 11 ; 11
STOCKAGE DES MATRICES : 3
COMPATIBILITE DU GRADIENT DE SURFACE LIBRE : 0.5
/
TRAITEMENT DU SYSTEME LINEAIRE : 2
/
FORME DE LA CONVECTION : 1;5
OPTION DE SUPG : 0;0
/
SOLVEUR : 1
PRECISION DU SOLVEUR : 1.E-4
MAXIMUM D'ITERATIONS POUR LE SOLVEUR : 500
PRECONDITIONNEMENT : 2
/
BANCS DECOUVRANTS : OUI
OPTION DE TRAITEMENT DES BANCS DECOUVRANTS : 1
/ POUR AVOIR DES HAUTEURS POSITIVES PARTOUT
MASS-LUMPING SUR H : 1.
CORRECTION DE CONTINUITE : OUI
TRAITEMENT DES HAUTEURS NEGATIVES : 2
&FIN

Simulation Maree v6p2

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Simulation Maree v6p2

Uploaded by

Copyright:

Available Formats

EDF R&D

LABORATOIRE NATIONAL D'HYDRAULIQUE ET ENVIRONNEMENT

Mthodologie pour la simulation de la mare avec la version 6.2 de TELEMAC-

Sbastien BOURBAN HR Wallingford

Nomie DURAND HR Wallingford

Michael TURNBULL HR Wallingford

Accessibilit : Libre Mention Spciale : Dclassement :

Methodology to model tides with version 6.2 of TELEMAC-2D and TELEMAC-3D

Sbastien BOURBAN HR Wallingford

Nomie DURAND HR Wallingford

Michael TURNBULL HR Wallingford

Accessibility : Free Special Mention : Declassification :

Toute modification, reproduction, extraction dlments, rutilisation de tout ou partie de ce document

Accessibilit : Libre Page 1 sur 47 EDF SA 2013

Accessibilit : Libre Page 2 sur 47 EDF SA 2013

PAGE DE GARDE ....................................................................................................................................I

FRONT PAGE ..........................................................................................................................................II

CIRCUIT DE VALIDATION .....................................................................................................................III

LISTE DE DIFFUSION ........................................................................................................................... IV

AVERTISSEMENT / CAUTION ...............................................................................................................1

SOMMAIRE / SUMMARY ........................................................................................................................3

2. LEMENTS DE THEORIE UTILISES POUR MODELISER LA MAREE ........................................5

Accessibilit : Libre Page 3 sur 47 EDF SA 2013

5. MODE OPERATOIRE POUR GENERER LE FICHIER DES CONSTANTES HARMONIQUES DE

6. SIMULATION DE LA MAREE EN VERSION 6.2 ...........................................................................27

7. QUELQUES ERREURS A NE PAS COMMETTRE .......................................................................28

8. MOTS-CLES ET FICHIERS POUR LUTILISATION DES DIFFERENTES BASES DE

10. REFERENCES ............................................................................................................................31

ANNEXE 1 : EXEMPLES DE SOUS-PROGRAMMES TIDAL_MODEL_T2D ET TIDAL_MODEL_T3D

ANNEXE 2 : EXEMPLE DE FICHIER DES CONDITIONS AUX LIMITES ...........................................43

ANNEXE 3 : EXEMPLE DE FICHIER DES CONSTANTES HARMONIQUES DE MARE POUR LA

ANNEXE 4 : EXEMPLE DE FICHIER DES CONSTANTES HARMONIQUES DE MARE POUR

ANNEXE 5 : EXEMPLE DE FICHIER DES PARAMTRES POUR TELEMAC-2D .............................46

Accessibilit : Libre Page 4 sur 47 EDF SA 2013

2. lments de thorie utiliss pour modliser la mare

2.1. Les courants de mare

Accessibilit : Libre Page 5 sur 47 EDF SA 2013

lmentaires, appeles aussi composantes harmoniques, rpertories en fonction de leur priode

2.2. Mise en quations

Accessibilit : Libre Page 6 sur 47 EDF SA 2013

- h " ! hi ) z f , z moy , (4)

2.3. Bases de constantes harmoniques disponibles

2.3.1. Modle de simulation des courants de mare en Manche et

Accessibilit : Libre Page 7 sur 47 EDF SA 2013

Figure 1 : Emprise du modle dit de Jean-Marc Janin [2].

2.3.2. Atlas Nord-Est Atlantique du LEGOS (NEA)

Accessibilit : Libre Page 8 sur 47 EDF SA 2013

Figure 2 : Emprise de latlas NEA [6].

2.3.3. La solution globale TPXO et les solutions rgionales et

Accessibilit : Libre Page 9 sur 47 EDF SA 2013

Figure 3 : Emprise de la solution locale European Shelf [9].

2.4. Simulation de mares relles , partir dun jour prcis

2.5. Simulation de mares types

Accessibilit : Libre Page 10 sur 47 EDF SA 2013

- mare de vive-eau exceptionnelle (coefficient de mare !""#$ ;

Tableau 1 : Dphasages de chacune des ondes afin de simuler un type de mares

2.6. Simulation avec le module TPXO

Accessibilit : Libre Page 11 sur 47 EDF SA 2013

3. Application dans TELEMAC

Accessibilit : Libre Page 12 sur 47 EDF SA 2013

3.1. Sous-programme de commande TIDAL_MODEL_T2D ou

Accessibilit : Libre Page 13 sur 47 EDF SA 2013

3.2. Sous-programme de gnration des constantes

Accessibilit : Libre Page 14 sur 47 EDF SA 2013