mia-meshdistance-to-stackmask(1)

meshdistance-to-stackmask

Section 1 mia-tools bookworm source

Description

mia-meshdistance-to-stackmask

NAME

mia-meshdistance-to-stackmask - Evaluate the distance between a binary shape given as reference and a mesh.

SYNOPSIS

mia-meshdistance-to-stackmask -i <in-mesh> -r <ref-mask> -o <out-mesh> [options]

DESCRIPTION

mia-meshdistance-to-stackmask This program takes a binary masks and a triangular mesh as input and evaluates the distance of the mesh vertices to the binary maskand stores the result in a new mesh.

OPTIONS

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

input mesh
For supported file types see PLUGINS:mesh/io

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

reference binary mask
For supported file types see PLUGINS:2dimage/io

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

output mesh
For supported file types see PLUGINS:mesh/io

Help & Info

-V --verbose=warning

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

trace - Function call trace
debug
- Debug output
info
- Low level messages
message
- Normal messages
warning
- Warnings
fail
- Report test failures
error
- Report errors
fatal
- Report only fatal errors

--copyright

print copyright information

-h --help

print this help

-? --usage

print a short help

--version

print the version number and exit

Processing

--threads=-1

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).

PLUGINS: 2dimage/io

bmp

BMP 2D-image input/output support. The plug-in supports reading and writing of binary images and 8-bit gray scale images. read-only support is provided for 4-bit gray scale images. The color table is ignored and the pixel values are taken as literal gray scale values.

Recognized file extensions: .BMP, .bmp

Supported element types:

binary data, unsigned 8 bit

datapool

Virtual IO to and from the internal data pool

Recognized file extensions: .@

dicom

2D image io for DICOM

Recognized file extensions: .DCM, .dcm

Supported element types:

signed 16 bit, unsigned 16 bit

exr

a 2dimage io plugin for OpenEXR images

Recognized file extensions: .EXR, .exr

Supported element types:

unsigned 32 bit, floating point 32 bit

jpg

a 2dimage io plugin for jpeg gray scale images

Recognized file extensions: .JPEG, .JPG, .jpeg, .jpg

Supported element types:

unsigned 8 bit

png

a 2dimage io plugin for png images

Recognized file extensions: .PNG, .png

Supported element types:

binary data, unsigned 8 bit, unsigned 16 bit

raw

RAW 2D-image output support

Recognized file extensions: .RAW, .raw

Supported element types:

binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

tif

TIFF 2D-image input/output support

Recognized file extensions: .TIF, .TIFF, .tif, .tiff

Supported element types:

binary data, unsigned 8 bit, unsigned 16 bit, unsigned 32 bit

vista

a 2dimage io plugin for vista images

Recognized file extensions: .-, .V, .VISTA, .v, .vista

Supported element types:

binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

PLUGINS: mesh/io

datapool

Virtual IO to and from the internal data pool

Recognized file extensions: .@

off

plugin to load/store some Geomview OFF files. Supported is only the ASCII format 3D meshes with normales and per-vertex RGB colors. Alpha values and texture coordinates, as well as per face properties are ignored. Polygons are read and triangulated.

Recognized file extensions: .OFF, .off

ply

Ply triangle mesh input/output support

Recognized file extensions: .PLY, .ply

stl

STL mesh io plugin

Recognized file extensions: .STL, .stl

vista

Vista/Simbio triangle mesh input/output support

Recognized file extensions: .-, .V, .VMESH, .v, .vmesh

vtk

A subset of VTK mesh in-and output: Triangle meshes are written, and triangle meshes and triangle strips are read. Additional per-vertex attributes are supported: ’normals’, ’colors’ for three component colors, and ’scale’ for a scalar value attached to each vertex. The data is written by the vtkPolyDataWriter in binary format.

Recognized file extensions: .VTK, .VTKMESH, .vtk, .vtkmesh

EXAMPLE

Evaluate the distance of the mask given in the images maskXXXX.png to the mesh given in mesh.v and save the result to mesh-dist.v

mia-meshdistance-to-stackmask -i mesh.v -r maskXXXX.png -o mesh-dist.v

AUTHOR(s)

Gert Wollny

COPYRIGHT

This software is Copyright (c) 1999-2015 Leipzig, Germany and Madrid, Spain. It comes with ABSOLUTELY NO WARRANTY and you may redistribute it under the terms of the GNU GENERAL PUBLIC LICENSE Version 3 (or later). For more information run the program with the option ’--copyright’.