Salome HOME
Merge remote-tracking branch 'origin/master'
[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 allows to
45     switch off the warning. You can re-activate the warning in 
46     \ref group_export_warning_pref "Preferences".</li>
47 </ul>
48
49  There are additional parameters available at export to MED and SAUV format files.
50 <ul>
51   <li>
52 \anchor export_auto_groups
53   <b>Automatically create groups</b> check-box specifies whether to
54   create groups of all mesh entities of available dimensions or
55   not. The created groups have names like "Group_On_All_Nodes",
56   "Group_On_All_Faces", etc. A default state of this check-box can be
57   set in \ref export_auto_groups_pref "Preferences". </li>
58   <li><b>Automatically define space dimension</b> check-box specifies
59   whether to define space dimension for export by mesh configuration
60   or not. Usually the mesh is exported as a mesh in 3D space, just as
61   it is in Mesh module. The mesh can be exported as a mesh of a lower
62   dimension in the following cases, provided that this check-box is checked:
63     <ul>
64       <li> <b>1D</b>: if all mesh nodes lie on OX coordinate axis. </li>
65       <li> <b>2D</b>: if all mesh nodes lie in XOY coordinate plane. </li>
66     </ul>
67   </li>
68 </ul>
69 <br><b>See Also</b> a sample TUI Script of an \ref tui_export_mesh "Export Mesh" operation.
70
71 */