Salome HOME
general crack dialog documentation
[modules/smesh.git] / src / Tools / blocFissure / doc / tutorials.rst
diff --git a/src/Tools/blocFissure/doc/tutorials.rst b/src/Tools/blocFissure/doc/tutorials.rst
new file mode 100755 (executable)
index 0000000..933c2d4
--- /dev/null
@@ -0,0 +1,66 @@
+.. _tutorials:\r
+\r
+#######################\r
+Tutorials\r
+#######################\r
+\r
+This tutorial aims at giving important steps of the use of « Bloc Fissure ». Those steps are the standard procedure that the user should apply to avoid « Bloc Fissure » failure and unexpected problem in the modelisation afterwards.\r
+\r
+First, the user should ask himself if its case is compatible with « Bloc Fissure ». See the section on :ref:`limitations <recommendations>`.\r
+\r
+1) Convert elements from quadratic to linear\r
+\r
+Mesh Module: Modification > Convert to/from quadratic\r
+\r
+2) Change the orientation of all faces to set them to outgoing\r
+\r
+Mesh Module: Modification > Reorient faces\r
+\r
+3) Verify that the crack exceeds everywhere from the structure. If it's not the case, move or extend the crack geometry.\r
+\r
+4) Verify that the crack front edges don't stop right at the Box surface.\r
+\r
+**Here are some advices :**\r
+\r
+*To move the crack:*\r
+\r
+GEOM Module: Operations > Transformation > Translation\r
+\r
+*First way to extend the crack geometry in GEOM module:*\r
+  - Operations > Explode: Choose the crack geometry and explode into Edges\r
+  - Operation > Transformations > Extension: extend the length of the crack edges\r
+  - Rebuild edges to get a closed group of edges exceeding from the structure\r
+  - New Entity > Build > Wire: Create a wire from the edges\r
+  - New Entity > Build > Face: Create a face from the wire\r
+  - Get the new crack front edge number\r
+\r
++-----------------------------------+-----------------------------------+-----------------------------------+-----------------------------------+\r
+| .. image:: images/tutorial_1.png  | .. image:: images/tutorial_2.png  | .. image:: images/tutorial_3.png  | .. image:: images/tutorial_4.png  |\r
+|    :height: 200                   |    :height: 200                   |    :height: 200                   |    :height: 200                   |\r
+|    :align: center                 |    :align: center                 |    :align: center                 |    :align: center                 |\r
++-----------------------------------+-----------------------------------+-----------------------------------+-----------------------------------+\r
+|    Initial bad crack geometry     |   Explode face into edges         |  Extend front edge and            |  Rebuild crack face               |\r
+|                                   |                                   |  rebuild wire                     |                                   |\r
++-----------------------------------+-----------------------------------+-----------------------------------+-----------------------------------+\r
+\r
+*second way to extend the crack geometry in GEOM module:*\r
+  - Create new surfaces linked to the original crack geometry\r
+  - Fuse the surfaces to get an extended crack\r
+\r
+5) Execute the « Bloc Fissure » script and check that it ended successfully.\r
+\r
+6) Reorient faces to outgoing normal\r
+\r
+7) Rebuild groups impacted by crack insertion\r
+\r
+8) Export the cracked mesh\r
+\r
+\r
+\r
+\r
+\r
+\r
+\r
+\r
+\r
+\r