doc/en/demarrage_rapide.rst

   1 .. _demarrage_rapide:
   2
   3 Quick start
   4 ###########
   5 .. index:: single: start
   6 .. index:: single: example
   7
   8 The options to drive HOMARD in SALOME are described into :doc:`gui_usage`. Here are the basic instructions to discover how to use HOMARD from a very simple example.
   9
  10 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.
  11
  12 First, the module HOMARD is launched, by the creation of a new study; the same method as for the other modules of SALOME.
  13
  14 .. image:: images/homard_1.png
  15    :align: center
  16
  17 Once the activation of the module HOMARD is done, a case is created with the choice "*New case*" into the menu.
  18
  19 .. image:: images/homard_2.png
  20    :align: center
  21
  22 This window appears:
  23
  24 .. image:: images/intro_31.png
  25    :align: center
  26
  27 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. In this case, the default options are left unchanged: conformity of the mesh and no curved boundaries. Validate by "OK".
  28
  29 .. image:: images/intro_32.png
  30    :align: center
  31
  32 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.
  33
  34 .. image:: images/intro_331.png
  35    :align: center
  36
  37 This window appears:
  38
  39 .. image:: images/intro_33.png
  40    :align: center
  41
  42 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.
  43
  44 .. image:: images/intro_34.png
  45    :align: center
  46
  47 Click "New" into the 'hypothesis' part. This window appears:
  48
  49 .. image:: images/intro_35.png
  50    :align: center
  51
  52 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.
  53
  54 .. image:: images/intro_36.png
  55    :align: center
  56
  57 The creation of the hypothesis is validated by "OK"; 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".
  58
  59 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.
  60
  61 .. image:: images/intro_37.png
  62    :align: center
  63
  64 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 last iteration "*Iter_1*" is selected and a new iteration is asked for. This window appears:
  65
  66 .. image:: images/intro_38.png
  67    :align: center
  68
  69 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.
  70
  71 .. image:: images/intro_39.png
  72    :align: center
  73
  74 As before, the iteration is computed and the results are found into the directory of the case, including the mesh ``maill.02.med``.
  75
  76 .. image:: ../images/intro_40.png
  77    :align: center
  78
  79 A new calculation can be launched over this new mesh. The alternation computation/adaptation is done until the final result.