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 or cone. 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 three types of analytical boundary:
  75
  76   - Cylindre
  77   - Sphere
  78   - Cone, described by an axis and an angle or by two radius
  79
  80 .. note::
  81   The numerical values proposed by default take into account the geometry of the mesh.
  82
  83
  84 Cylindre
  85 ========
  86 .. index:: single: cylindre
  87
  88 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.
  89
  90 .. image:: images/create_boundary_an_cy.png
  91    :align: center
  92
  93 Sphere
  94 ======
  95 .. index:: single: sphere
  96
  97 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.
  98
  99 .. image:: images/create_boundary_an_sp.png
 100    :align: center
 101
 102 Cone
 103 ====
 104 .. index:: single: cone
 105
 106 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.
 107
 108 Creation by an origin, an axis and an angle of opening:
 109
 110 .. image:: images/create_boundary_an_co_1.png
 111    :align: center
 112
 113 Creation by two points centered on the axis and the associated radius:
 114
 115 .. image:: images/create_boundary_an_co_2.png
 116    :align: center
 117
 118 .. index:: single: object browser
 119
 120 Object browser
 121 **************
 122 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.
 123
 124 .. image:: images/create_boundary_1.png
 125    :align: center
 126
 127 Corresponding python functions
 128 ******************************
 129 Look :ref:`tui_create_boundary`
 130
 131
 132