doc/salome/gui/SMESH/input/cutting_quadrangles.doc

   1 /*!
   2
   3 \page cutting_quadrangles_page Cutting quadrangles
   4
   5 \n This operation allows cutting one or several quadrangle elements
   6 into two or four triangles.
   7
   8 <em>To cut quadrangles:</em>
   9 <ol>
  10 <li>Display a mesh, a 2D sub-mesh or a group of faces in the 3D viewer.</li>
  11 <li>In the \b Modification menu select the <b>Cutting of quadrangles</b> item or
  12 click <em>"Cutting of quadrangles"</em> button in the toolbar.
  13
  14 \image html image82.png
  15 <center><em>"Cutting of quadrangles" button</em></center>
  16
  17 The following dialog box will appear:
  18
  19 \image html a-cuttingofquadrangles.png
  20
  21 <ul>
  22 <li>The main list contains the list of quadrangles selected for cutting. You can
  23   click on an quadrangle in the 3D viewer and it will be highlighted (lock Shift
  24   keyboard button to select several quadrangles). Click \b Add button and the ID of
  25   this quadrangle will be added to the list. To remove a selected element or elements
  26   from the list click \b Remove button. <b>Sort list</b> button allows to sort the
  27   list of IDs. \b Filter button allows to apply a definite filter to the selection of
  28   quadrangles.</li>
  29 <li><b>Apply to all</b> check box allows to cut all quadrangles of the selected mesh,
  30   sub-mesh or group.</li>
  31 <li>\b Preview provides a preview of cutting in the viewer. It is disabled for <b>Cut
  32     into 4 triangles</b> as this cutting way implies no ambiguity.</li>
  33 </ul>
  34
  35 <ul>
  36 <li>\b Criterion defines a cutting way.
  37 <ul>
  38 <li><b>Cut into 4 triangles</b> selects cutting the quadrangle into four triangles by
  39   inserting a new node at the center of quadrangle. The other options selects cutting
  40   the quadrangle into two triangles by connecting nodes of either of the two diagonals.
  41 <li><b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allows to specify the
  42   opposite corners which will be connected to form two new triangles.</li>
  43 <li><b>Use numeric functor</b> allows to choose a quality metric which will be
  44   optimized when choosing a diagonal for cutting a quadrangle.
  45   <ul>
  46     <li><b>Minimum diagonal</b> cuts by the shortest diagonal.</li>
  47     <li><b>Aspect Ratio</b> cuts by the diagonal splitting the quadrangle into
  48       triangles with \ref aspect_ratio_page "Aspect Ratio" closer to 1.</li>
  49     <li><b>Minimum Angle</b> cuts by the diagonal splitting the quadrangle into
  50       triangles with \ref minimum_angle_page "Minimum Angle" closer to 60
  51       degrees.</li>
  52     <li><b>Skew</b> cuts by the diagonal splitting the quadrangle into triangles
  53       with \ref skew_page "Skew" closer to 0.0 degrees.</li>
  54   </ul>
  55 </li>
  56 </ul>
  57 </li>
  58 <li><b>Select from</b> allows to choose a sub-mesh or an existing group whose
  59   quadrangle elements will be automatically added to the main list.</li>
  60 </ul>
  61
  62 </li>
  63 <li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
  64 </ol>
  65
  66 \image html image52.jpg "The chosen quadrangular element"
  67
  68 \image html image51.jpg "Two resulting triangular elements"
  69
  70 <br><b>See Also</b> a sample TUI Script of a
  71 \ref tui_cutting_quadrangles "Cutting Quadrangles" operation.
  72
  73 */