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 chose a quality criterion
  43   optimization of which will be used to select the cutting edge.
  44 <ul>
  45 <li><b>Minimum diagonal</b> - will be used the edge with the smallest length.</li>
  46 <li><b>Aspect Ratio</b> - will be used the edge which splits a quadrangle
  47 in order to optimize an Aspect Ratio quality criterion. The reference value is 1.</li>
  48 <li><b>Minimum Angle</b> - will be used the edge which splits a quadrangle
  49 in order to optimize a Minimum Angle quality criterion. The reference value
  50 is 60 degrees.</li>
  51 <li><b>Skew</b> - will be used the edge which splits a quadrangle
  52 in order to optimize a Skew quality criterion. The reference value
  53 is 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
  59 group whose quadrangle elements will be automatically added to the
  60 list.</li>
  61 </ul>
  62
  63 </li>
  64 <li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
  65 </ol>
  66
  67 \image html image52.jpg "The chosen quadrangular element"
  68
  69 \image html image51.jpg "Two resulting triangular elements"
  70
  71 <br><b>See Also</b> a sample TUI Script of a
  72 \ref tui_cutting_quadrangles "Cutting Quadrangles" operation.
  73
  74 */