Man pages sections > man1 > gmsh

Gmsh - 3D finite element mesh generator with built-in CAD engine and

Gmsh(1) Gmsh Manual Pages Gmsh(1)


Gmsh - 3D finite element mesh generator with built-in CAD engine and post-processor


gmsh [file(s)] [option(s)]


Gmsh is a 3D finite element grid generator with a build-in CAD engine and post-processor. Its design goal is to provide a fast, light and user-friendly meshing tool with parametric input and advanced visualization capabilities.
Gmsh is built around four modules: geometry, mesh, solver and post-processing. The specification of any input to these modules is done either interactively using the graphical user interface or in ASCII text files using Gmsh's own scripting language.


Output model, then exit.
-tol float
set geometrical tolerance.


-1, -2, -3
perform 1D, 2D or 3D mesh generation, then exit.
-o file
specify output file name.
-format string
set output mesh format (auto, msh, msh1, msh2, unv, vrml, stl, mesh, bdf, med, ...).
use binary format when available.
save all elements (discard physical group definitions)
-algo string
select mesh algorithm (meshadapt, del2d, front2d, del3d, front3d, ...).
save vertices with their parametric coordinates.
-part int
partition the mesh after batch mesh generation.
-smooth int
set number of mesh smoothing steps.
-order int
set mesh order.
-clscale float
set global scaling factor to the mesh characteristic lengths in the model.
-clmin float
Set minimum characteristic length.
-clmax float
Set maximum characteristic length.
-rand float
set random perturbation factor.
-bgm file
load the post-processing view in file as the current background mesh.
perform various consistency checks on mesh.


combine input views into multi-time-step ones.


hide all meshes and post-processing views on startup.
-fontsize int
specify the font size for the GUI.
-display string
specify display.


parse input files, then exit.
create new model before merge next file.
merge next files.
ppen next files.
-a, -g, -m, -s, -p
start in automatic, geometry, mesh, solver or post-processing mode.
print pid on stdout.
always listen to incoming connection requests.
-v int
set verbosity level.
don't popup dialog windows in scripts.
-setnumber name value
set constant number name=value
-setstring name value
set constant string name=value
-string string
parse option string at startup.
-option file
parse option file at startup.
-convert files
Convert files into latest binary formats, then exit.
show version number.
show detailed version information.
show help message.


Christophe Geuzaine ( and Jean-Francois Remacle (


Gmsh examples ( /usr/share/doc/gmsh-*/),
Gmsh homepage (
The full documentation for Gmsh is maintained as a Texinfo manual. If the info and gmsh programs are properly installed at your site, the command
info gmsh
should give you access to the complete manual.
1 April 2017 4th Berkeley Distribution