From: nicolas Date: Thu, 27 Jun 2013 11:59:15 +0000 (+0000) Subject: simplification X-Git-Tag: V7_3_0a1~69 X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=af47ee8e6222aac5edb3646fe65e4f0379cb29bf;p=modules%2Fhomard.git simplification --- diff --git a/doc/en/demarrage_rapide.rst b/doc/en/demarrage_rapide.rst new file mode 100644 index 00000000..620a1862 --- /dev/null +++ b/doc/en/demarrage_rapide.rst @@ -0,0 +1,79 @@ +.. _demarrage_rapide: + +Quick start +=========== +.. index:: single: start +.. index:: single: example + +The options to drive HOMARD in SALOME are described into :ref:`gui_usage`. Here are the basic instructions to discover how to use HOMARD from a very simple example. + +Let's imagine that a calculation of a thermal problem has been done with a given mesh. An output MED file was produced; it contains the mesh and the field of the temperatures over the nodes. We'd like to adapt the mesh to decrease the variation of the temperature from one node to another below a threshold. + +First, the module HOMARD is launched, by the creation of a new study; the same method as for the other modules of SALOME. + +.. image:: images/homard_1.png + :align: center + +Once the activation of the module HOMARD is done, a case is created with the choice "*New case*" into the menu. + +.. image:: images/homard_2.png + :align: center + +This window appears: + +.. image:: images/intro_31.png + :align: center + +Two answers must be given: the directory that will contain the files produced by the further adaptations and the MED file from the initial calculation. Validate by "Apply and close". + +.. image:: images/intro_32.png + :align: center + +The object browser is enriched with this case. Unfold the case until the mesh of this iteration #0 can be seen. This iteration #0 is selected and a new iteration is required by "*New iteration*" into the menu or with the mouse. + +.. image:: images/intro_331.png + :align: center + +This window appears: + +.. image:: images/intro_33.png + :align: center + +The file that contains the field of temperature from the computation is selected. It is the same as the one given for the creation of the case. + +.. image:: images/intro_34.png + :align: center + +Click "New" into the 'hypothesis' part. This window appears: + +.. image:: images/intro_35.png + :align: center + +The default options are modified to respect our choice for the driving of the adaptation. Selecting the jump between elements and selecting an absolute threshold of 4.0 will produce the splitting of every single edge of an element where the variation of the temperature is higher than 4.0 between the two vertices of the edge. + +.. image:: images/intro_36.png + :align: center + +The creation of the hypothesis is validated by "Apply and close"; the creation of the new iteration is validated too. The object browser is enriched by the description of this hypothesis and this iteration. The iteration can be seen with a specific icon "waiting". + +The adaptation is launched by the selection of the iteration. "*Compute*" is choosen either in the menu, or with the mouse. The MED file of the new mesh, ``maill.01.med``, and some files for information are included into the object browser. Note that the MED file of the new mesh is located into the directory of the case. + +.. image:: images/intro_37.png + :align: center + +Now, this new mesh can be used for a second thermal calculation, with the same conditions as for the first one. Once this second calcultion is done, the adaptive process can go on. First, go back into the module HOMARD of SALOME. The plast iteration "*Iter_1*" is selected and a new iteration is asked for. This window appears: + +.. image:: images/intro_38.png + :align: center + +The adaption goes on with the same criteria; the hypothesis "*Hypo_1*" is kept. The only operation is to give the name of the MED file from the last computation for the new field of temperature. + +.. image:: images/intro_39.png + :align: center + +As before, the iteration is computed ans the results are found into the directory of the case, including the mesh ``maill.02.med``. + +.. image:: ../images/intro_40.png + :align: center + +A new calculation can be launched over this new mesh. The alternation computation/adaptation is done until the final result. diff --git a/doc/en/index.rst b/doc/en/index.rst index 9afd564c..82fbf66f 100644 --- a/doc/en/index.rst +++ b/doc/en/index.rst @@ -16,6 +16,7 @@ User's guide .. toctree:: :maxdepth: 1 + demarrage_rapide gui_usage tui_usage tutorials diff --git a/doc/en/intro.rst b/doc/en/intro.rst index 6d8a1095..0ba7ccfe 100644 --- a/doc/en/intro.rst +++ b/doc/en/intro.rst @@ -50,7 +50,8 @@ Des variantes de ce sch G. Nicolas and T. Fouquet, Adaptive Mesh Refinement for Conformal Hexahedral Meshes, "*Finite Elements in Analysis and Design*", Vol. 67, pp. 1-12, 2013, doi:10.1016/j.finel.2012.11.008 - `Available here`_ + + `Available here `_ Some illustrations of adapted meshes @@ -90,78 +91,3 @@ Some illustrations of adapted meshes | | +---------------------------------------------------------------+ -Quick start -""""""""""" -.. index:: single: start -.. index:: single: example - -L'ensemble des options de pilotage du module HOMARD dans SALOME est décrit dans le :ref:`gui_usage`. Mais on trouvera ici le B.A. BA pour découvrir l'utilisation de HOMARD à partir d'un exemple simple. Imaginons que l'on a effectué un calcul de thermique sur un maillage donné. On a récupéré en sortie de ce calcul un fichier au format MED, contenant le maillage et le champ des températures aux noeuds. On aimerait adapter le maillage de telle sorte que l'écart de température entre deux noeuds voisins soit inférieur à une valeur donnée. - -La première action nécessite de lancer le module HOMARD, en créant une nouvelle étude, selon le principe qui a été retenu pour tous les autres modules de SALOME. - -.. image:: images/homard_1.png - :align: center - -Une fois le module HOMARD activé, on crée un cas par le choix "*Nouveau cas*" dans le menu HOMARD. - -.. image:: images/homard_2.png - :align: center - -La fenêtre suivante apparaît : - -.. image:: images/intro_31.png - :align: center - -Il faut fournir deux informations : le répertoire qui contiendra les fichiers produits par les adaptations successives et le fichier issu du calcul que l'on vient de faire. On valide par "Appliquer et fermer". - -.. image:: images/intro_32.png - :align: center - -L'arbre d'études est enrichi de ce cas. On déplie le cas jusqu'à afficher le maillage correspondant à l'itération 0. On désigne cette itération initiale et on demande une nouvelle itération par "*Nouvelle itération*" dans le menu HOMARD ou à la souris. - -.. image:: images/intro_331.png - :align: center - -La fenêtre suivante apparaît : - -.. image:: images/intro_33.png - :align: center - -On désigne le fichier issu du calcul que l'on vient de faire et qui contient le champ de température. C'est le même que celui qui a été donné dans la définition du cas. - -.. image:: images/intro_34.png - :align: center - -On clique sur "Nouveau" dans la rubrique hypothèse. La fenêtre suivante apparaît : - -.. image:: images/intro_35.png - :align: center - -On modifie les options par défaut pour correspondre à notre choix de pilotage de l'adaptation. La sélection d'un pilotage par les saut entre éléments et d'un seuil absolu de 4.0 va demander le découpage de chaque arête de maille où le température varie de plus de 4.0 degrés entre les deux extrémités de l'arête. - -.. image:: images/intro_36.png - :align: center - -On valide par "Appliquer et fermer" cette création d'hypothése, puis la création de la nouvelle itération. On se retrouve avec un arbre d'études enrichi avec la description de l'hypothèse créée et de l'itération à calculer, repérée par une icone "en attente". - -Lancer l'adaptation s'obtient en sélectionnant l'itération à calculer. On choisit ensuite "*Calculer*" dans le menu HOMARD ou à la souris. L'arbre d'études s'enrichit de fichiers d'informations et du nom du fichier au format MED qui contient le nouveau maillage, ``maill.01.med``. On remarque qu'il est placé dans le répertoire qui a été désigné à la création du cas. - -.. image:: images/intro_37.png - :align: center - -A ce stade, on va utiliser ce nouveau maillage pour un deuxième calcul, dans les mêmes conditions que le premier. Une fois que ce nouveau calcul est achevé, on peut décider de poursuivre le processus d'adaptation. Pour cela on revient dans SALOME et on active le module HOMARD. On désigne l'itération que l'avait calculée précédemment "*Iter_1*" et on demande une nouvelle itération. La fenêtre suivante apparaît : - -.. image:: images/intro_38.png - :align: center - -Comme on continue l'adaptation avec le même critère de saut de température entre noeuds voisins, on garde l'hypothèse "*Hypo_1*". Il suffit de désigner le fichier issu du calcul que l'on vient de faire et qui contient le nouveau champ de température. - -.. image:: images/intro_39.png - :align: center - -Comme précédemment, on lance l'adaptation et on récupère les résultats dans le répertoire du cas, dont le maillage ``maill.02.med``. - -.. image:: ../images/intro_40.png - :align: center - -On peut alors lancer un nouveau calcul sur ce nouveau maillage et poursuiver cette alternance calcul/adaptation jusqu'à l'obtention du résultat attendu. diff --git a/doc/fr/demarrage_rapide.rst b/doc/fr/demarrage_rapide.rst new file mode 100644 index 00000000..43558581 --- /dev/null +++ b/doc/fr/demarrage_rapide.rst @@ -0,0 +1,85 @@ +.. _demarrage_rapide: + +Démarrage rapide +================ +.. index:: single: démarrage +.. index:: single: exemple + +L'ensemble des options de pilotage du module HOMARD dans SALOME est décrit dans le :ref:`gui_usage`. Mais on trouvera ici le B.A. BA pour découvrir l'utilisation de HOMARD à partir d'un exemple simple. + +Imaginons que l'on a effectué un calcul de thermique sur un maillage donné. On a récupéré en sortie de ce calcul un fichier au format MED, contenant le maillage et le champ des températures aux noeuds. On aimerait adapter le maillage de telle sorte que l'écart de température entre deux noeuds voisins soit inférieur à une valeur donnée. + +La première action nécessite de lancer le module HOMARD, en créant une nouvelle étude, selon le principe qui a été retenu pour tous les autres modules de SALOME. + +.. image:: images/homard_1.png + :align: center + +Une fois le module HOMARD activé, on crée un cas par le choix "*Nouveau cas*" dans le menu HOMARD. + +.. image:: images/homard_2.png + :align: center + +La fenêtre suivante apparaît : + +.. image:: images/intro_31.png + :align: center + +Il faut fournir deux informations : le répertoire qui contiendra les fichiers produits par les adaptations successives et le fichier MED issu du calcul que l'on vient de faire. On valide par "Appliquer et fermer". + +.. image:: images/intro_32.png + :align: center + +L'arbre d'études est enrichi de ce cas. On déplie le cas jusqu'à afficher le maillage correspondant à l'itération 0. On désigne cette itération initiale et on demande une nouvelle itération par "*Nouvelle itération*" dans le menu HOMARD ou à la souris. + +.. image:: images/intro_331.png + :align: center + +La fenêtre suivante apparaît : + +.. image:: images/intro_33.png + :align: center + +On désigne le fichier issu du calcul que l'on vient de faire et qui contient le champ de température. C'est le même que celui qui a été donné dans la définition du cas. + +.. image:: images/intro_34.png + :align: center + +On clique sur "Nouveau" dans la rubrique hypothèse. La fenêtre suivante apparaît : + +.. image:: images/intro_35.png + :align: center + +On modifie les options par défaut pour correspondre à notre choix de pilotage de l'adaptation. La sélection d'un pilotage par les sauts entre éléments et d'un seuil absolu de 4.0 va demander le découpage de chaque arête de maille où le température varie de plus de 4.0 degrés entre les deux extrémités de l'arête. + +.. image:: images/intro_36.png + :align: center + +On valide par "Appliquer et fermer" cette création d'hypothése, puis la création de la nouvelle itération. On se retrouve avec un arbre d'études enrichi avec la description de l'hypothèse créée et de l'itération à calculer, repérée par une icone "en attente". + +Lancer l'adaptation s'obtient en sélectionnant l'itération à calculer. On choisit ensuite "*Calculer*" dans le menu HOMARD ou à la souris. L'arbre d'études s'enrichit de fichiers d'informations et du nom du fichier au format MED qui contient le nouveau maillage, ``maill.01.med``. On remarque qu'il est placé dans le répertoire qui a été désigné à la création du cas. + +.. image:: images/intro_37.png + :align: center + +A ce stade, on va utiliser ce nouveau maillage pour un deuxième calcul, dans les mêmes conditions que le premier. Une fois que ce nouveau calcul est achevé, on peut décider de poursuivre le processus d'adaptation. Pour cela on revient dans SALOME et on active le module HOMARD. On désigne l'itération que l'avait calculée précédemment "*Iter_1*" et on demande une nouvelle itération. La fenêtre suivante apparaît : + +.. image:: images/intro_38.png + :align: center + +Comme on continue l'adaptation avec le même critère de saut de température entre noeuds voisins, on garde l'hypothèse "*Hypo_1*". Il suffit de désigner le fichier issu du calcul que l'on vient de faire et qui contient le nouveau champ de température. + +.. image:: images/intro_39.png + :align: center + +Comme précédemment, on lance l'adaptation et on récupère les résultats dans le répertoire du cas, dont le maillage ``maill.02.med``. + +.. image:: ../images/intro_40.png + :align: center + +On peut alors lancer un nouveau calcul sur ce nouveau maillage et poursuiver cette alternance calcul/adaptation jusqu'à l'obtention du résultat attendu. + + + + + + diff --git a/doc/fr/gui_create_case.rst b/doc/fr/gui_create_case.rst index bd3597a7..1390947b 100644 --- a/doc/fr/gui_create_case.rst +++ b/doc/fr/gui_create_case.rst @@ -80,6 +80,8 @@ La d .. index:: single: pyramide +.. _options_avancees: + Les options avancées """""""""""""""""""" Par défaut, aucune option avancée n'est active. diff --git a/doc/fr/index.rst b/doc/fr/index.rst index 78dec7bf..8b28e1c6 100644 --- a/doc/fr/index.rst +++ b/doc/fr/index.rst @@ -16,6 +16,7 @@ Mode d'emploi .. toctree:: :maxdepth: 1 + demarrage_rapide gui_usage tui_usage tutorials diff --git a/doc/fr/intro.rst b/doc/fr/intro.rst index a56e81d7..8b8369a8 100644 --- a/doc/fr/intro.rst +++ b/doc/fr/intro.rst @@ -21,7 +21,7 @@ HOMARD sait traiter des maillages en 2 ou 3 dimensions et comportant les mailles Ces mailles peuvent être présentes simultanément. Par exemple, HOMARD saura adapter un maillage comportant des triangles et des quadrangles. Les noeuds acceptés sont évidemment les noeuds qui sont les sommets des mailles, ce qui correspond à la description classique « en degré 1 » . Si les éléments sont décrits « en degré 2 », les noeuds complémentaires sont gérés. En revanche, il ne peut pas y avoir cohabitation de mailles décrites en degré 1 et d'autres décrites en degré 2. Enfin, HOMARD sait prendre en compte des noeuds isolés, qui n'appartiendraient à aucune définition de mailles : ils ressortiront tels quels du processus d'adaptation. -Le cas des pyramides est à part. Pour un maillage comportant des hexaèdres ou des prismes, la mise en conformité du maillage issu du raffinement crée des pyramides pour assurer la liaison entre deux régions de niveaux de raffinement différents. Ces pyramides sont gérées comme toutes les mailles de transition et ne sont pas redécoupées par la suite. En revanche, si le maillage initial contient des pyramides, HOMARD ne saura pas l'adapter et émettra un message d'erreur. Dans certains cas particuliers, on pourra néanmoins traiter un tel maillage, comme il est décrit dans la rubrique 'Options avancées' de :ref:`gui_create_case`). +Le cas des pyramides est à part. Pour un maillage comportant des hexaèdres ou des prismes, la mise en conformité du maillage issu du raffinement crée des pyramides pour assurer la liaison entre deux régions de niveaux de raffinement différents. Ces pyramides sont gérées comme toutes les mailles de transition et ne sont pas redécoupées par la suite. En revanche, si le maillage initial contient des pyramides, HOMARD ne saura pas l'adapter et émettra un message d'erreur. Dans certains cas particuliers, on pourra néanmoins traiter un tel maillage, comme il est décrit dans la rubrique :ref:`options_avancees` de la création du cas. Plusieurs motivations apparaissent pour adapter un maillage : @@ -92,84 +92,3 @@ On pourra trouver dans :ref:`applications` des exemples d'utilisations de l'adap | | +---------------------------------------------------------------+ -Démarrage rapide -"""""""""""""""" -.. index:: single: démarrage -.. index:: single: exemple - -L'ensemble des options de pilotage du module HOMARD dans SALOME est décrit dans le :ref:`gui_usage`. Mais on trouvera ici le B.A. BA pour découvrir l'utilisation de HOMARD à partir d'un exemple simple. Imaginons que l'on a effectué un calcul de thermique sur un maillage donné. On a récupéré en sortie de ce calcul un fichier au format MED, contenant le maillage et le champ des températures aux noeuds. On aimerait adapter le maillage de telle sorte que l'écart de température entre deux noeuds voisins soit inférieur à une valeur donnée. - -La première action nécessite de lancer le module HOMARD, en créant une nouvelle étude, selon le principe qui a été retenu pour tous les autres modules de SALOME. - -.. image:: images/homard_1.png - :align: center - -Une fois le module HOMARD activé, on crée un cas par le choix "*Nouveau cas*" dans le menu HOMARD. - -.. image:: images/homard_2.png - :align: center - -La fenêtre suivante apparaît : - -.. image:: images/intro_31.png - :align: center - -Il faut fournir deux informations : le répertoire qui contiendra les fichiers produits par les adaptations successives et le fichier issu du calcul que l'on vient de faire. On valide par "Appliquer et fermer". - -.. image:: images/intro_32.png - :align: center - -L'arbre d'études est enrichi de ce cas. On déplie le cas jusqu'à afficher le maillage correspondant à l'itération 0. On désigne cette itération initiale et on demande une nouvelle itération par "*Nouvelle itération*" dans le menu HOMARD ou à la souris. - -.. image:: images/intro_331.png - :align: center - -La fenêtre suivante apparaît : - -.. image:: images/intro_33.png - :align: center - -On désigne le fichier issu du calcul que l'on vient de faire et qui contient le champ de température. C'est le même que celui qui a été donné dans la définition du cas. - -.. image:: images/intro_34.png - :align: center - -On clique sur "Nouveau" dans la rubrique hypothèse. La fenêtre suivante apparaît : - -.. image:: images/intro_35.png - :align: center - -On modifie les options par défaut pour correspondre à notre choix de pilotage de l'adaptation. La sélection d'un pilotage par les saut entre éléments et d'un seuil absolu de 4.0 va demander le découpage de chaque arête de maille où le température varie de plus de 4.0 degrés entre les deux extrémités de l'arête. - -.. image:: images/intro_36.png - :align: center - -On valide par "Appliquer et fermer" cette création d'hypothése, puis la création de la nouvelle itération. On se retrouve avec un arbre d'études enrichi avec la description de l'hypothèse créée et de l'itération à calculer, repérée par une icone "en attente". - -Lancer l'adaptation s'obtient en sélectionnant l'itération à calculer. On choisit ensuite "*Calculer*" dans le menu HOMARD ou à la souris. L'arbre d'études s'enrichit de fichiers d'informations et du nom du fichier au format MED qui contient le nouveau maillage, ``maill.01.med``. On remarque qu'il est placé dans le répertoire qui a été désigné à la création du cas. - -.. image:: images/intro_37.png - :align: center - -A ce stade, on va utiliser ce nouveau maillage pour un deuxième calcul, dans les mêmes conditions que le premier. Une fois que ce nouveau calcul est achevé, on peut décider de poursuivre le processus d'adaptation. Pour cela on revient dans SALOME et on active le module HOMARD. On désigne l'itération que l'avait calculée précédemment "*Iter_1*" et on demande une nouvelle itération. La fenêtre suivante apparaît : - -.. image:: images/intro_38.png - :align: center - -Comme on continue l'adaptation avec le même critère de saut de température entre noeuds voisins, on garde l'hypothèse "*Hypo_1*". Il suffit de désigner le fichier issu du calcul que l'on vient de faire et qui contient le nouveau champ de température. - -.. image:: images/intro_39.png - :align: center - -Comme précédemment, on lance l'adaptation et on récupère les résultats dans le répertoire du cas, dont le maillage ``maill.02.med``. - -.. image:: ../images/intro_40.png - :align: center - -On peut alors lancer un nouveau calcul sur ce nouveau maillage et poursuiver cette alternance calcul/adaptation jusqu'à l'obtention du résultat attendu. - - - - - -