doc/gui_create_hypothese_en.rst

   1 .. _gui_create_hypothese_en:
   2
   3 The hypothesis
   4 ==============
   5 .. index:: single: hypothesis
   6
   7 L'hypothesis contient toutes les paramètres de pilotage d'une adaptation d'un maillage. Cette opération permet de réaliser l'itération à laquelle elle est attachée.
   8
   9 Il existe trois classes d'hypotheses :
  10
  11   - Uniforme sur tout le maillage,
  12   - Selon un champ,
  13   - En fonction de zone géométrique.
  14
  15 .. image:: images/create_hypothese_1.png
  16    :align: center
  17
  18
  19 Name of the hypothesis
  20 """"""""""""""""""""""
  21 Un nom de l'hypothesis est proposé automatiquement : Hypo_1, Hypo_2, etc. Ce nom peut être modifié. Il ne doit pas asee été utilisé pour une hypothesis précédente.
  22
  23 Uniform adaptation
  24 """"""""""""""""""
  25 Par défaut on propose un raffinement uniforme. Quand on part d'un maillage qui a déjà été raffiné, l'option de déraffinement supprimera les mailles produites.
  26
  27 Adaptation by a field
  28 """""""""""""""""""""
  29
  30 .. note::
  31   Pour pousee adapter le maillage selon un champ il faut asee au préalable désigné le fichier med contenant le champ. Cela se fait dans la fenêtre de construction de l'itération (see :ref:`gui_create_iteration_en`). Le nom du fichier qui a été sélectionné est affiché sans modification possible ici :
  32
  33 .. image:: images/create_hypothese_ch_1.png
  34    :align: center
  35
  36 Le champ voulu est à choisir dans la liste des champs contenus dans le fichier.
  37 Une fois ce champ choisi, la liste des ses composantes s'affiche. Il suffit de désigner la (ou les) composantes désirées.
  38
  39 Si l'on choisit une seule composante, par défaut, c'est sa valeur absolue qui sera utilisée, mais il est possible d'utiliser la valeur relative. Dans le cas de plusieurs composantes, par défaut HOMARD utilisera la norme L2 (euclidienne). On peut toutefois choisir d'utiliser la norme infinie (le max des valeurs absolues des composantes).
  40
  41 On peut choisir de ne pas utiliser directement le champ, mais sa variation d'un élément à ses voisins. Pour cela, on activera le bouton "*Saut entre éléments*".
  42
  43 .. image:: images/create_hypothese_ch_2.png
  44    :align: center
  45
  46
  47 Le raffinement se fait selon un seuil qui définit un critère haut de raffinement. Toutes les mailles pour lesquelles l'indicateur est supérieur à ce critère seront raffinées.
  48 Pour le choix du critère, quatre variantes sont possible :
  49
  50   - selon un pourcentage de mailles à raffiner, nombre réel compris entre 0 et 100 ; HOMARD raffinera les x% des mailles qui ont la plus grande valeur du champ.
  51   - selon une valeur relative du champ, nombre compris entre 0 et 100 ; HOMARD raffinera les mailles où le champ est supérieur à x% de l'intervalle [mini,maxi].
  52   - au dela d'une valeur absolue ; toutes les mailles avec une valeur de champ supérieure à cette valeur seront raffinées.
  53   - au dela d'une valeur absolue valant la moyenne de la répartition du champ augmentée de n fois son écart-type ; toutes les mailles avec une valeur de champ supérieure à cette valeur seront raffinées.
  54
  55 La même convention s'applique au déraffinement, en remplaçant supérieur par inférieur. On peut inactiver une des fonctions (raffinement ou déraffinement) en cochant le bouton ad_hoc.
  56
  57 .. image:: images/create_hypothese_ch_3.png
  58    :align: center
  59
  60
  61 Adaptation by a zone
  62 """"""""""""""""""""
  63 .. index:: single: zone
  64
  65 Au démarrage, il faut créer une première zone par activation du bouton "*Nouveau*" (see :ref:`gui_create_zone_en`) :
  66
  67 .. image:: images/create_hypothese_zo_1.png
  68    :align: center
  69
  70 Lorsque des zones ont déjà été créées, la liste apparaît dans la fenêtre, ce qui permet de sélectionner les zones voulues. On doit alors préciser si une zone est utilisée pour raffiner toutes les mailles dont une arête est contenue dans la zone, ou si la zone est utilisée pour déraffiner les mailles intérieures à la zone. Si aucun choix n'est fait, la zone est ignorée dans cette hypothesis.
  71
  72 .. image:: images/create_hypothese_zo_2.png
  73    :align: center
  74
  75
  76 Filtering by the groups
  77 """""""""""""""""""""""
  78 .. index:: single: group
  79
  80 On peut restreindre l'application de l'hypothesis d'adaptation à des groupes. Ainsi les mailles n'appartenant pas à ces groupes ne seront pas modidiées, sauf par contamination ultérieure du raffinement pour assurer la conformité du maillage final.
  81 On coche le bouton associé :
  82
  83 .. image:: images/create_hypothese_gr_1.png
  84    :align: center
  85
  86 La liste des groupes de mailles présents dans le maillage est affichée. Il suffit de cocher ceux voulus pour restreindre l'hypothesis d'adaptation.
  87
  88 .. image:: images/create_hypothese_gr_2.png
  89    :align: center
  90
  91
  92 Interpolation of fields
  93 """""""""""""""""""""""
  94 .. index:: single: interpolation
  95
  96 .. note::
  97   Pour pousee interpoler un champ de l'ancien vers le nouveau maillage, il faut asee au préalable désigné le fichier med contenant le champ. Cela se fait dans la fenêtre de construction de l'itération (see :ref:`gui_create_iteration_en`).
  98
  99 Par défaut, aucun champ n'est interpolé. A contrario, on peut demander l'interpolation de tous les champs présents dans le fichier fourni :
 100
 101 .. image:: images/create_hypothese_ch_4.png
 102    :align: center
 103
 104 Si on veut choisir les champs à interpoler, il faut les cocher dans la liste de tous les champs présents dans le fichier fourni :
 105
 106 .. image:: images/create_hypothese_ch_5.png
 107    :align: center
 108
 109
 110 Advanced options
 111 """"""""""""""""
 112 Si la case "Options avancées" n'est pas cochée, aucune contrainte supplémentaire n'est définie.
 113 Si la case est cochée, on définira les options avancées.
 114
 115 Une première série d'options portent sur la finesse maximale de maillage que l'on ne veut pas dépasser. Deux directives sont possibles, séparément ou ensemble. On peut imposer une taille de maille minimale : une maille dont le diamètre est inférieur à cette limite ne sera plus découpée. Par défaut, on propose un diamètre minimal nul, ce qui revient à ne rien imposer. On peut imposer un niveau de raffinement maximal. Par défaut, le maximum est à 99, ce qui équivaut en général à ne rien imposer.
 116
 117 La deuxième série d'options n'a d'intérêt que dans le cas où l'adaptation est piloté par un champ et que ce champ n'est pas défini partout dans le maillage. Cela arrive par exemple quand on construit un champ basé sur une distance dans un plan alors que le domaine est 3D : le champ ne sera pas défini sur les noeuds hors du plan. Pour de tels champs, cette option permet de préciser le comportement que l'on souhaite dans les régions où le champ n'est pas défini. Par défaut, il ne se passe rien : les mailles sont gardées telles quelles. On peut choisir les deux autres variantes : raffiner, toutes les mailles seront a priori coupées, ou déraffiner, toutes les mailles seront candidates au déraffinement.
 118
 119 Le dernier choix porte sur une sortie supplémentaire de l'adaptation. Si la case est cochée, le fichier MED en sortie contiendra un champ contenant le niveau de raffinement de chaque maille. La convention est celle de HOMARD : une maille du maillage initial est de niveau 0, une maille issue d'un raffinement d'une maille initiale porte le niveau 1, etc. Les mailles de transition qui sont produites entre deux mailles de niveau différents, n et n+1, sont affectées du demi-niveau n+0,5. Par défaut, la case n'est pas cochée et le champ n'est pas produit.
 120
 121 .. image:: images/create_hypothese_av_1.png
 122    :align: center
 123
 124 Object browser
 125 """"""""""""""
 126 .. index:: single: object browser
 127
 128 L'arbre d'études contient les hypotheses créées et les itérations qui les utilisent. La description des zones qui leur sont éventuellement attachées est présente.
 129
 130 .. image:: images/create_hypothese_2.png
 131    :align: center
 132
 133
 134
 135 Corresponding python functions
 136 """"""""""""""""""""""""""""""
 137 Look :ref:`tui_create_hypothese_en`