doc/gui/input/homard_create_boundary.rst

   1 .. _homard_create_boundary:
   2
   3 The boundary
   4 ############
   5 .. index:: single: boundary
   6 .. index:: single: frontière
   7 .. index:: single: CAO
   8
   9 The object boundary contains all the geometrical definitions allowing to describe a curved boundary to be followed.
  10
  11 There are two modes of description of a boundary:
  12
  13   - CAO: the boundary comes from the geometry of the domain
  14   - Non CAO: if the CAO is not available, the boundary can be approximated by its descriptions:
  15
  16     * Discrete: to describe the set of 1D curves that defines the boundary
  17     * Analytics: to describe every surface that defines the boundary
  18
  19 This choice is:
  20
  21 .. image:: ../images/create_boundary_1.png
  22    :align: center
  23
  24 .. _homard_create_boundary_CAO:
  25
  26 CAO boundary
  27 ************
  28
  29 The follow-up of a CAO boundary will be made by selecting a boundary chosen in the list of the existing CAO boundaries.
  30
  31 In the starting up, the list is empty. It is necessary to create a first CAO boundary by activation of the button "*New*":
  32
  33 .. image:: ../images/create_boundary_cao_1.png
  34    :align: center
  35
  36 The window invites in the choice of a file that contains the CAO with XAO format. This CAO is the one that is the basis for the initial mesh. A name of boundary is automatically proposed: Boun_1, Boun_2, etc. This name can be modified. It must not already have been used for another boundary, whatever its type.
  37
  38 .. image:: ../images/create_boundary_cao_2.png
  39    :align: center
  40
  41 .. note::
  42   The coherence between this CAO and the initial mesh is not checked.
  43
  44 Filtering by the groups
  45 ***********************
  46 .. index:: single: group
  47
  48 We can restrict the application of the boundary to groups. So elements not belonging to these groups will not be affected. We check the associated button **Filtering with groups**. The list of the present groups of elements in the mesh is shown. It is enough to check those wanted to restrict the boundary.
  49
  50 .. image:: ../images/adaptation_with_homard_boundary_groups.png
  51    :align: center
  52
  53 .. _homard_create_boundary_Di:
  54
  55 Discrete boundary
  56 *****************
  57
  58 The follow-up of a discrete boundary will be made by selecting a boundary chosen in the list of the existing discrete boundaries.
  59
  60 In the starting up, the list is empty. It is necessary to create a first discrete boundary by activation of the button "*New*":
  61
  62 .. image:: ../images/create_boundary_di_1.png
  63    :align: center
  64
  65 The window invites in the choice of a file of mesh. This mesh is the one of all the lines constituting the boundary. A name of boundary is automatically proposed: Boun_1, Boun_2, etc. This name can be modified. It must not already have been used for another boundary, whatever its type.
  66
  67 .. image:: ../images/create_boundary_di_2.png
  68    :align: center
  69
  70 .. note::
  71   The file has to contain only a single mesh.
  72
  73 If discrete boundaries were already defined for another case, we can select one of them. We can also create a new discrete boundary by activation of the button "*New*", as explained previously.
  74
  75 .. image:: ../images/create_boundary_di_3.png
  76    :align: center
  77
  78
  79
  80 .. _homard_create_boundary_An:
  81
  82 Analytical boundary
  83 *******************
  84 In the starting up, SALOME shows a table with one only one column. This column contains the list of all the groups of the initial mesh defining the case.
  85
  86 .. image:: ../images/create_boundary_an_1.png
  87    :align: center
  88
  89 It is necessary to create a first analytical boundary by activation of the button "*New*". We shall have the choice between cylinder, sphere, cone or torus. When the boundary will be validated, its name will appear in header of the second column.
  90
  91 .. image:: ../images/create_boundary_an_2.png
  92    :align: center
  93
  94 It is now necessary to establish the link enter the mesh defining the case and this boundary described analytically. It is made by checking the groups of the faces which have to be on the boundary.
  95
  96 .. image:: ../images/create_boundary_an_3.png
  97    :align: center
  98
  99 This operation is repeated as often as we wish to place faces of meshs on a curved surface:
 100
 101 .. image:: ../images/create_boundary_an_4.png
 102    :align: center
 103
 104 .. note::
 105
 106   A group can be checked very well never: it means that the elements which it defines belong to none of the described boundaries.
 107
 108   A group can be checked only once. Indeed, surface elements cannot belong to more than one surface.
 109
 110   Several groups can be checked for the same boundary. It occurs if the initial mesh of the zone was subdivided into several groups: all the surface elements belong to this surface but were distributed in several groups.
 111
 112   Conversely, a boundary can be very well retained by no group. It occurs if it was defined for a previous case and if it is groundless for the case in the course of definition.
 113
 114
 115 There are four types of analytical boundary:
 116
 117   - Cylindre
 118   - Sphere
 119   - Cone, described by an axis and an angle or by two radius
 120   - Torus
 121
 122 .. note::
 123   The numerical values proposed by default take into account the geometry of the mesh.
 124
 125
 126 Cylindre
 127 ========
 128 .. index:: single: cylindre
 129
 130 The cylinder is defined by a point of the axis, its axis and its radius. The axis is defined by a vector. The standard of this vector is not inevitably equal to 1; also, its orientation has no importance. A name of boundary is automatically proposed: Boun_1, Boun_2, etc. This name can be modified. It must not already have been used for another boundary, whatever its type.
 131
 132 .. image:: ../images/create_boundary_an_cy.png
 133    :align: center
 134
 135 Sphere
 136 ======
 137 .. index:: single: sphere
 138
 139 The sphere is defined by its center and its radius. A name of boundary is automatically proposed: Boun_1, Boun_2, etc. This name can be modified. It must not already have been used for another boundary, whatever its type.
 140
 141 .. image:: ../images/create_boundary_an_sp.png
 142    :align: center
 143
 144 Cone
 145 ====
 146 .. index:: single: cone
 147
 148 A cone is defined by two different manners: the center, the axis and the angle of opening in degree or by two points centered on the axis and the associated radius. A name of boundary is automatically proposed: Boun_1, Boun_2, etc. This name can be modified. It must not already have been used for another boundary, whatever its type.
 149
 150 Creation by an origin, an axis and an angle of opening:
 151
 152 .. image:: ../images/create_boundary_an_co_1.png
 153    :align: center
 154
 155 Creation by two points centered on the axis and the associated radius:
 156
 157 .. image:: ../images/create_boundary_an_co_2.png
 158    :align: center
 159
 160 .. index:: single: object browser
 161
 162 Torus
 163 =====
 164 .. index:: single: torus
 165
 166 The torus is defined by its centre, its axis, the revolution radius and the primary radius. The axis is defined by a vector. The standard of this vector is not inevitably equal to 1; also, its orientation has no importance. A name of boundary is automatically proposed: Boun_1, Boun_2, etc. This name can be modified. It must not already have been used for another boundary, whatever its type.
 167
 168 .. image:: ../images/create_boundary_an_to.png
 169    :align: center