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

   1 /*!
   2
   3 \page cutting_quadrangles_page Cutting quadrangles
   4
   5 \n This operation allows to cut one or several quadrangle elements by
   6 addition of a supplementary edge which will connect two opposite
   7 corners.
   8
   9 <em>To cut quadrangles:</em>
  10 <ol>
  11 <li>Display a mesh or a sub-mesh in the 3D viewer.</li>
  12 <li>In the \b Modification menu select the <b>Cutting of quadrangles</b> item or
  13 click <em>"Cutting of quadrangles"</em> button in the toolbar.
  14
  15 \image html image82.png
  16 <center><em>"Cutting of quadrangles" button</em></center>
  17
  18 The following dialog box will appear:
  19
  20 \image html a-cuttingofquadrangles.png
  21
  22 \par
  23 <ul>
  24 <li>The main list contains the list of quadrangles. You can click on
  25 an quadrangle in the 3D viewer and it will be highlighted (lock Shift
  26 keyboard button to select several quadrangles). Click \b Add button and
  27 the ID of this quadrangle will be added to the list. To remove a
  28 selected element or elements from the list click \b Remove button. <b>Sort
  29 list</b> button allows to sort the list of IDs. \b Filter button allows to
  30 apply a definite filter to the selection of quadrangles.</li>
  31 <li><b>Apply to all</b> check box allows to modify the orientation of all
  32 quadrangles of the currently displayed mesh or sub-mesh.</li>
  33 <li>\b Preview - provides a preview of cutting in the viewer.</li>
  34 </ul>
  35
  36 <ul>
  37 <li>\b Criterion
  38 <ul>
  39 <li><b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allows to
  40 specify the opposite corners which will be connected by the cutting
  41 edge.</li>
  42 <li><b>Use numeric functor</b> - allows to choose a quality criterion
  43  which will be optimized at the outcome of the operation.
  44 <ul>
  45 <li><b>Minimum diagonal</b> - cuts by the shortest edge.</li>
  46 <li><b>Aspect Ratio</b> - cuts by the edge splitting the quadrangle
  47 into triangles with optimal \ref aspect_ratio_page "Aspect Ratio". The reference value is 1.</li>
  48 <li><b>Minimum Angle</b> -  cuts by the edge splitting the quadrangle
  49 into triangles with optimal  \ref minimum_angle_page "Minimum Angle". The reference value is 60 degrees.</li>
  50 <li><b>Skew</b> -   cuts by the edge splitting the quadrangle
  51 into triangles with optimal \ref skew_page "Skew". The reference value
  52 is 0.0 degrees.</li>
  53 </ul>
  54 </li>
  55 </ul>
  56 </li>
  57 <li><b>Select from</b> - allows to choose a sub-mesh or an existing
  58 group whose quadrangle elements will be automatically added to the
  59 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 */