doc/en/gui_create_hypothese.rst

   1 .. _gui_create_hypothese:
   2
   3 The hypothesis
   4 ##############
   5 .. index:: single: hypothesis
   6
   7 The hypothesis contains all parameters of driving of a mesh adaptation. This operation allows to realize the iteration to which it is attached.
   8
   9 There are three classes of hypotheses:
  10
  11   - Uniform over the whole mesh,
  12   - According to a field,
  13   - According to geometrical zone.
  14
  15 .. image:: images/create_hypothese_1.png
  16    :align: center
  17
  18
  19 Name of the hypothesis
  20 **********************
  21 A name of the hypothesis is automatically proposed: Hypo_1, Hypo_2, etc. This name can be modified. It must not have been used for a previous hypothesis.
  22
  23 Uniform adaptation
  24 ******************
  25 By default we propose a uniform refinement. When the starting point is a mesh which was already refined, the option of unrefinement will eliminate the produced elements.
  26
  27 Adaptation by a field
  28 *********************
  29
  30 .. note::
  31   To be able to adapt the mesh according to a field it is beforehand necessary to have indicated the file med containing the field. It is made in the window of construction of the iteration (see :ref:`gui_create_iteration`). The name of the file which was selected is shown without possible modification here:
  32
  33 .. image:: images/create_hypothese_ch_1.png
  34    :align: center
  35
  36 The deliberate field is to be chosen in the list of fields contained in the file.
  37 Once this field was chosen, the list of its components is displayed. It is enough to indicate the wished component(s).
  38
  39 If we choose a single component, by default, it is the absolute value which will be used, but it is possible to use the relative value. In the case of several components, by default HOMARD will use the L2 norm (Euclidian). We can however choose the infinite norm (the max of the absolute values of the components).
  40
  41 We can choose not to use directly the field, but its variation from an element to its neighbors. For that purpose, we shall check the button "*Jump between elements*".
  42
  43 .. image:: images/create_hypothese_ch_2.png
  44    :align: center
  45
  46 The refinement is made according to a threshold which defines a high criterion of refinement. All the elements for which the indicator is upper to this criterion will be refined.
  47 For the choice of the criterion, four variants are possible:
  48
  49   - According to a percentage of elements to be refined, real number included between 0 and 100; HOMARD will refine x% of the elements which have the biggest value of the field.
  50   - According to a relative value of the field, the number included between 0 and 100; HOMARD will refine the elements where the field is upper in x% of the interval [mini, maxi].
  51   - Beyond an absolute value; all the elements with a value of field superior to this value will be refined.
  52   - Beyond an absolute value that is equal to the average of the mean of the field increased of n times its standard deviation; all the elements with a value of field superior to this value will be refined.
  53
  54 The same convention applies to the unrefinement, the by replacing upper by lower. We can inactivate one of the functions (refinement or unrefinement) by checking the button ad_hoc.
  55
  56 .. image:: images/create_hypothese_ch_3.png
  57    :align: center
  58
  59
  60 Adaptation by a zone
  61 ********************
  62 .. index:: single: zone
  63
  64 In the starting up, it is necessary to create a first zone by activation of the button "*New*" (see :ref:`gui_create_zone`) :
  65
  66 .. image:: images/create_hypothese_zo_1.png
  67    :align: center
  68
  69 When zones were already created, the list appears in the window, what allows to select the deliberate zones. We then have to specify if a zone is used to refine all the elements a edge of which is contained in the zone, or if the zone is used for unrefine the internal elements in the zone. If no choice is made, the zone is ignored in this hypothesis.
  70
  71 .. image:: images/create_hypothese_zo_2.png
  72    :align: center
  73
  74
  75 Filtering by the groups
  76 ***********************
  77 .. index:: single: group
  78
  79 We can restrict the application of the hypothesis of adaptation to groups. So elements not belonging to these groups will not be modified, except by later contamination of the refinement to assure the conformity of the final mesh.
  80 We check the associated button:
  81
  82 .. image:: images/create_hypothese_gr_1.png
  83    :align: center
  84
  85 The list of the present groups of elements in the mesh is shown. It is enough to check those wanted to restrict the hypothesis of adaptation.
  86
  87 .. image:: images/create_hypothese_gr_2.png
  88    :align: center
  89
  90
  91 Interpolation of fields
  92 ***********************
  93 .. index:: single: interpolation
  94
  95 .. note::
  96   To be able to interpolate a field from the former towards the new mesh, it is beforehand necessary to have indicated the file med containing the field. It is made in the window of construction of the iteration (see :ref:`gui_create_iteration`).
  97
  98 By default, no field is interpolated. On the contrary, we can ask for the interpolation of all the present fields in the supplied file:
  99
 100 .. image:: images/create_hypothese_ch_4.png
 101    :align: center
 102
 103 If we want to choose fields to be interpolated, it is necessary to check them in the list of all the present fields in the supplied file:
 104
 105 .. image:: images/create_hypothese_ch_5.png
 106    :align: center
 107
 108
 109 Advanced options
 110 ****************
 111 If the compartment "*Advanced Options*" is not checked, no additional constraint is defined.
 112 If the compartment is checked, we shall define the advanced options.
 113
 114 A first series of options concern the maximal sharpness of mesh which we do not want to exceed. Two directives are possible, separately or together. We can impose a size of minimal element: a element the diameter of which is lower than this limit will not be any more split. By default, we propose a minimal 0 diameter, what means imposing nothing. We can impose a level of maximal refinement. By default, the maximum is 99, what amounts generally to impose nothing.
 115
 116 The second series of options has interest only in case the adaptation is driven by a field and in case this field is not defined everywhere in the mesh. It arrives for example when we build a field based on a distance in a plan while the domain is 3D: the field will not be defined on nodes outside the plan. For such fields, this option allows to specify the behavior which we wish in the regions where the field is not defined. By default, there is nothing: elements are kept as they are. We can choose two other variants: to refine all the elements will a priori be cut, or to unrefine all the elements will be candidate in the unrefinement.
 117
 118 The last choice concerns an additional output of the adaptation. By default, nothing is checked and no field is produced. If at least one compartment is checked, the output file MED will contain some extra fields. The first choice represents the level of refinement of every element. The convention is the one of HOMARD: an element of the initial mesh is of level 0, an element produced by the refinement of an initial element carries the level 1, etc. The elements of transition which are produced between two different levels, n and n+1, are affected by the half-level n+0,5. The second choice is for the quality of the elements. The third choice is for the diameters of the elements.
 119
 120 .. image:: images/create_hypothese_av_1.png
 121    :align: center
 122
 123 Object browser
 124 **************
 125 .. index:: single: object browser
 126
 127 The object browser contains the created hypotheses and the iterations which use them. The description of the zones which are possibly attached to them is present.
 128
 129 .. image:: images/create_hypothese_2.png
 130    :align: center
 131
 132
 133
 134 Corresponding python functions
 135 ******************************
 136 Look :ref:`tui_create_hypothese`