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

   1 .. _copy_mesh_page:
   2
   3 *********
   4 Copy Mesh
   5 *********
   6
   7 A mesh can be created by copying a part of or the whole other mesh. There are two modes of the operation:
   8
   9 * copy mesh elements only;
  10 * copy mesh definition to another geometry. This mode can be used only if the source mesh is based on geometry. It is supposed that the new geometry is a modified geometry of the source mesh.
  11
  12 *To make a copy of a mesh:*
  13
  14 .. |img| image:: ../images/copy_mesh_icon.png
  15
  16 From the contextual menu in the Object Browser of from the **Mesh** menu select **Copy Mesh** or click *"Copy Mesh"* button |img| in the toolbar.
  17
  18 The following dialog box will appear:
  19
  20 .. image:: ../images/copy_mesh_dlg.png
  21         :align: center
  22
  23
  24 In the dialog:
  25
  26 * select the mode of the operation.
  27 * specify the part of mesh to copy:
  28
  29   * **Select whole mesh, sub-mesh or group** by mouse activating this checkbox; or
  30   * choose mesh elements with the mouse in the 3D Viewer. It is possible to select a whole area with a mouse frame; or
  31   * input the **Source Element IDs** directly in this field. The selected elements will be highlighted in the viewer; or
  32   * apply Filters. **Set filter** button allows to apply a filter to the selection of elements. See more about filters in the :ref:`selection_filter_library_page` page.
  33
  34 * specify the **New Mesh Name**;
  35 * select the **New Geometry**;
  36 * specify the conditions of copying:
  37
  38   * activate **Generate groups** check-box to copy the groups of the source mesh to the newly created mesh. In the mode of copying to new geometry, standalone groups are copied only if **Copy Mesh Elements** is activated.
  39   * activate **Reuse hypotheses** check-box to use hypotheses applied to the source mesh in the new mesh. Hypotheses having parameters defined as sub-shapes will be copied independently of this check-box state.
  40   * activate **Copy Mesh Element** to copy mesh elements of sub-shapes that are not modified.
  41
  42 * Click **Apply** or **Apply and Close** button to confirm the operation.
  43
  44 When copying the mesh to the new geometry, it can happen that a sub-shape used to define a sub-mesh, group or hypotheses is not found in the new geometry. In this case a new object depending on the not found sub-shape is marked with red color in the Object Browser in order to allow identifying such objects and to fix them, either by modifying their definition or by removing. If a depending object is a group on geometry, a standalone group is created instead. You can't transform it to a group on geometry, it can only be removed and re-created anew.
  45
  46 **See Also** a sample script of :ref:`tui_copy_mesh`.
  47