Salome HOME
PR: doc on script migration
[modules/smesh.git] / doc / salome / gui / SMESH / input / convert_to_from_quadratic_mesh.doc
index 84974a21c252321e7380e41717a360f162655d97..15fe1b7501ff2d278c871e952dbcc615fd45f369 100644 (file)
@@ -2,33 +2,50 @@
 
 \page convert_to_from_quadratic_mesh_page Convert to/from Quadratic Mesh
 
-\n This functionality allows you to transtorm standard meshes to
-quadratic and vice versa. See \ref adding_quadratic_elements_page "Adding quadratic elements" 
-for more information about quadratic meshes.
+\n This functionality allows transforming linear meshes (or
+sub-meshes) to quadratic and vice versa.
+Note that conversion of a sub-mesh most probably will produce a
+non-conformal mesh. Elements on the boundary between quadratic and
+linear sub-meshes become (or remain) quadratic.
+
+See \ref adding_quadratic_elements_page for more information about
+quadratic meshes.
 
 <em>To produce a conversion:</em>
 <ol>
-<li>From the Modification menu choose the Convert to/from Quadratic
-Mesh item, or click <em>"Convert to/from quadratic"</em> button in the
+<li>Select a mesh or a sub-mesh in the Object Browser or in the
+Viewer.</li>
+<li>From the Modification menu choose <b> Convert to/from Quadratic
+Mesh item </b>, or click <em>"Convert to/from quadratic"</em> button in the
 toolbar.
 
-\image html image154.gif
-<center><em>"Convert to/from quadratic" button</em></center>
+<center>
+\image html image154.png
+<em>"Convert to/from quadratic" button</em>
+</center>
 
 The following dialog box will appear:
 
 \image html convert.png
 
 </li>
-<li>In this dialog box you should select:
+<li>In this dialog box specify:
 
 <ul>
-<li>if you wish to convert standard mesh to quadratic or quadratic to standard;</li>
-<li>if you wish to place medium nodes of the quadratic mesh on the geometry (meshed object).</li>
+<li>If it is necessary to convert a linear mesh to quadratic or a quadratic
+  mesh to linear. **Convert to bi-quadratic** option means same as
+  **Convert to quadratic** except that QUAD9 elements are created
+  instead of QUAD8, and HEXA27 elements are created instead of
+  HEXA20. Note that the choice is available only if the selected mesh
+  (or sub-mesh) contains both quadratic and linear elements, else the
+  direction of conversion is selected automatically.</li>
+<li>If it is necessary to place medium nodes of the quadratic mesh on the
+geometry (meshed object). This option is relevant for conversion to
+quadratic provided that the mesh is based on a geometry (not imported from file).</li>
 </ul>
 
 \image html image156.gif
-<center>Standard mesh (coarse mesh on a torus)</center>
+<center>Linear mesh (coarse mesh on a torus)</center>
 
 \image html image155.gif
 <center>Quadratic mesh</center>
@@ -37,4 +54,6 @@ The following dialog box will appear:
 <li>Click the \b Apply or \b OK button.</li>
 </ol>
 
-*/
\ No newline at end of file
+<br><b>See Also</b> a sample TUI Script of a \ref tui_quadratic "Convert to/from quadratic" operation.
+
+*/