.\"
.de Id
..
.de Sp
.if n .sp
.if t .sp 0.4
..
.TH msh2geo 1rheolef "rheolef-7.0" "rheolef-7.0" "rheolef-7.0"
.\" label: /*Prog:msh2geo
.SH NAME
\fBmsh2geo\fP -- msh2geo - convert gmsh mesh in geo format
.\" skip: @cindex mesh
.\" skip: @toindex msh2geo
.\" skip: @pindex geo
.\" skip: @fiindex @file{.msh} gmsh mesh
.\" skip: @fiindex @file{.geo} mesh
.\" skip: @toindex @code{gmsh}
.SH SYNOPSIS

.\" begin_example
.Sp
.nf
  msh2geo [-zr|-rz] < \fIinput\fP[.msh] > \fIoutput\fP.geo
  msh2geo [-zr|-rz]   \fIinput\fP[.msh] > \fIoutput\fP.geo
.Sp
.fi
.\" end_example
.PP
.SH DESCRIPTION

Convert a gmsh `\fB.msh'\fP into `\fB.geo'\fP one.
The output goes to standard output.
The input comes either from standard input or from a file.
.SH EXAMPLE

.\" begin_example
.Sp
.nf
  gmsh -2 toto.mshcad -o toto.msh
  msh2geo < toto.msh > toto.geo
  gmsh -2 -order 2 toto.mshcad -o toto2.msh
  msh2geo < toto2.msh > toto2.geo
.Sp
.fi
.\" end_example
See the \fBgmsh\fP documentation for a detailed description
of the `\fB.mshcad'\fP input file for \fBgmsh\fP.
.SH COORDINATE SYSTEM OPTION

Most of rheolef codes are coordinate-system independent.
The coordinate system is specified in the geometry file `\fB.geo'\fP.
.\" begin table
.\" skip: @cindex axisymmetric coordinate system
.\" start item
.TP
.B -zr
.\" start item
.TP
.B -rz
The 2d mesh is axisymmetric: \fBzr\fP (resp. \fBrz\fP) stands when the symmetry is related
to the first (resp. second) coordinate.
.\" start item
.TP
.B -cartesian
The coordinate system is cartesian.
This is the default.
.\" end table
.SH NOTES

Pk triangle, when k>=5, may have internal nodes renumbered: from the
gmsh documentation:
.\" begin_example
.Sp
.nf
  The nodes of a curved element are numbered in the following order:
.PP
    the element principal vertices;
    the internal nodes for each edge;
    the internal nodes for each face;
    the volume internal nodes.
.PP
  The numbering for face and volume internal nodes is recursive,
  i.e., the numbering follows that of the nodes of an embedded face/volume.
  The higher order nodes are assumed to be equispaced on the element.
.Sp
.fi
.\" end_example
.PP
In rheolef, internal triangle nodes are numbered from left to right and then
from bottom to top. The numbering differ for triangle when k >= 5.
Thus, \fBmsh2geo\fP fix the corresponding internal nodes numbering during the
conversion.
.PP
Pk tetrahedrons and hexaedrons in gmsh and rheolef has not the same edge-node order
nd orientation.
E.g. for tetrahedrons, edges 13 and 23 should be swapped
and reoriented as 32 and 31.
Thus, \fBmsh2geo\fP fix the corresponding internal nodes numbering.
.PP
.SH TODO

Fix for P3-tetra: swap edges orientations for 3,4,5
and swap faces 1 and 2. Check P4(T) for face orientation.
Perform face visualisation with gnuplot face fill.
.PP
See also hexa edges orient and faces numbers and orient.
.PP
Check that node are numbered by vertex-node, then edge-node, then face(tri,qua)-node and then volume(T,P,H)-node.
Otherwise, renumber all nodes.
.PP
Support for high order >= 6 element is not documented in gmsh, but gmsh supports it at run
.\" END
.SH COPYRIGHT
Copyright (C) 2000-2018 Pierre Saramito <Pierre.Saramito@imag.fr> GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.