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

diff --git a/doc/salome/gui/SMESH/input/define_mesh_by_script.doc b/doc/salome/gui/SMESH/input/define_mesh_by_script.doc
new file mode 100644
index 000000000..beb9d8e40
--- /dev/null
+++ b/doc/salome/gui/SMESH/input/define_mesh_by_script.doc
@@ -0,0 +1,29 @@
+/*!
+
+\page  use_existing_page Use Edges/Faces to be Created Manually"
+
+The algorithms <b>Use Edges to be Created Manually</b> and <b>Use Faces to be Created Manually</b> allow  creating a 1D or a 2D mesh in a python script (using <em>AddNode, AddEdge</em> and <em>AddFace</em> 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
+<ol>
+  <li> create a mesh object, assign a 1D algorithm,</li>
+  <li> invoke \b Compute command, which computes a 1D mesh,</li>
+  <li> assign <b>Use Faces to be Created Manually</b> and a 3D algorithm,</li>
+  <li> run your python code, which creates a 2D mesh,</li>
+  <li> invoke \b Compute command, which computes a 3D mesh.</li>
+</ol>
+
+\warning <b>Use Edges to be Created Manually</b> and <b>Use Faces to
+be Created Manually</b> 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 "Use Faces to be Created Manually"
+algorithm for construction of a 2D mesh using Python commands.
+
+\image html use_existing_face_sample_mesh.png
+<em> Mesh computed by \ref tui_use_existing_faces "the sample script"
+  shown in a Shrink mode.</em>
+  
+*/