Salome HOME
Fix for "0023302: [EDF 12800] Ergonomics of mesh group export operation" issue.
[modules/smesh.git] / doc / salome / gui / SMESH / input / importing_exporting_meshes.doc
1 /*!
2
3 \page importing_exporting_meshes_page Importing and exporting meshes
4
5 \n In MESH there is a functionality allowing import/export
6 of meshes from/to \b MED, \b UNV (I-DEAS 10), \b DAT (simple ascii format), \b STL,
7 \b GMF (internal format of DISTENE products, namely MG-CADSurf, MG-Tetra and
8 MG-Hexa algorithms) and \b CGNS format files. You can also export a
9 group as a whole mesh.
10
11
12 <em>To import a mesh:</em>
13
14 <ol>
15 <li>From the \b File menu choose the \b Import item, from its sub-menu
16   select the corresponding format (MED, UNV, STL, GMF and CGNS) of the
17   file containing your mesh.</li>
18 <li>In the standard <b>Search File</b> dialog box find the file for
19   import. It is possible to select multiple files to be imported all at
20   once. </li> 
21
22 <li>Click the \b OK button.</li>
23 </ol>
24
25 \image html meshimportmesh.png
26
27 <em>To export a mesh or a group:</em>
28
29 <ol>
30   <li>Select the object you wish to export.</li>
31   <li>From the \b File menu choose the \b Export item, from its sub-menu
32     select the format (MED, UNV, DAT, STL, GMF and CGNS) of the file which will
33     contain your exported mesh.</li>
34   <li>In the standard <b>Search File</b> select a location for the
35     exported file and enter its name.</li>
36   <li>Click the \b OK button.</li>
37 </ol>
38
39 \image html meshexportmesh.png
40
41  If you try to export a group, the warning will be shown:
42 \image html meshexportgroupwarning.png
43 <ul>
44   <li><b>Don't show this warning anymore</b> check-box specifies show or
45   not the warning. If checked, the warning will not be shown anymore in 
46   the similar situation  </li>
47 </ul>
48
49  There are additional parameters available at export to MED and SAUV format files.
50 <ul>
51   <li><b>Automatically create groups</b> check-box specifies whether to
52   create groups of all mesh entities of available dimensions or
53   not. If checked, the created groups have names like "Group_On_All_Nodes",
54   "Group_On_All_Faces", etc.</li>
55   <li><b>Automatically define space dimension</b> check-box specifies
56   whether to define space dimension for export by mesh configuration
57   or not. Usually the mesh is exported as a mesh in 3D space, just as
58   it is in Mesh module. The mesh can be exported as a mesh of a lower
59   dimension in the following cases, provided that this check-box is checked:
60     <ul>
61       <li> <b>1D</b>: if all mesh nodes lie on OX coordinate axis. </li>
62       <li> <b>2D</b>: if all mesh nodes lie in XOY coordinate plane. </li>
63     </ul>
64   </li>
65 </ul>
66 <br><b>See Also</b> a sample TUI Script of an \ref tui_export_mesh "Export Mesh" operation.
67
68 */