Salome HOME
Merge branch 'V9_2_BR'
[modules/smesh.git] / doc / salome / gui / SMESH / input / tui_modifying_meshes.rst
index b14ba8553f172df180ddbe77af61348c035491e9..0981dd7af4975f30cbb3611700e04a319b239fe6 100644 (file)
@@ -17,150 +17,100 @@ Adding Nodes and Elements
 Add Node
 ********
 
-.. _modifying_meshes_ex01.py:
-
-``modifying_meshes_ex01.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex01.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex01.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex01.py>`
 
 .. _tui_add_0DElement:
 
 Add 0D Element
 **************
 
-.. _modifying_meshes_ex02.py:
-
-``modifying_meshes_ex02.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex02.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex02.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex02.py>`
 
 .. _tui_add_0DElement_on_all_nodes:
 
 Add 0D Element on Element Nodes
 *******************************
 
-.. _modifying_meshes_ex03.py:
-
-``modifying_meshes_ex03.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex03.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex03.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex03.py>`
 
 .. _tui_add_edge:
 
 Add Edge
 ********
 
-.. _modifying_meshes_ex04.py:
-
-``modifying_meshes_ex04.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex04.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex04.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex04.py>`
 
 .. _tui_add_triangle:
 
 Add Triangle
 ************
 
-.. _modifying_meshes_ex05.py:
-
-``modifying_meshes_ex05.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex05.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex05.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex05.py>`
 
 .. _tui_add_quadrangle:
 
 Add Quadrangle
 **************
 
-.. _modifying_meshes_ex06.py:
-
-``modifying_meshes_ex06.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex06.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex06.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex06.py>`
 
 .. _tui_add_tetrahedron:
 
 Add Tetrahedron
 ***************
 
-.. _modifying_meshes_ex07.py:
-
-``modifying_meshes_ex07.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex07.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex07.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex07.py>`
 
 .. _tui_add_hexahedron:
 
 Add Hexahedron
 **************
 
-.. _modifying_meshes_ex08.py:
-
-``modifying_meshes_ex08.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex08.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex08.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex08.py>`
 
 .. _tui_add_polygon:
 
 Add Polygon
 ***********
 
-.. _modifying_meshes_ex09.py:
-
-``modifying_meshes_ex09.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex09.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex09.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex09.py>`
 
 .. _tui_add_polyhedron:
 
 Add Polyhedron
 **************
 
-.. _modifying_meshes_ex10.py:
-
-``modifying_meshes_ex10.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex10.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex10.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex10.py>`
 
 .. _tui_removing_nodes_and_elements: 
 
@@ -172,238 +122,207 @@ Removing Nodes and Elements
 Removing Nodes
 **************
 
-.. _modifying_meshes_ex11.py:
-
-``modifying_meshes_ex11.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex11.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex11.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex11.py>`
 
 .. _tui_removing_elements:
 
 Removing Elements
 *****************
 
-.. _modifying_meshes_ex12.py:
-
-``modifying_meshes_ex12.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex12.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex12.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex12.py>`
 
 .. _tui_removing_orphan_nodes:
 
 Removing Orphan Nodes
 *********************
 
-.. _modifying_meshes_ex13.py:
-
-``modifying_meshes_ex13.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex13.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex13.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex13.py>`
 
 .. _tui_moving_nodes: 
 
 Moving Nodes
 ============
 
-.. _modifying_meshes_ex15.py:
-
-``modifying_meshes_ex15.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex15.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex15.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex15.py>`
 
 .. _tui_diagonal_inversion: 
 
 Diagonal Inversion
 ==================
 
-.. _modifying_meshes_ex16.py:
-
-``modifying_meshes_ex16.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex16.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex16.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex16.py>`
 
 .. _tui_uniting_two_triangles:
 
 Uniting two Triangles
 =====================
 
-.. _modifying_meshes_ex17.py:
-
-``modifying_meshes_ex17.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex17.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex17.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex17.py>`
 
 .. _tui_uniting_set_of_triangles:
 
 Uniting a Set of Triangles
 ==========================
 
-.. _modifying_meshes_ex18.py:
-
-``modifying_meshes_ex18.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex18.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex18.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex18.py>`
 
 .. _tui_orientation: 
 
 Orientation
 ===========
 
-.. _modifying_meshes_ex19.py:
-
-``modifying_meshes_ex19.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex19.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex19.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex19.py>`
 
 .. _tui_cutting_quadrangles: 
 
 Cutting Quadrangles
 ===================
 
-.. _modifying_meshes_ex20.py:
+.. literalinclude:: ../../../examples/modifying_meshes_ex20.py
+    :language: python
 
-``modifying_meshes_ex20.py``
+:download:`Download this script <../../../examples/modifying_meshes_ex20.py>`
 
-.. literalinclude:: ../../../examples/modifying_meshes_ex20.py
-    :linenos:
+.. _modifying_meshes_split_vol: 
+
+Split Volumes into Tetrahedra
+=============================
+
+.. literalinclude:: ../../../examples/modifying_meshes_split_vol.py
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex20.py`
+:download:`Download this script <../../../examples/modifying_meshes_split_vol.py>`
 
 .. _tui_smoothing: 
 
 Smoothing
 =========
 
-.. _modifying_meshes_ex21.py:
-
-``modifying_meshes_ex21.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex21.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex21.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex21.py>`
 
 .. _tui_extrusion: 
 
 Extrusion
 =========
 
-.. _modifying_meshes_ex22.py:
-
-``modifying_meshes_ex22.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex22.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex22.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex22.py>`
 
 .. _tui_extrusion_along_path: 
 
 Extrusion along a Path
 ======================
 
-.. _modifying_meshes_ex23.py:
-
-``modifying_meshes_ex23.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex23.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex23.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex23.py>`
 
 .. _tui_revolution: 
 
 Revolution
 ==========
 
-.. _modifying_meshes_ex24.py:
-
-``modifying_meshes_ex24.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex24.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex24.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex24.py>`
 
 .. _tui_pattern_mapping: 
 
 Pattern Mapping
 ===============
 
-.. _modifying_meshes_ex25.py:
-
-``modifying_meshes_ex25.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex25.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex25.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex25.py>`
 
 .. _tui_quadratic: 
 
 Convert mesh to/from quadratic
 ==============================
 
-.. _modifying_meshes_ex26.py:
-
-``modifying_meshes_ex26.py``
-
 .. literalinclude:: ../../../examples/modifying_meshes_ex26.py
-    :linenos:
     :language: python
 
-:download:`../../../examples/modifying_meshes_ex26.py`
+:download:`Download this script <../../../examples/modifying_meshes_ex26.py>`
 
 .. _tui_split_biquad: 
 
 Split bi-quadratic into linear
 ==============================
 
-.. _split_biquad.py:
+.. literalinclude:: ../../../examples/split_biquad.py
+    :language: python
 
-``split_biquad.py``
+:download:`Download this script <../../../examples/split_biquad.py>`
 
-.. literalinclude:: ../../../examples/split_biquad.py
-    :linenos:
+.. _tui_double_nodes_on_group_boundaries:
+
+Double nodes on groups boundaries
+=================================
+
+Double nodes on shared faces between groups of volumes and create flat elements on demand.
+
+The list of groups must contain at least two groups. The groups have to be disjoint: no common element into two different groups.
+
+The nodes of the internal faces at the boundaries of the groups are doubled. Optionally, the internal faces are replaced by flat elements.
+
+Triangles are transformed into prisms, and quadrangles into hexahedrons.
+
+The flat elements are stored in groups of volumes.
+
+These groups are named according to the position of the group in the list:
+the group j_n_p is the group of the flat elements that are built between the group \#n and the group \#p in the list.
+If there is no shared faces between the group \#n and the group \#p in the list, the group j_n_p is not created.
+All the flat elements are gathered into the group named "joints3D" (or "joints2D" in 2D situation).
+The flat element of the multiple junctions between the simple junction are stored in a group named "jointsMultiples".
+
+This example represents an iron cable (a thin cylinder) in a concrete bloc (a big cylinder).
+The big cylinder is defined by two geometric volumes.
+
+.. literalinclude:: ../../../examples/generate_flat_elements.py
     :language: python
 
-:download:`../../../examples/split_biquad.py`
+:download:`Download this script <../../../examples/generate_flat_elements.py>`
+
+Here, the 4 groups of volumes [Solid_1_1, Solid_2_1, Solid_3_1, Solid_4_1] constitute a partition of the mesh.
+The flat elements on group boundaries and on faces are built with the
+2 last lines of the code above.
+
+If the last argument (Boolean) in DoubleNodesOnGroupBoundaries is set to 1,
+the flat elements are built, otherwise, there is only a duplication of the nodes.
+
+To observe flat element groups, save the resulting mesh on a MED file and reload it.
+