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:</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" <br>
  20 \image html symmetry2.png "an axis" <br>
  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 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
  35   selected elements will be highlighted in the viewer; or</li>
  36 <li>apply Filters. <b>Set Filter</b> button allows to apply a
  37   \ref filtering_elements "filter" to the selection of elements.</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, either directly or by picking a mesh node;</li>
  45 <li>if the mesh is mirrored through an axis:
  46 <ul>
  47 <li>specify the coordinates of the start \b Point of the axis, either
  48   directly or by picking a mesh node;</li>
  49 <li>specify the components of axis \b Vector, either directly or by
  50   picking a mesh node, in which case \b Vector is defined as a shift
  51   between the \b Point and the node;</li>
  52 </ul>
  53 </li>
  54
  55 <li>if the mesh is mirrored through a plane:
  56 <ul>
  57 <li>specify the cooordinates of the \b Point lying on the plane,
  58   either directly or by picking a mesh node;</li>
  59 <li>specify the components of plane \b Normal, either directly or by
  60   picking a mesh node, in which case \b Normal is defined as a shift
  61   between the \b Point and the node.</li>
  62 </ul>
  63 </li>
  64
  65 <li>specify the conditions of symmetry operation:
  66 <ul>
  67 <li>activate <b>Move elements</b> radio button to change the location of
  68   the selected elements within the current mesh;</li>
  69 <li>activate <b>Copy elements</b> radio button to duplicate the
  70   selected elements at the new location within the current mesh;</li>
  71 <li>activate <b>Create as new mesh</b> radio button to create a new
  72   element in a new mesh; the new mesh appears in the Object Browser
  73   with the default name \a MeshName_mirrored (it is possible to change
  74   this name in the adjacent box);</li>
  75 <li>activate <b> Copy groups </b> check-box to put new mesh entities
  76   into new groups if source entities belong to some groups. New
  77   groups are named by pattern "<old group name>_mirrored".</li>
  78 </ul>
  79 </li>
  80 </ul>
  81 <li>activate <b>Preview</b> check-box to show the result of
  82   transformation in the viewer;</li>
  83 <li>click \b Apply or <b> Apply and Close</b> button to confirm the
  84   operation.</li>
  85 </ul>
  86
  87 </ol>
  88
  89 <br><b>See Also</b> a sample TUI Script of a
  90 \ref tui_symmetry "Symmetry" operation.
  91
  92 */