#Prog:bamg
#NAME: @code{bamg} - bidimensional anisotropic mesh generator
#@cindex mesh
#@fiindex @file{.bamg} bamg mesh
#@toindex @code{bamg}
#SYNOPSIS:
#@example
#  bamg @var{options} -g @var{input}[.bamgcad] -o @var{ouput}[.bamg]
#@end example
#
#EXAMPLE:
#@example
#  bamg -g toto.bamgcad -o toto.bamg
#@end example
#
#Outline of the commands:
# @noindent
# This software can
# @table @code
#  @item create
#  	a mesh from a geometry
#  @item adapt
#	a mesh from a background mesh using a metric or solution file
#  @item 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).
#  @item construct
#	just a metric file, if you have an other mesher 
#  @item do the P1 interpolation
#	of the solution on another mesh:
# @end table
#
#create a mesh from a geometry:
#  @table @code
#  @item input 
#	file with @code{-g filename} (file type @code{DB mesh}).
#  @item output
#	file arguments @code{-oxxxx filename} where @code{xxxx} is the type of output file
#     (see below for more details).
#  @item smoothing, quad, utility and other parameters.
#  @end table
#  In addition, metric specication may be prescribed with the help of @code{-M filename} argument
#  (file type @code{Metric}).
#  All the options are described below.
#adapt a mesh from a background mesh using a metric or solution file:
#  @table @code
#  @item input
#	files @code{-b filename} where the suffixe of the file define the type of the file
#     @file{.amdba}, @file{.am_fmt}, @file{.am}, @file{.ftq}, @file{.nopo} and otherwise the file is a 
#     @code{BD mesh} file. 
#  @item input
#	@file{-M filename} (file type @code{Metric})
#     or @code{-MBB filename} or @code{-Mbb filename} (solution file type @code{BB} or @code{bb}).
#  @item metric
#	control parameters, @code{-err val}, @code{-errg val},.... 
#  @item output
#	file arguments reqired
#  @item 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).
#  @table @code
#  @item input
#	files @code{-r filename}(file type @code{DB mesh}).
#  @item @code{-M filename}
#	(file type @code{Metric}). 
#  @item output
#	file @code{-o filename} (file type @code{DB mesh}).
#  @end table
#some other parameter related to quadrilaterals:
#    @table @code
#    @item @code{-thetaquad val}:
#		to create quad with 2 triangles 
#    @item @code{-2}:
#		to create the submesh with mesh size h = h/2 
#    @item @code{-2q}:
#		to split all triangles in 3 quad. and to split all quad. in 4 quad. 
#    @item @code{-NbSmooth ival}:
#		to change the number of smoothing iteration (3 by default
#       if the metric eld is set with arguments : @code{-M} or @code{-Mbb}, 0 otherwise. 
#    @item ... 
#    @end table
#
#construct just a metric file:
#  e.g. if you have an other mesher:
#  @table @code
#  @item input
#		files @code{-r filename} (file type @code{DB mesh}). 
#  @item @code{--Mbb filename}
#		or @code{-MBB filename}
#  @item + all the arguments
#		of the metric construction 
#  @item output
#		file @code{-oM filename}  (file type @code{Metric}).
#  @end table
#do the P1 interpolation of the solution on another mesh:
#  @table @code
#  @item input
#		files @code{-r filename} (file type @code{DB mesh}).
#  @item @code{--rBB filename}
#		or @code{-rbb filename}
#  @item output
#		file @code{-wBB filename} or @code{-wbb filename}
#  @end table
#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.
#  @table @code
#  @item -RelError
#		compute the metric with a relative error. This is the default.
#  @item -CutOff float
#		the cut-off value used for the relative error criteria.
#		Default value is 1e-5.
#  @item -AbsError
#		compute the metric with a relative error
#  @end table
#End:
