doc/en/gui_create_boundary.rst

   1 .. _gui_create_boundary:
   2
   3 The boundary
   4 ############
   5 .. index:: single: boundary
   6 .. index:: single: frontière
   7
   8 The object boundary contains all the geometrical definitions allowing to describe a curved boundary to be followed.
   9
  10 There are two modes of description of a boundary:
  11
  12   - Discrete: this mode is used to describe a curve 1D
  13   - Analytics: this mode is used to describe a surface
  14
  15
  16 Discrete boundary
  17 *****************
  18
  19 The follow-up of a discrete boundary will be made by selecting a boundary chosen in the list of the existing discrete boundaries.
  20
  21 In the starting up, the list is empty. It is necessary to create a first discrete boundary by activation of the button "*New*" :
  22
  23 .. image:: images/create_boundary_di_1.png
  24    :align: center
  25
  26 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.
  27
  28 .. image:: images/create_boundary_di_2.png
  29    :align: center
  30
  31 .. note::
  32   The file has to contain only a single mesh.
  33
  34 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.
  35
  36 .. image:: images/create_boundary_di_3.png
  37    :align: center
  38
  39
  40
  41 Analytical boundary
  42 *******************
  43 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.
  44
  45 .. image:: images/create_boundary_an_1.png
  46    :align: center
  47
  48 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.
  49
  50 .. image:: images/create_boundary_an_2.png
  51    :align: center
  52
  53 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.
  54
  55 .. image:: images/create_boundary_an_3.png
  56    :align: center
  57
  58 This operation is repeated as often as we wish to place faces of meshs on a curved surface:
  59
  60 .. image:: images/create_boundary_an_4.png
  61    :align: center
  62
  63 .. note::
  64
  65   A group can be checked very well never: it means that the elements which it defines belong to none of the described boundaries.
  66
  67   A group can be checked only once. Indeed, surface elements cannot belong to more than one surface.
  68
  69   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.
  70
  71   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.
  72
  73
  74 There are four types of analytical boundary:
  75
  76   - Cylindre
  77   - Sphere
  78   - Cone, described by an axis and an angle or by two radius
  79   - Torus
  80
  81 .. note::
  82   The numerical values proposed by default take into account the geometry of the mesh.
  83
  84
  85 Cylindre
  86 ========
  87 .. index:: single: cylindre
  88
  89 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.
  90
  91 .. image:: images/create_boundary_an_cy.png
  92    :align: center
  93
  94 Sphere
  95 ======
  96 .. index:: single: sphere
  97
  98 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.
  99
 100 .. image:: images/create_boundary_an_sp.png
 101    :align: center
 102
 103 Cone
 104 ====
 105 .. index:: single: cone
 106
 107 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.
 108
 109 Creation by an origin, an axis and an angle of opening:
 110
 111 .. image:: images/create_boundary_an_co_1.png
 112    :align: center
 113
 114 Creation by two points centered on the axis and the associated radius:
 115
 116 .. image:: images/create_boundary_an_co_2.png
 117    :align: center
 118
 119 .. index:: single: object browser
 120
 121 Torus
 122 =====
 123 .. index:: single: torus
 124
 125 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.
 126
 127 .. image:: images/create_boundary_an_to.png
 128    :align: center
 129
 130 Object browser
 131 **************
 132 At the end of this creation of boundaries, the object browser was enriched. We find all the boundaries created, identified there by their name, with the possibility of editing them.
 133
 134 .. image:: images/create_boundary_1.png
 135    :align: center
 136
 137 Corresponding python functions
 138 ******************************
 139 Look :doc:`tui_create_boundary`
 140
 141
 142