.TH mia\-3ddistance 1 "v2.4.7"  "USER COMMANDS"
.SH NAME
mia\-3ddistance
\- Evaluate the distance between two binary shapes.
.SH SYNOPSIS
.B  mia\-3ddistance \-i <in\-file> \-r <ref\-file> \-o <out\-file> [options]
.SH DESCRIPTION
.B mia\-3ddistance
This program takes two binary masks as input and evaluates the distance of one mask with respect to the other in voxel space. The output is given as text file with the coordinates of the source voxels and their distance to the reference mask. Correction for voxel size must be done after processing.
.SH OPTIONS
.SS File IO
.RS
.IP "\-i \-\-in-file=(required, input); string"
input image(s) that contain the source pixel mask

.IP "\-r \-\-ref-file=(required, input); string"
reference mask to evaluate the distance from

.IP "\-o \-\-out-file=(required, output); string"
output file name

.RE
.SS Help & Info
.RS
.IP "\-V \-\-verbose=warning"
verbosity of output, print messages of given level and higher priorities. Supported priorities starting at lowest level are:

.RS 10
.I
trace
\(hy Function call trace
.RE
.RS 10
.I
debug
\(hy Debug output
.RE
.RS 10
.I
info
\(hy Low level messages
.RE
.RS 10
.I
message
\(hy Normal messages
.RE
.RS 10
.I
warning
\(hy Warnings
.RE
.RS 10
.I
fail
\(hy Report test failures
.RE
.RS 10
.I
error
\(hy Report errors
.RE
.RS 10
.I
fatal
\(hy Report only fatal errors
.RE
.IP "   \-\-copyright"
print copyright information

.IP "\-h \-\-help"
print this help

.IP "\-? \-\-usage"
print a short help

.IP "   \-\-version"
print the version number and exit

.RE
.SS Processing
.RS
.IP "   \-\-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).

.RE
.SS Test
.RS
.IP "   \-\-self-test"
run a self test

.RE
.SH EXAMPLE
Evaluate the distance of the mask given in the images srcXXXX.png to the mask given in refXXXX.png and save the result to distances.txt
.HP
mia\-3ddistance \-i srcXXXX.png \-r refXXXX.png \-o distances.txt
.SH AUTHOR(s)
Gert Wollny
.SH COPYRIGHT
This software is Copyright (c) 1999\(hy2015 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'.