mia-mesh-deformable-model {-i io} {-o io} {-r io} [ options ...]


This program runs a deformable model to adapt a mesh to an iso-value within a given image. <FIXME: Reference>


File I/O

-i, --in-file=(input, required); io

input mesh to be adapted. For supported file types see Plugin type: mesh/io

-o, --out-file=(required, output); io

output mesh that has been deformed. For supported file types see Plugin type: mesh/io

-r, --ref-file=(input, required); io

reference image. For supported file types see Plugin type: 3dimage/io

Help & Info

-V, --verbose=warning; dict

verbosity of output, print messages of given level and higher priorities. Supported priorities starting at lowest level are:

debug:Debug output
message:Normal messages
info:Low level messages
error:Report errors
fatal:Report only fatal errors
trace:Function call trace
fail:Report test failures
--copyright=(); bool

print copyright information

-h, --help=(); bool

print this help

-?, --usage=(); bool

print a short help

--version=(); bool

print the version number and exit

Model parameters

--smoothing-weight=0.04; float in [0, inf)

Weight of the inner force used to smooth the mesh

--gradient-weight=0.04; float

Weight of the gradient force drive the mesh deformation. Use a negative value to invert the search direction.

--intensity-weight=0.02; float in [0, inf)

Weight of the force resulting from the intensity difference at the vertex position versus the reference intensity 'iso'.

--intensity-scaling=1; float in (0, inf)

Scaling of the raw intensity difference.

-s, --iso=64; float

Intensity value the mesh verices should adapt to.


--image-smoothing=gauss:w=2; factory

Prefilter to smooth the reference image.. For supported plug-ins see Plugin type: 3dimage/filter


--threads=-1; int

Maxiumum number of threads to use for processing,This number should be lower or equal to the number of logical processor cores in the machine. (-1: automatic estimation).

-m, --maxiter=200; uint in (0, inf)

Maximum number of iterations.

-e, --epsilon=0.001; float in (0, inf)

Stop iteration when the maximum shift of the vertices falls below this value


Reorientate the mesh triangles


Run the deforemable model on input.vmesh with 200 iterations adapting to a value of 128 in the image ref.v and save the result to deformed.vmesh

mia-mesh-deformable-model -i input.vmesh -o deformed.vmesh --iso 128 --maxiter 200


Gert Wollny