mia-3ddistance {-i string} {-r string} {-o string} [ options ...]


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.


File IO

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

input image(s) that contain the source pixel mask

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

reference mask to evaluate the distance from

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

output file name

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


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



run a self test


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

mia-3ddistance -i srcXXXX.png -r refXXXX.png -o distances.txt


Gert Wollny