.\"
.de Id
..
.de Sp
.if n .sp
.if t .sp 0.4
..
.TH bamg 1rheolef "rheolef-6.5" "rheolef-6.5" "rheolef-6.5"
.\" label: Prog:bamg
.SH NAME
\fBbamg\fP - bidimensional anisotropic mesh generator
.\" skip: @cindex mesh
.\" skip: @fiindex @file{.bamg} bamg mesh
.\" skip: @toindex @code{bamg}
.SH SYNOPSIS

.\" begin_example
.Sp
.nf
  bamg \fIoptions\fP -g \fIinput\fP[.bamgcad] -o \fIouput\fP[.bamg]
.Sp
.fi
.\" end_example
.PP
.SH EXAMPLE

.\" begin_example
.Sp
.nf
  bamg -g toto.bamgcad -o toto.bamg
.Sp
.fi
.\" end_example
.PP
.SH OUTLINE OF THE COMMANDS

 This software can
.\" begin table
.\" start item
.TP
.B create
a mesh from a geometry
.\" start item
.TP
.B adapt
a mesh from a background mesh using a metric or solution file
.\" start item
.TP
.B do smoothing
to make quadrilaterals
and to split internal edge with 2 boundary vertices
in an existing mesh (in this case the metric is use to change the definition of the element's quality).
.\" start item
.TP
.B construct
just a metric file, if you have an other mesher
.\" start item
.TP
.B do the P1 interpolation
of the solution on another mesh:
.\" end table
.PP
.SH CREATE A MESH FROM A GEOMETRY

.\" begin table
.\" start item
.TP
.B input
file with \fB-g filename\fP (file type \fBDB mesh\fP).
.\" start item
.TP
.B output
file arguments \fB-oxxxx filename\fP where \fBxxxx\fP is the type of output file
(see below for more details).
.\" start item
.TP
.B smoothing, quad, utility and other parameters.
.\" end table
In addition, metric specication may be prescribed with the help of \fB-M filename\fP argument
(file type \fBMetric\fP).
All the options are described below.
.SH ADAPT A MESH FROM A BACKGROUND MESH USING A METRIC OR SOLUTION FILE

.\" begin table
.\" start item
.TP
.B input
files \fB-b filename\fP where the suffixe of the file define the type of the file
`\fB.amdba'\fP, `\fB.am_fmt'\fP, `\fB.am'\fP, `\fB.ftq'\fP, `\fB.nopo'\fP and otherwise the file is a
\fBBD mesh\fP file.
.\" start item
.TP
.B input
`\fB-M filename'\fP (file type \fBMetric\fP)
or \fB-MBB filename\fP or \fB-Mbb filename\fP (solution file type \fBBB\fP or \fBbb\fP).
.\" start item
.TP
.B metric
control parameters, \fB-err val\fP, \fB-errg val\fP,....
.\" start item
.TP
.B output
file arguments reqired
.\" start item
.TP
.B interpolation, smoothing, quad,
utility parameter, and other parameter
.\" end table
do smoothing, to make quadrilaterals:
and to split internal edge with 2 boundary vertices
in an existing mesh (in this case the metric is use to change the definition of the element's quality).
.\" begin table
.\" start item
.TP
.B input
files \fB-r filename\fP(file type \fBDB mesh\fP).
.\" start item
.TP
.B \fB-M filename\fP
(file type \fBMetric\fP).
.\" start item
.TP
.B output
file \fB-o filename\fP (file type \fBDB mesh\fP).
.\" end table
.SH SOME OTHER PARAMETER RELATED TO QUADRILATERALS

.\" begin table
.\" start item
.TP
.B \fB-thetaquad val\fP:
to create quad with 2 triangles
.\" start item
.TP
.B \fB-2\fP:
to create the submesh with mesh size h = h/2
.\" start item
.TP
.B \fB-2q\fP:
to split all triangles in 3 quad. and to split all quad. in 4 quad.
.\" start item
.TP
.B \fB-NbSmooth ival\fP:
to change the number of smoothing iteration (3 by default
if the metric eld is set with arguments : \fB-M\fP or \fB-Mbb\fP, 0 otherwise.
.\" start item
.TP
.B ...
.\" end table
.PP
.SH CONSTRUCT JUST A METRIC FILE

e.g. if you have an other mesher:
.\" begin table
.\" start item
.TP
.B input
files \fB-r filename\fP (file type \fBDB mesh\fP).
.\" start item
.TP
.B \fB--Mbb filename\fP
or \fB-MBB filename\fP
.\" start item
.TP
.B + all the arguments
of the metric construction
.\" start item
.TP
.B output
file \fB-oM filename\fP  (file type \fBMetric\fP).
.\" end table
do the P1 interpolation of the solution on another mesh:
.\" begin table
.\" start item
.TP
.B input
files \fB-r filename\fP (file type \fBDB mesh\fP).
.\" start item
.TP
.B \fB--rBB filename\fP
or \fB-rbb filename\fP
.\" start item
.TP
.B output
file \fB-wBB filename\fP or \fB-wbb filename\fP
.\" end table
.SH METRIC COMPUTATIOB OPTIONS

These options are relevant when computing a metric from a scalar field
provided in a .bb file. Notice that, when providing a tensor metric in the .bb
file, the metric computation is not performed and these options are not relevent.
.\" begin table
.\" start item
.TP
.B -RelError
compute the metric with a relative error. This is the default.
.\" start item
.TP
.B -CutOff float
the cut-off value used for the relative error criteria.
Default value is 1e-5.
.\" start item
.TP
.B -AbsError
compute the metric with a relative error
.\" end table
.\" END