doc/salome/gui/SMESH/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 .. _homard_create_boundary_Di:
  45
  46 Discrete boundary
  47 *****************
  48
  49 The follow-up of a discrete boundary will be made by selecting a boundary chosen in the list of the existing discrete boundaries.
  50
  51 In the starting up, the list is empty. It is necessary to create a first discrete boundary by activation of the button "*New*":
  52
  53 .. image:: ../images/create_boundary_di_1.png
  54    :align: center
  55
  56 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.
  57
  58 .. image:: ../images/create_boundary_di_2.png
  59    :align: center
  60
  61 .. note::
  62   The file has to contain only a single mesh.
  63
  64 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.
  65
  66 .. image:: ../images/create_boundary_di_3.png
  67    :align: center
  68
  69
  70
  71 .. _homard_create_boundary_An:
  72
  73 Analytical boundary
  74 *******************
  75 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.
  76
  77 .. image:: ../images/create_boundary_an_1.png
  78    :align: center
  79
  80 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.
  81
  82 .. image:: ../images/create_boundary_an_2.png
  83    :align: center
  84
  85 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.
  86
  87 .. image:: ../images/create_boundary_an_3.png
  88    :align: center
  89
  90 This operation is repeated as often as we wish to place faces of meshs on a curved surface:
  91
  92 .. image:: ../images/create_boundary_an_4.png
  93    :align: center
  94
  95 .. note::
  96
  97   A group can be checked very well never: it means that the elements which it defines belong to none of the described boundaries.
  98
  99   A group can be checked only once. Indeed, surface elements cannot belong to more than one surface.
 100
 101   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.
 102
 103   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.
 104
 105
 106 There are four types of analytical boundary:
 107
 108   - Cylindre
 109   - Sphere
 110   - Cone, described by an axis and an angle or by two radius
 111   - Torus
 112
 113 .. note::
 114   The numerical values proposed by default take into account the geometry of the mesh.
 115
 116
 117 Cylindre
 118 ========
 119 .. index:: single: cylindre
 120
 121 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.
 122
 123 .. image:: ../images/create_boundary_an_cy.png
 124    :align: center
 125
 126 Sphere
 127 ======
 128 .. index:: single: sphere
 129
 130 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.
 131
 132 .. image:: ../images/create_boundary_an_sp.png
 133    :align: center
 134
 135 Cone
 136 ====
 137 .. index:: single: cone
 138
 139 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.
 140
 141 Creation by an origin, an axis and an angle of opening:
 142
 143 .. image:: ../images/create_boundary_an_co_1.png
 144    :align: center
 145
 146 Creation by two points centered on the axis and the associated radius:
 147
 148 .. image:: ../images/create_boundary_an_co_2.png
 149    :align: center
 150
 151 .. index:: single: object browser
 152
 153 Torus
 154 =====
 155 .. index:: single: torus
 156
 157 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.
 158
 159 .. image:: ../images/create_boundary_an_to.png
 160    :align: center