NAME

       mia-3dtrackpixelmovement - Track positions in 3D

SYNOPSIS

       mia-3dtrackpixelmovement -i <in-file> -o <out-file> -t <transformation> [options]

DESCRIPTION

       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.

OPTIONS

   File-IO
              -i --in-file=(input, required); string
                     input point set

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

              -t --transformation=(input, required); io
                     transformation describing the monitored change
                      For supported file types see PLUGINS:3dtransform/io

   Parameters
              -T --time-step=1
                     time step to use for the position update

   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: 3dtransform/io

       bbs       Binary (non-portable) serialized IO of 3D transformations

                     Recognized file extensions:  .bbs

       datapool  Virtual IO to and from the internal data pool

                     Recognized file extensions:  .@

       vista     Vista storage of 3D transformations

                     Recognized file extensions:  .v, .v3dt

       xml       XML serialized IO of 3D transformations

                     Recognized file extensions:  .x3dt

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.

       mia-3dtrackpixelmovement -i  input.csv  -o  output.cvs  --time-step  2.0  --transformation
              change.v3df

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