.\"
.de Id
..
.de Sp
.if n .sp
.if t .sp 0.4
..
.TH mkgeo_ball 1rheolef "rheolef-7.0" "rheolef-7.0" "rheolef-7.0"
.\" label: Prog:mkgeo_ball
.SH NAME
\fBmkgeo_ball\fP -- build an unstructured mesh of an ellipsoid, in 2d or 3d
.\" skip: @pindex mkgeo_ball
.\" skip: @pindex geo
.\" skip: @cindex mesh
.\" skip: @fiindex @file{.geo} mesh
.SH SYNOPSIS

.\" begin_example
.Sp
.nf
        mkgeo_ball \fIoptions\fP [\fIn\fP]
.Sp
.fi
.\" end_example
.SH EXAMPLE

The following command build a triangle based 2d unstructured mesh
of the unit ball
.\" begin_example
.Sp
.nf
        mkgeo_ball -t 10 > ball-10.geo
        geo -mayavi ball-10.geo
.Sp
.fi
.\" end_example
or in one command line:
.\" begin_example
.Sp
.nf
        mkgeo_ball -t 10 | geo -mayavi -
.Sp
.fi
.\" end_example
.SH DESCRIPTION

.\" skip: @pindex gmsh
This command is useful when testing programs on simple geometries.
Invocation is similar to \fBmkgeo_grid\fP
(see mkgeo_grid(1), mkgeo_ugrid(1)).
It calls \fBgmsh\fP as unstructured mesh generator.
It avoid the preparation of an input file for a mesh generator.
The optional \fIn\fP argument is an integer
that specifies the subdivision in each direction. By default
\fIn\fP=10.
The mesh files goes on standard output.
.SH ELEMENT TYPE OPTIONS

.\" begin table
.\" start item
.TP
.B -t
2d mesh using triangles.
.\" start item
.TP
.B -q
2d mesh using quadrangles.
.\" start item
.TP
.B -tq
2d mesh using both triangles and quadrangles.
.\" end table
.SH THE MESH ORDER

.\" skip: @pindex gmsh
.\" skip: @cindex mesh order
.\" begin table
.\" start item
.TP
.B -order int
The polynomial pproximation mesh order,
for the curved boundary, as defined by \fBgmsh\fP.
Default is order=1.
.\" end table
.SH THE GEOMETRY

The geometry can be ellipse/ellipsoid inscribted in the [a,b]x[c,d] rectangle
or the [a,b]x[c,d]x[f,g] parallelotope. By default a=c=f=-1 and b=d=g=1, thus,
the unit balls are considered.
.\" begin table
.\" start item
.TP
.B -s
Only a surface mesh is generated: a curved line in 2d or a curved surface mesh in 3d.
In 3d, supports both '-t' and '-q' options.
.\" start item
.TP
.B -a \fIfloat\fP
.\" start item
.TP
.B -b \fIfloat\fP
.\" start item
.TP
.B -c \fIfloat\fP
.\" start item
.TP
.B -d \fIfloat\fP
.\" start item
.TP
.B -f \fIfloat\fP
.\" start item
.TP
.B -g \fIfloat\fP
.\" end table
.SH BOUNDARY DOMAINS

The meshes defines a domain named \fBboundary\fP that groups all boundary sides.
.SH OTHERS OPTIONS

.\" begin table
.\" start item
.TP
.B -fix
.\" start item
.TP
.B -nofix
By default, internal face and volume node from gmsh are recomputed,
since they have incorrect coordinate that destroy the convergence
properties of isoparametric high order elements (order >= 3).
The \fB-nofix\fP option skip this correction: this option is
available for test purpose.
.\" start item
.TP
.B -clean
clear temporary files (this is the default).
.\" start item
.TP
.B -noclean
does not clear temporary files.
.\" start item
.TP
.B -verbose
.\" start item
.TP
.B -noverbose
print intermediate commands and information messages.
.\" end table
.PP
.\" skip start:DATE:

.\" END

.\" LENGTH = 2
.SH SEE ALSO
mkgeo_grid(1), mkgeo_ugrid(1)
.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.