.TH mia\-3dtrackpixelmovement 1 "v2.4.6"  "USER COMMANDS"
.SH NAME
('mia\\-3dtrackpixelmovement',)
\- Track positions in 3D
.SH SYNOPSIS
.B  mia\-3dtrackpixelmovement \-i <in\-file> \-o <out\-file> \-t <transformation> [options]
.SH DESCRIPTION
.B mia\-3dtrackpixelmovement
Track the position of a pixel by means of a transformation obtained by using image registration. The pixel data is given in CSV format
   id;time;x;y;z;reserved

The fields 'time', 'x', 'y', and 'z' are updated, and the fields 'id' and 'reserved' are preserved, empty lines are ignored.
.SH OPTIONS
.SS 
File-IO
.RS
.IP "\-i \-\-in-file=(input, required); string"
input point set

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

.IP "\-t \-\-transformation=(input, required); io"
transformation describing the monitored change
 For supported file types see PLUGINS:3dtransform/io
.RE
.SS 
Parameters
.RS
.IP "\-T \-\-time-step=1"
time step to use for the position update

.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
info
\(hy Low level messages
.RE
.RS 10
.I
trace
\(hy Function call trace
.RE
.RS 10
.I
fail
\(hy Report test failures
.RE
.RS 10
.I
warning
\(hy Warnings
.RE
.RS 10
.I
error
\(hy Report errors
.RE
.RS 10
.I
debug
\(hy Debug output
.RE
.RS 10
.I
message
\(hy Normal messages
.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
.SH PLUGINS: 3dtransform/io
.TP 10
.B bbs
Binary (non-portable) serialized IO of 3D transformations
.P
.RS 14
('Recognized file extensions: ', '.bbs')
.RE
 
.TP 10
.B datapool
Virtual IO to and from the internal data pool
.P
.RS 14
('Recognized file extensions: ', '.@')
.RE
 
.TP 10
.B vista
Vista storage of 3D transformations
.P
.RS 14
('Recognized file extensions: ', '.v, .v3dt')
.RE
 
.TP 10
.B xml
XML serialized IO of 3D transformations
.P
.RS 14
('Recognized file extensions: ', '.x3dt')
.RE
 
.SH EXAMPLE
This program evaluated the changed position of pixels given in input.csv, by using  a time step of 2.0 time units and the transformation change.v3df, and writes the updated positions to updated.csv.
.HP
mia\-3dtrackpixelmovement \-i input.csv \-o output.cvs \-\-time\-step 2.0 \-\-transformation change.v3df
.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'.