WlzBasisFnTransformObj

Name

WlzBasisFnTransformObj - computes and applies Woolz basis function transforms.

Synopsis

WlzBasisFnTransformObj [-o<out object>] [-p<tie points file>]
                       [-m<min mesh dist>] [-M<max mesh dist>]
                       [-b<basis fn transform>] [-Y<order of polynomial>]
                       [-D<flags>] [-P<param>]
                       [-e<displacement seed>] [-r<max displacement>]
                       [-d] [-g] [-h] [-q] [-Q] [-s] [-t] [-y]
                       [-B] [-C] [-E] [-G] [-L] [-N] [-R] [-S] [-T]
                       [-U] [<in object>]

Options

-B	Block mesh generation method.
-C	Use conforming mesh (default).
-D	Debug flags: 1 Output the mesh as postscript to standard error output. 2 Output basis function distance maps to standard error output.
-e	Seed value for random displacements.
-E	Output evaluation times to stderr.
-G	Gradient mesh generation method.
-L	Use linear interpolation instead of nearest neighbour.
-m	Minimum mesh node separation distance (default 10.0).
-M	Maximum mesh node separation distance (default 100.0).
-N	Don't transform the object (useful for testing).
-r	Use random displacements with the given maximum displacement instead of displacement defined by a tie point file. If given the maximum displacement must be >= 1.0.
-R	Restrict the transformation to only a basis function transform instead of the default which uses a least squares affine and basis function transform.
-b	Basis function transform object.
-o	Output object file name.
-p	Tie point file.
-c	Use conformal polynomial basis function if tie points are given.
-d	Compute transform using conforming distance transforms, also sets the mesh generation to produce a conforming mesh and restricts the transformation to a basis function transform only (ie no least squares affine).
-g	Use Gaussian basis function if tie points are given.
-h	Help, prints usage message.
-P	Basis function parameter (eg MQ delta value).
-q	Use multi-quadric basis function if tie points are given.
-Q	Use inverse-multi-quadric basis function if tie points are given.
-s	Use thin plate spline basis function (default) if tie points are given.
-S	Snap tie point to mesh (only valid for conforming meshes).
-t	Target mesh. Only valid for conforming meshes. If given then the target mesh is used to compute a target-to-source radial basis function, with distances computed in the target mesh. This is then inverted as a mesh transform is created.
-T	Output a basis function transform instead of a transformed object.
-U	Output a mesh transform instead of a transformed object.
-y	Use polynomianl basis function if tie points are given.
-Y	Polynomial order for polynomial basis function (default 3).

Description

Computes and applies Woolz basis function transforms. Tie points may be read from an ascii file with the format:

  <vertex x> <vertex y> <displacement x> <displacement y>

Examples

WlzBasisFnTransformObj -o tied.wlz -p points.tie myobj.wlz

A thin plate spline basis function transform is computed from the tie points read from the file points.tie. This transform is then applied to the object is read from myobj.wlz. The resulting object is then written to tied.wlz.

File

WlzBasisFnTransformObj.c

See Also

WlzIntro(1) WlzAffineTransformObj(1) WlzMeshTransformObj(1) WlzBasisFnTransformObj(3)