doc/en/tui_create_boundary.rst

   1 .. _tui_create_boundary:
   2
   3 The boundary
   4 ############
   5
   6 .. index:: single: boundary
   7 .. index:: single: cylinder
   8 .. index:: single: sphere
   9
  10 The variables are described in :ref:`gui_create_boundary`.
  11
  12 Methods of the class homard
  13 ***************************
  14 These methods returns an instance of the class boundary.
  15
  16 +----------------------------------------------------------------------------------------+
  17 +----------------------------------------------------------------------------------------+
  18 | .. module:: CreateBoundaryDi                                                           |
  19 |                                                                                        |
  20 | **CreateBoundaryDi(boundary_name, mesh_name, mesh_file)**                              |
  21 |     Returns an instance of the class ``boundary``, type discrete after its creation    |
  22 |                                                                                        |
  23 |     - ``boundary_name``: the name of the discrete boundary                             |
  24 |     - ``mesh_name``: the name of the mesh of the boundary                              |
  25 |     - ``mesh_file``: the name of the file for this mesh                                |
  26 +----------------------------------------------------------------------------------------+
  27 | .. module:: CreateBoundaryCylinder                                                     |
  28 |                                                                                        |
  29 | **CreateBoundaryCylinder(boundary_name, Xcen, Ycen, Zcen, Xaxe, Yaxe, Zaxe, R)**       |
  30 |     Returns an instance of the class ``boundary`` analytical type cylindrical          |
  31 |     after its creation                                                                 |
  32 |                                                                                        |
  33 |     - ``boundary_name``: the name of the analytical boundary based on a cylinder       |
  34 |     - ``Xcen``, ``Ycen``, ``Zcen``: coordinates of a point on the axis of the cylinder |
  35 |     - ``Xaxe``, ``Yaxe``, ``Zaxe``: vector of the axis                                 |
  36 |     - ``R``: radius of the cylinder                                                    |
  37 +----------------------------------------------------------------------------------------+
  38 | .. module:: CreateBoundarySphere                                                       |
  39 |                                                                                        |
  40 | **CreateBoundarySphere(boundary_name, Xcen, Ycen, Zcen, R)**                           |
  41 |     Returns an instance of the class ``boundary`` analytical type spherical            |
  42 |     after its creation                                                                 |
  43 |                                                                                        |
  44 |     - ``boundary_name``: the name of the boundary analytique based on a sphere         |
  45 |     - ``Xcen``, ``Ycen``, ``Zcen``: coordinates of the centre of the sphere            |
  46 |     - ``R``: radius of the sphere                                                      |
  47 +----------------------------------------------------------------------------------------+
  48 | .. module:: CreateBoundaryConeA                                                        |
  49 |                                                                                        |
  50 | **CreateBoundaryConeA(boundary_name, Xaxe, Yaxe, Zaxe, Angle, Xcen, Ycen, Zcen)**      |
  51 |     Returns an instance of the class ``boundary`` analytical type conical              |
  52 |     after its creation                                                                 |
  53 |                                                                                        |
  54 |     - ``boundary_name``: the name of the boundary analytique based on a cone           |
  55 |     - ``Xaxe``, ``Yaxe``, ``Zaxe``: vector of the axis                                 |
  56 |     - ``Angle``: opening angle of the cone in degree (between 0 and 90)                |
  57 |     - ``Xcen``, ``Ycen``, ``Zcen``: coordinates of the centre of the cone              |
  58 +----------------------------------------------------------------------------------------+
  59 | .. module:: CreateBoundaryConeR                                                        |
  60 |                                                                                        |
  61 | **CreateBoundaryConeR(boundary_name, Xc1, Yc1, Zc1, R1, Xc2, Yc2, Zc2, R2)**           |
  62 |     Returns an instance of the class ``boundary`` analytical type conical              |
  63 |     after its creation                                                                 |
  64 |                                                                                        |
  65 |     - ``boundary_name``: the name of the boundary analytique based on a cone           |
  66 |     - ``Xc1``, ``Yc1``, ``Zc1``: coordinates of the first centre of the cone           |
  67 |     - ``R1``: radius of the cone at the first centre of the cone                       |
  68 |     - ``Xc2``, ``Yc2``, ``Zc2``: coordinates of the second centre of the cone          |
  69 |     - ``R2``: radius of the cone at the second centre of the cone                      |
  70 +----------------------------------------------------------------------------------------+
  71
  72 +---------------------------------------------------------------+
  73 +---------------------------------------------------------------+
  74 | .. module:: GetBoundary                                       |
  75 |                                                               |
  76 | **GetBoundary(boundary_name)**                                |
  77 |     Returns the instance of the class classe ``boundary``     |
  78 |     known by its name                                         |
  79 |                                                               |
  80 |     - ``boundary_name``: the name of the boundary             |
  81 +---------------------------------------------------------------+
  82 | .. module:: GetAllBoundarysName                               |
  83 |                                                               |
  84 | **GetAllBoundarysName()**                                     |
  85 |     Returns the list of the names of all the existing         |
  86 |     boundaries                                                |
  87 |                                                               |
  88 +---------------------------------------------------------------+
  89
  90 Methods of the class cas
  91 ************************
  92 See also in :ref:`tui_create_case`.
  93
  94 +---------------------------------------------------------------+
  95 +---------------------------------------------------------------+
  96 | .. module:: AddBoundaryGroup                                  |
  97 |                                                               |
  98 | **AddBoundaryGroup(boundary, group)**                         |
  99 |     Add a boundary to the definition of a case                |
 100 |                                                               |
 101 |     - ``boundary``: name of the curved boundary               |
 102 |                                                               |
 103 |     Discrete boundary:                                        |
 104 |                                                               |
 105 |     . if all the curved lines are involved, the second        |
 106 |     argument is an empty string.                              |
 107 |                                                               |
 108 |     . if only some curved lines are involved, ``group`` is    |
 109 |     the name of the group of segments                         |
 110 |                                                               |
 111 |     Analytical boundary:                                      |
 112 |                                                               |
 113 |     - ``group``: name of the groupe of faces located on the   |
 114 |       boundary                                                |
 115 +---------------------------------------------------------------+
 116
 117 Methods of the class boundary
 118 *****************************
 119
 120 +---------------------------------------------------------------+
 121 +---------------------------------------------------------------+
 122 | .. module:: GetName                                           |
 123 |                                                               |
 124 | **GetName()**                                                 |
 125 |     Returns the name of the boundary                          |
 126 +---------------------------------------------------------------+
 127 | .. module:: GetType                                           |
 128 |                                                               |
 129 | **GetType()**                                                 |
 130 |     Returns the type of the boundary:                         |
 131 |                                                               |
 132 |         * 0: discrete                                         |
 133 |         * 1: cylinder                                         |
 134 |         * 2: sphere                                           |
 135 |         * 3: cone defined by an axis and an angle             |
 136 |         * 4: cone defined by 2 radius                         |
 137 +---------------------------------------------------------------+
 138 | .. module:: GetCoords                                         |
 139 |                                                               |
 140 | **GetCoords()**                                               |
 141 |     Returns the array of the coordinates of the boundary      |
 142 |     with the same order as in its definition with             |
 143 |     CreateBoundaryXXXX                                        |
 144 +---------------------------------------------------------------+
 145 | .. module:: Delete                                            |
 146 |                                                               |
 147 | **Delete()**                                                  |
 148 |     Deletes the boundary.                                     |
 149 |     If the boundary is discrete, the file of the mesh is kept.|
 150 |                                                               |
 151 |     Returns an integer:                                       |
 152 |         * 0: the destruction is done                          |
 153 |         * other value: problem                                |
 154 +---------------------------------------------------------------+
 155
 156
 157 Example
 158 *******
 159 Creation of a discrete boundary, a spherical boundary, and a cylindrical boundary:
 160 ::
 161
 162     inter = homard.CreateBoundaryDi("INTERSECTION", 'PIQUAGE', dircase+'/tutorial_4.fr.med')
 163     fron_1 = homard.CreateBoundarySphere("FRON_1", 12.3, 3.4, .56, 6.5)
 164     fron_2 = homard.CreateBoundaryCylinder('CYL_1', 0.0, 25., -25., 25., 50., 75., 100.)
 165
 166
 167 Similar graphical input
 168 ***********************
 169 Look at :ref:`gui_create_boundary`