doc/salome/tutorial/index.rst

   1 ..
   2    Copyright (C) 2015-2016 EDF
   3
   4    This file is part of SALOME HYDRO module.
   5
   6    SALOME HYDRO module is free software: you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation, either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    SALOME HYDRO module is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with SALOME HYDRO module.  If not, see <http://www.gnu.org/licenses/>.
  18
  19
  20 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  21 Tutoriel SALOME HYDRO
  22 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  23
  24 .. |Hydro_module_button| image:: /_static/HYDRO.png
  25    :align: middle
  26    :width: 16pt
  27    :height: 16pt
  28
  29 .. |hydrosolver_module_button| image:: /_static/HYDROSolver.png
  30    :align: middle
  31    :width: 16pt
  32    :height: 16pt
  33
  34 SALOME-HYDRO est une plateforme métier dédiée aux études d'hydraulique à surface
  35 libre, avec les codes TELEMAC et MASCARET. La plateforme s'appuie sur les modules
  36 génériques de SALOME (géométrie, maillage, supervision de calculs, post traitement...)
  37 auxquels ont été ajoutés deux modules spécifiques du métier :
  38
  39   * HYDRO |Hydro_module_button| : acquisition des données de terrain (contours, bathymétrie...),
  40     construction de la géométrie du cas de calcul, identification des zones de
  41     condition limite...
  42
  43   * HYDROSolver |hydrosolver_module_button| : définition des paramètres physiques et
  44     numériques du cas de calcul, pilotage du calcul.
  45
  46 Le tutoriel traite l'ensemble des étapes d'une étude d'inondation liée à une crue
  47 de fleuve. L'exemple est tiré d'un cas réel pour lequel beaucoup de données sont disponibles.
  48
  49 .. _ref_installationLancementSalome:
  50
  51 ###################################
  52 Introduction à SALOME
  53 ###################################
  54
  55 Dans cette partie, on rappelle comment installer et exécuter SALOME.
  56
  57 .. toctree::
  58    :numbered:
  59    :maxdepth: 3
  60
  61    installationLancementSalome.rst
  62
  63 .. _ref_notionsPrealables:
  64
  65 ###################################
  66 Quelques notions préalables
  67 ###################################
  68
  69 On décrit ici les différentes étapes d'une étude SALOME-HYDRO, en introduisant les concepts nécessaires.
  70 Cette partie contient également une série de recommandations et de pièges à éviter.
  71
  72 L'exercice décrit plus bas permet de découvrir ces concepts par la manipulation.
  73
  74 .. toctree::
  75    :numbered:
  76    :maxdepth: 3
  77
  78    preliminaires.rst
  79    piegesAEviter.rst
  80    donneesPrealables.rst
  81
  82
  83 .. _ref_outilsComplementaires:
  84
  85 ###################################
  86 Des outils complémentaires à SALOME
  87 ###################################
  88
  89 Les outils qgis et CloudCompare sont fournis à coté de SALOME-HYDRO.
  90
  91 .. toctree::
  92    :numbered:
  93    :maxdepth: 3
  94
  95    introQgis.rst
  96    introCloudCompare.rst
  97
  98 .. _ref_exempleInondation:
  99
 100 ###################################
 101 Un exemple simple d'inondation
 102 ###################################
 103
 104 Cet exercice couvre complètement une étude d'inondation sur un problème simple.
 105
 106 .. toctree::
 107    :numbered:
 108    :maxdepth: 3
 109
 110    import.rst
 111    importBathy.rst
 112    polylignes.rst
 113    objetsNaturels.rst
 114    casCalcul.rst
 115    geometrie.rst
 116    maillage.rst
 117    interpolationZ.rst
 118    miseEnDonneesTelemac.rst
 119    lancementCalcul.rst
 120    depouillementCalcul.rst
 121
 122 .. _ref_casParticuliers:
 123
 124 ###################################
 125 Des cas particuliers
 126 ###################################
 127
 128 On introduit ici quelques concepts non abordés dans l'exemple simple précédent.
 129
 130 .. toctree::
 131    :numbered:
 132    :maxdepth: 3
 133
 134    streams.rst
 135    objetsArtificiels.rst
 136    manipsPolys.rst
 137    landCoverMap.rst
 138    completeCase.rst
 139    copyMesh.rst
 140
 141 .. _ref_outilsReprise:
 142
 143 ###################################
 144 Des outils pour la reprise d'études
 145 ###################################
 146
 147 Il arrive fréquemment que l'on doive reprendre des études, par exemple pour étendre ou modifier un maillage, changer la bathymétrie.
 148 Ces études peuvent avoir été générées avec d'autres outils que SALOME HYDRO.
 149 On suppose que l'on dispose a minima d'un fichier maillage au format MED correspondant à l'étude à reprendre,
 150 contenant éventuellement des groupes (conditions limites ou autres) que l'on souhaite récupérer.
 151
 152 Le script *converter.py* fourni avec Telemac permet de convertir les types de maillages lus par Telemac au format MED.
 153 Il est accessible depuis le shell SALOME. ::
 154
 155   <appli_XXX>/salome shell
 156   converter.py --help
 157
 158 .. toctree::
 159    :numbered:
 160    :maxdepth: 3
 161
 162    modifBathy.rst
 163    changeCoordSystem.rst
 164    extensionMaillageExistant.rst
 165
 166 .. _ref_formatsSpecs:
 167
 168 ###################################
 169 Formats et specifications
 170 ###################################
 171
 172 On introduit ici quelques formats d'import-export.
 173 La documentation du format SinusX en français correspond à l'usage d'origine du format et donne une transposition pour l'usage SALOME,
 174 **La documentation du format SinusX en anglais donne la spécification précise du format SinusX dans SALOME HYDRO.
 175 C'est cette dernière documentation qui constitue la référence pour SALOME HYDRO.**
 176
 177 .. toctree::
 178    :numbered:
 179    :maxdepth: 3
 180
 181    format_sinusx.rst
 182    sinusX_Format.rst