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

   1 /*!
   2
   3 \page cutting_quadrangles_page Cutting quadrangles
   4
   5 This operation allows cutting one or several quadrangle elements into two or four triangles.
   6
   7 <em>To cut quadrangles:</em>
   8
   9 1) Display a mesh, a 2D sub-mesh or a group of faces in the 3D viewer.
  10
  11 2) 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
  22 - The main list contains the list of quadrangles selected for cutting. You can
  23 click on a quadrangle in the 3D viewer and it will be highlighted (lock Shift
  24 keyboard button to select several quadrangles):
  25   - Click \b Add button and the ID of this quadrangle will be added to the list.
  26   - To remove a selected element or elements from the list click \b Remove button.
  27   - <b>Sort list</b> button allows sorting the list of IDs.
  28   - \b Filter button allows applying a definite filter to the selection of quadrangles.
  29 - <b>Apply to all</b> check box allows cutting all quadrangles of the selected mesh, sub-mesh or group.
  30 - \b Preview provides a preview of cutting in the viewer. It is disabled for <b>Cut into 4 triangles</b> as this cutting way implies no ambiguity.
  31 - \b Criterion defines the way of cutting:
  32   - <b>Cut into 4 triangles</b> allows cutting a quadrangle into four triangles by inserting a new node at the center of the quadrangle. The other options allow cutting a quadrangle into two triangles by connecting the nodes of a diagonal.
  33   - <b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allow specifying the opposite corners, which will be connected to form two new triangles.
  34   - <b>Use numeric functor</b> allows selecting in the field below a quality metric, which will be optimized when choosing a diagonal for cutting a quadrangle:
  35     - <b>Minimum diagonal</b> cuts by the shortest diagonal.
  36     - <b>Aspect Ratio</b> cuts by the diagonal splitting the quadrangle into triangles with \ref aspect_ratio_page "Aspect Ratio" closer to 1
  37     - <b>Minimum Angle</b> cuts by the diagonal splitting the quadrangle into triangles with \ref minimum_angle_page "Minimum Angle" closer to 60 degrees.
  38     - <b>Skew</b> cuts by the diagonal splitting the quadrangle into triangles with \ref skew_page "Skew" closer to 0.0 degrees.
  39 - <b>Select from</b> allows choosing a sub-mesh or an existing group, whose quadrangle elements will be automatically added to the main list.
  40
  41 3) Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.
  42
  43 \image html image52.jpg "The chosen quadrangular element"
  44
  45 \image html image51.jpg "Two resulting triangular elements"
  46
  47 <br><b>See Also</b> a sample TUI Script of a
  48 \ref tui_cutting_quadrangles "Cutting Quadrangles" operation.
  49
  50 */