From 979c6857da75f5712e7170b2700a571a8273fe09 Mon Sep 17 00:00:00 2001 From: Paul RASCLE Date: Tue, 10 Nov 2015 18:36:32 +0100 Subject: [PATCH] plan tutoriel plus complet --- doc/salome/gui/HYDRO/mainpage.h | 5 ++++- doc/salome/tutorial/CMakeLists.txt | 14 +++++++++++- doc/salome/tutorial/casCalcul.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/depouillementCalcul.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/geometrie.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/import.rst | 22 +++++++++---------- doc/salome/tutorial/importBathy.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/index.rst | 15 ++++++++++++- doc/salome/tutorial/interpolationZ.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/lancementCalcul.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/maillage.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/miseEnDonneesTelemac.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/objetsArtificiels.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/objetsNaturels.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/polylignes.rst | 23 ++++++++++++++++++++ doc/salome/tutorial/preliminaires.rst | 2 +- doc/salome/tutorial/streams.rst | 23 ++++++++++++++++++++ 17 files changed, 319 insertions(+), 15 deletions(-) create mode 100644 doc/salome/tutorial/casCalcul.rst create mode 100644 doc/salome/tutorial/depouillementCalcul.rst create mode 100644 doc/salome/tutorial/geometrie.rst create mode 100644 doc/salome/tutorial/importBathy.rst create mode 100644 doc/salome/tutorial/interpolationZ.rst create mode 100644 doc/salome/tutorial/lancementCalcul.rst create mode 100644 doc/salome/tutorial/maillage.rst create mode 100644 doc/salome/tutorial/miseEnDonneesTelemac.rst create mode 100644 doc/salome/tutorial/objetsArtificiels.rst create mode 100644 doc/salome/tutorial/objetsNaturels.rst create mode 100644 doc/salome/tutorial/polylignes.rst create mode 100644 doc/salome/tutorial/streams.rst diff --git a/doc/salome/gui/HYDRO/mainpage.h b/doc/salome/gui/HYDRO/mainpage.h index f990d0ef..65ac0173 100644 --- a/doc/salome/gui/HYDRO/mainpage.h +++ b/doc/salome/gui/HYDRO/mainpage.h @@ -7,7 +7,10 @@ /** @mainpage - A Tutorial on SALOME HYDRO + The HYDRO documentation is divided in two parts: + - the reference documentation below + - a Tutorial in French: Here + The HYDRO GUI project has been developed for a hydrodynamic laboratory in the EDF R&D company in the domain of the landscape modelling (construction of channels, dams, changing the course of the rivers etc). diff --git a/doc/salome/tutorial/CMakeLists.txt b/doc/salome/tutorial/CMakeLists.txt index 60c75355..2da2c9cc 100644 --- a/doc/salome/tutorial/CMakeLists.txt +++ b/doc/salome/tutorial/CMakeLists.txt @@ -16,9 +16,21 @@ # along with SALOME HYDRO module. If not, see . SET(RSTFILES + casCalcul.rst + depouillementCalcul.rst + geometrie.rst + import.rst + importBathy.rst index.rst + interpolationZ.rst + lancementCalcul.rst + maillage.rst + miseEnDonneesTelemac.rst + objetsArtificiels.rst + objetsNaturels.rst + polylignes.rst preliminaires.rst - import.rst + streams.rst ) SET(SPHINXOPTS ) diff --git a/doc/salome/tutorial/casCalcul.rst b/doc/salome/tutorial/casCalcul.rst new file mode 100644 index 00000000..0c722c7c --- /dev/null +++ b/doc/salome/tutorial/casCalcul.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Constitution du cas de calcul +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/depouillementCalcul.rst b/doc/salome/tutorial/depouillementCalcul.rst new file mode 100644 index 00000000..541b61c3 --- /dev/null +++ b/doc/salome/tutorial/depouillementCalcul.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Dépouillement du calcul TELEMAC +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/geometrie.rst b/doc/salome/tutorial/geometrie.rst new file mode 100644 index 00000000..e6dfabf5 --- /dev/null +++ b/doc/salome/tutorial/geometrie.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Etape géometrique +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/import.rst b/doc/salome/tutorial/import.rst index 99ea42ae..12b658aa 100644 --- a/doc/salome/tutorial/import.rst +++ b/doc/salome/tutorial/import.rst @@ -57,8 +57,8 @@ Import des images et fonds de plan Chargement du module HYDRO ========================== -Pour actver le module HYDRO, il faut le selectionner dans la liste défilante des modules -ou cliquer sur son icone dans le bandeau : |Hydro_module_button|. +Pour activer le module HYDRO, il faut le sélectionner dans la liste défilante des modules +ou cliquer sur son icône dans le bandeau : |Hydro_module_button|. |Hydro_module_launch| @@ -73,7 +73,7 @@ une image, nécessaires au géoréférencement. .. Géoportail_: http://www.geoportail.gouv.fr/accueil -Pour importer une image, on utilise le menu contextuel de la rubrique *IMGAGES* dans l'arbre de +Pour importer une image, on utilise le menu contextuel de la rubrique *IMAGES* dans l'arbre de l'étude SALOME: |import_image| @@ -83,12 +83,12 @@ La première image se trouve dans le répertoire d'installation de l'application /bin/salome/test/HYDRO/garonne_ign_01.png L'image est affichée, avec deux points *A* et *B* qui vont être repositionnés à des emplacements -dont on connait la position dans le repère Lambert 93, choisis assez éloignés l'un de l'autre +dont on connaît les coordonnées dans le repère Lambert 93, choisis assez éloignés l'un de l'autre pour garder une bonne précision. |import_image2| -Voici les deux points particuliers dont on a prélablement repéré les coordonnées avec Géoportail : +Voici les deux points particuliers dont on a préalablement repéré les coordonnées avec Géoportail : |selection_A| coordonnées (471562, 6367750): un point en dessous à gauche de la marque *92*. @@ -105,16 +105,16 @@ Après avoir sélectionné les deux points, le dialogue de géoréférencement r |selection_B2| Pour les coordonnées x,y de chaque point, la première colonne donne les coordonnées du pixel de l'image, -lacdeuxième colonne donne les coordonnées géographiques. +la deuxième colonne donne les coordonnées géographiques. On valide le géoréférencement avec le bouton *Apply and Close*. -Il faut s'assurer que l'oeil à gauche du nom de l'image dans l'arbre est bien actif, et recentrer l'image +Il faut s'assurer que l'icône "oeil" à gauche du nom de l'image dans l'arbre est bien active, et recentrer l'image à l'aide du bouton *fit all* : |fit_all|. L'image obtenue est légèrement inclinée vers la droite. * **remarque** : dans cette vue, le zoom peut se faire à l'aide de la molette de la souris. - Le zoom peut être centré sur la position de la souris. C'est une option accessible dans le menu + Le zoom peut être centré sur la position de la souris, ou au centre de l'image. C'est une option accessible dans le menu *File/préférences* sous la rubrique *SALOME*, onglet *3D viewer*, *zooming style* : |zoom_style| @@ -122,7 +122,7 @@ L'image obtenue est légèrement inclinée vers la droite. Quand on promène la souris sur la carte, les coordonnées du curseur s'affichent dans la barre d'état en bas à gauche de l'application. - * **remarque** : il faut prendre l'habitude de sauver l'étude en cours régulièrement + * **remarque** : il faut prendre l'habitude de **sauver l'étude en cours régulièrement** (menu *File/Save* ou *File/Save as*). Il est également conseillé de sauvegarder les différentes étapes de l'étude dans des fichiers différents : *il est arrivé, dans certaines circonstances difficiles à reproduire, que l'étude soit sauvée de manière incomplète.* Les cas où ce problème est survenu @@ -130,7 +130,7 @@ en bas à gauche de l'application. le module HYDRO n'a pas été activé avant la sauvegarde. On se prémunit contre se risque de sauvegarde incomplète en activant le module HYDRO avant de sauvegarder l'étude. -Import d'une deuxième image, géorférérencée à partir la première +Import d'une deuxième image, géoréférencée à partir la première ================================================================ La deuxième image est au même endroit que la première :: @@ -139,7 +139,7 @@ La deuxième image est au même endroit que la première :: Pour la géoréférencer, on utilise l'option *choose points on the reference image* du dialogue. Après avoir sélectionné la première image comme référence, on voit les deux images l'une en dessus de l'autre. -On selectionne d'abord un point A au même emplacement sur les deux images, puis un point B. +On sélectionne d'abord un point A au même emplacement sur les deux images, puis un point B. Il faut prendre deux points les plus éloignés possible, et zoomer suffisamment pour être précis. Le dialogue ressemble alors à ceci : diff --git a/doc/salome/tutorial/importBathy.rst b/doc/salome/tutorial/importBathy.rst new file mode 100644 index 00000000..53c948d6 --- /dev/null +++ b/doc/salome/tutorial/importBathy.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Import de bathymétrie +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/index.rst b/doc/salome/tutorial/index.rst index e2f12afd..db7b9183 100644 --- a/doc/salome/tutorial/index.rst +++ b/doc/salome/tutorial/index.rst @@ -43,11 +43,24 @@ auxquels ont été ajoutés deux modules spécifiques du métier : numériques du cas de calcul, pilotage du calcul Le tutoriel traite l'ensemble des étapes d'une étude d'inondation liée à une crue -de fleuve. L'exemple est tiré d'un cas réél pour lequel beaucoup de données sont disponibles. +de fleuve. L'exemple est tiré d'un cas réel pour lequel beaucoup de données sont disponibles. .. toctree:: :maxdepth: 2 preliminaires.rst import.rst + importBathy.rst + polylignes.rst + objetsNaturels.rst + streams.rst + objetsArtificiels.rst + casCalcul.rst + geometrie.rst + maillage.rst + interpolationZ.rst + miseEnDonneesTelemac.rst + lancementCalcul.rst + depouillementCalcul.rst + \ No newline at end of file diff --git a/doc/salome/tutorial/interpolationZ.rst b/doc/salome/tutorial/interpolationZ.rst new file mode 100644 index 00000000..4c7387e0 --- /dev/null +++ b/doc/salome/tutorial/interpolationZ.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Interpolation en Z +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/lancementCalcul.rst b/doc/salome/tutorial/lancementCalcul.rst new file mode 100644 index 00000000..a7cf7886 --- /dev/null +++ b/doc/salome/tutorial/lancementCalcul.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Lancement du calcul TELEMAC +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/maillage.rst b/doc/salome/tutorial/maillage.rst new file mode 100644 index 00000000..0105ee2f --- /dev/null +++ b/doc/salome/tutorial/maillage.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Création du maillage +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/miseEnDonneesTelemac.rst b/doc/salome/tutorial/miseEnDonneesTelemac.rst new file mode 100644 index 00000000..552a9ae7 --- /dev/null +++ b/doc/salome/tutorial/miseEnDonneesTelemac.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Mise en données TELEMAC +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/objetsArtificiels.rst b/doc/salome/tutorial/objetsArtificiels.rst new file mode 100644 index 00000000..7f2aa375 --- /dev/null +++ b/doc/salome/tutorial/objetsArtificiels.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Objets Artificiels +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/objetsNaturels.rst b/doc/salome/tutorial/objetsNaturels.rst new file mode 100644 index 00000000..515b44ae --- /dev/null +++ b/doc/salome/tutorial/objetsNaturels.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Objets Naturels +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/polylignes.rst b/doc/salome/tutorial/polylignes.rst new file mode 100644 index 00000000..92cca531 --- /dev/null +++ b/doc/salome/tutorial/polylignes.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Création de polylignes +######################################### + +blabla. \ No newline at end of file diff --git a/doc/salome/tutorial/preliminaires.rst b/doc/salome/tutorial/preliminaires.rst index 4c2d680f..52714394 100644 --- a/doc/salome/tutorial/preliminaires.rst +++ b/doc/salome/tutorial/preliminaires.rst @@ -28,7 +28,7 @@ Notions préliminaires * **Repère Local** : Les coordonnées planes, **toujours exprimées en mètres**, dans la projection utilisée correspondent souvent à des grands nombres. Par exemple, les coordonnées en Lambert 93 d'un point du territoire - métropolitain sont de l'ordre de (400 000, 6 500 000). + métropolitain sont par exemple de l'ordre de (400 000, 6 500 000). Le repère local consiste en un simple décalage de l'origine, permettant de manipuler de plus petits nombres. Pour améliorer la précision numérique dans les différentes étapes de diff --git a/doc/salome/tutorial/streams.rst b/doc/salome/tutorial/streams.rst new file mode 100644 index 00000000..86fc8c1a --- /dev/null +++ b/doc/salome/tutorial/streams.rst @@ -0,0 +1,23 @@ +.. + Copyright (C) 2015-2016 EDF + + This file is part of SALOME HYDRO module. + + SALOME HYDRO module is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + SALOME HYDRO module is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with SALOME HYDRO module. If not, see . + +######################################### +Streams +######################################### + +blabla. \ No newline at end of file -- 2.39.2