X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fdefine_mesh_by_script.rst;fp=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fdefine_mesh_by_script.rst;h=a3329d3b6e5c7c3facdee65fcf212914a18f1187;hb=f0f67c0b47e58361bc50c7169734da604fbfca01;hp=0000000000000000000000000000000000000000;hpb=f6825d843153c333e95e1345ef7c7fc2d0fe5698;p=modules%2Fsmesh.git

diff --git a/doc/salome/gui/SMESH/input/define_mesh_by_script.rst b/doc/salome/gui/SMESH/input/define_mesh_by_script.rst
new file mode 100644
index 000000000..a3329d3b6
--- /dev/null
+++ b/doc/salome/gui/SMESH/input/define_mesh_by_script.rst
@@ -0,0 +1,28 @@
+.. _use_existing_page:
+
+**************************************
+Use Edges/Faces to be Created Manually
+**************************************
+
+The algorithms **Use Edges to be Created Manually** and **Use Faces to be Created Manually** allow  creating a 1D or a 2D mesh in a python script (using **AddNode, AddEdge** and **AddFace** commands) and then using such sub-meshes in the construction of a 2D or a 3D mesh. 
+
+For example, you want to use standard algorithms to generate 1D and 3D
+meshes and to create 2D mesh by your python code. For this, you
+
+#. create a mesh object, assign a 1D algorithm,
+#. invoke **Compute** command, which computes a 1D mesh,
+
+#. assign **Use Faces to be Created Manually** and a 3D algorithm,
+#. run your python code, which creates a 2D mesh,
+#. invoke **Compute** command, which computes a 3D mesh.
+
+.. warning:: **Use Edges to be Created Manually** and **Use Faces to be Created Manually** algorithms should be assigned _before_ mesh generation by the Python code.
+
+Consider trying a sample script demonstrating the usage of :ref:`tui_use_existing_faces` algorithm for construction of a 2D mesh using Python commands.
+
+	.. image:: ../images/use_existing_face_sample_mesh.png
+		:align: center
+
+**Mesh computed by** :ref:`tui_use_existing_faces` shown in a Shrink mode.
+  
+