doc/salome/gui/SMESH/input/symmetry.doc

   1 /*!
   2
   3 \page symmetry_page Symmetry
   4
   5 \n This geometrical operation allows to perform a symmetrical copy of
   6 your mesh or some of its elements.
   7
   8 <em>To create a symmetrical copy of the mesh:</em>
   9
  10 <ol>
  11 <li>From the \b Modification menu choose \b Transformation -> \b Symmetry item  or click
  12 <em>"Symmetry"</em> button in the toolbar.
  13
  14 \image html symmetry.png "Symmetry button"
  15
  16 One of the following dialogs will appear:
  17
  18 It is possible to mirror a mesh or some of its elements through:
  19 \image html symmetry1.png "a point (defined by a point and a vector)"
  20 \image html symmetry2.png "an axis"
  21 \image html symmetry3.png "a plane (defined by a point and a normal to the plane)"
  22
  23 </li>
  24
  25 <li>In the dialog:
  26 <ul>
  27 <li>specify the IDs of the elements for the symmetry operation:
  28
  29 <ul>
  30 <li><b>Select the whole mesh, submesh or group</b> activating this
  31 checkbox; or</li>
  32 <li>choose mesh elements with the mouse in the 3D Viewer. It is
  33 possible to select a whole area with a mouse frame; or</li>
  34 <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
  35 viewer; or</li>
  36 <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
  37 about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
  38 </ul>
  39 </li>
  40
  41 <li>depending on the nature of the mirror object:
  42 <ul>
  43 <li>if the mesh is mirrored through a point, specify the coordinates
  44 of the point</li>
  45 <li>if the mesh is mirrored through an axis:
  46 <ul>
  47 <li>specify the cooordinates of the start \b Point of the axis vector;</li>
  48 <li>specify the axis \b Vector through the coordinates of its
  49 end point with respect to the coordinates of the start point;</li>
  50 </ul>
  51 </li>
  52
  53 <li>if the mesh is mirrored through a plane:
  54 <ul>
  55 <li>specify the cooordinates of the \b Point lying on the plane;</li>
  56 <li>specify the axis \b Vector through the coordinates of its
  57 end point with respect to the coordinates of the start point.</li>
  58 </ul>
  59 </li>
  60
  61 <li>specify the conditions of symmetry operation:
  62 <ul>
  63 <li>activate <b>Move elements</b> radio button to create  the source
  64 mesh (or elements) at the new location and erase it from the previous location;</li>
  65 <li>activate <b>Copy elements</b> radio button to create the source
  66 mesh (or elements) at the new location, but leave it at the previous
  67 location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
  68 <li>activate <b>Create as new mesh</b> radio button to leave the
  69 source mesh (or elements) at its previous location and create a new
  70 mesh at the new location, the new mesh appears in the Object Browser
  71 with the default name MeshName_rotated (it is possible to change this
  72 name in the adjacent box);</li>
  73 <li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
  74 </ul>
  75 </li>
  76 </ul>
  77 <li>activate <b>Preview</b> checkbox to show the result of transformation in the viewer </li>
  78 <li>click \b Apply or <b> Apply and Close</b> button to confirm the
  79 operation.</li>
  80 </ul>
  81
  82 </ol>
  83
  84 <br><b>See Also</b> a sample TUI Script of a
  85 \ref tui_symmetry "Symmetry" operation.
  86
  87 */