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

   1 .. _symmetry_page:
   2
   3 ********
   4 Symmetry
   5 ********
   6
   7 This geometrical operation allows to perform a symmetrical copy of your mesh or some of its elements.
   8
   9 *To create a symmetrical copy:*
  10
  11 .. |img| image:: ../images/symmetry.png
  12
  13 #. From the **Modification** menu choose **Transformation** -> **Symmetry** item  or click *"Symmetry"* button |img| in the toolbar.
  14
  15    The following dialogs will appear, where you can choose a way to mirror:
  16
  17         * through a point:
  18
  19         .. image:: ../images/symmetry1.png
  20                 :align: center
  21
  22         * through an axis:
  23
  24         .. image:: ../images/symmetry2.png
  25                 :align: center
  26
  27         * through a plane (defined by a point and a normal to the plane):
  28
  29         .. image:: ../images/symmetry3.png
  30                 :align: center
  31
  32
  33 #. In the dialog:
  34
  35         * specify the elements for the symmetry operation:
  36
  37                 * **Select the whole mesh, submesh or group** activating this checkbox; or
  38                 * choose mesh elements with the mouse in the 3D Viewer. It is possible to select a whole area with a mouse frame; or
  39                 * input the element IDs directly in **ID Elements** field. The selected elements will be highlighted in the viewer; or
  40                 * apply Filters. **Set Filter** button allows to apply a :ref:`filtering_elements` to the selection of elements.
  41
  42         * depending on the nature of the mirror object:
  43
  44                 * if the mesh is mirrored through a point, specify the coordinates of the point, either directly or by picking a mesh node;
  45                 * if the mesh is mirrored through an axis:
  46
  47                   * specify the coordinates of the start **Point** of the axis, either directly or by picking a mesh node;
  48                   * specify the components of axis **Vector**, either directly or by picking a mesh node, in which case **Vector** is defined as a shift between the **Point** and the node;
  49
  50                 * if the mesh is mirrored through a plane:
  51
  52                   * specify the coordinates of the **Point** lying on the plane, either directly or by picking a mesh node;
  53                   * specify the components of plane **Normal**, either directly or by picking a mesh node, in which case **Normal** is defined as a shift between the **Point** and the node.
  54
  55                 * specify the conditions of symmetry operation:
  56
  57                   * activate **Move elements** radio button to change the location of the selected elements within the current mesh;
  58                   * activate **Copy elements** radio button to duplicate the selected elements at the new location within the current mesh;
  59                   * activate **Create as new mesh** radio button to create a new element in a new mesh; the new mesh appears in the Object Browser with the default name *MeshName_mirrored* (it is possible to change this name in the adjacent box);
  60                   * activate **Copy groups** check-box to put new mesh entities into new groups if source entities belong to some groups. New groups are named by pattern "<old group name>_mirrored".
  61
  62         * activate **Preview** check-box to show the result of transformation in the viewer;
  63         * click **Apply** or **Apply and Close** button to confirm the operation.
  64
  65
  66 **See Also** a sample TUI Script of a
  67 :ref:`tui_symmetry` operation.
  68
  69