Salome HOME
0020749: EDF 1291 SMESH : Create 2D Mesh from 3D improvement
[modules/smesh.git] / doc / salome / gui / SMESH / input / make_2dmesh_from_3d.doc
index ada914ec15dcb734ef7a18c9ed7bfe7ea9f93d8f..9d334340fabe5b003c77bb7a5f33240f2ae81199 100644 (file)
@@ -1,22 +1,60 @@
 /*!
 
-\page make_2dmesh_from_3d_page Create 2D mesh from 3D
+\page make_2dmesh_from_3d_page Generate boundary elements
 
-\n This functionality allows to generate 2D mesh elements as a skin
-on the existing 3D mesh elements.
+\n This functionality allows to generate mesh elements on borders of
+elements of higher dimension.
 
-<em>To generate 2D mesh:</em>
+
+<em>To generate border elements:</em>
 <ol>
-<li>From the Modification menu choose "Create 2D mesh from 3D"
+<li>From the Modification menu choose "Create boundary elements"
 item, or choose from the popup menu.
 
 \image html 2d_from_3d_menu.png
-
-The algorithm detects boundary volume faces without connections to
-other volumes and creates 2D mesh elements on face nodes. If the mesh
-already contains 2D elements on the detected nodes, new elements are not
-created. The the resulting dialog shows mesh information statistics
-about the newly created 2D mesh elements.
+The following dialog box will appear:
+\image html 2d_from_3d_dlg.png
+</li>
+<li>Check in the dialog box one of three radio buttons corresponding to
+the type of operation you would like to perform.</li>
+<li>Fill the other fields available in the dialog box.</li>
+<li>Click the \b Apply or <b>Apply and Close</b> button to perform the operation.</li>
 </ol>
 
+\n "Create boundary elements" dialog allows creation of boundary elements
+of three types.
+<ul>
+<li><b>2D from 3D</b> creates mesh faces on free facets of volume elements</li>
+<li><b>1D from 2D</b> creates mesh edges on free edges of mesh faces</li>
+<li><b>1D from 3D</b> creates mesh edges on all borders of free facets of volume elements</li>
+</ul>
+Here <em>free facet</em> means a facet shared by only one volume, <em>free edge</em>
+means an edge shared by only one mesh face.
+
+In this dialog:
+<ul>
+<li>specify <b>Mesh, submesh or group</b> to analyze the boundary.</li>
+<li>specify <b>Target</b> mesh where boundary elements will
+  be created.
+  <ul>
+  <li><b>This mesh</b> adds elements in the selected mesh or the mesh
+  the selected submesh or group belongs to.</li>
+  <li><b>New mesh</b> add elements to a new mesh. The new mesh appears
+  in the Object Browser with the name specified in the adjacent box
+  that you can change. </li>
+  </ul></li>
+<li>activate <b>Copy source mesh</b> checkbox to copy 2D or 3D
+  elements (depending on operation type) belonging to the object
+  specified in <b>Mesh, submesh or group</b> field to the new
+  mesh.</li>
+<li>deactivate <b>Copy missing elements only</b> checkbox to copy
+  boundary elements already present in the mesh being checked to the
+  new mesh.</li>
+<li>activate <b>Create group</b> checkbox to create a group where
+  missing boundary elements are added to. The new group appears
+  in the Object Browser with the name specified in the adjacent box
+  that you can change. </li>
+</ul>
+<br><b>See Also</b> a sample TUI Script of a \ref tui_make_2dmesh_from_3d "Create boundary elements" operation.  
+
 */