NAME

       mia-2deval-transformquantity - Evaluate derivative of a transformation

SYNOPSIS

       mia-2deval-transformquantity -i <in-file> -o <out-file> -t <transformation> [options]

DESCRIPTION

       mia-2deval-transformquantity Get derivative a transformation obtained by using image registration for any
       given positions in 2D. The position data is given in CSV format:
          id;time;x;y;reserved The output data will be stored in a binary file with an ascii  header  describing
       the data. An example header is given below:

       MIA tensorfield {
         dim=2          #number of dimensions of the data
         components=7  #number of components per element
         component_description=vector2,scalar,matrix2x2 #interpretation of components
         elements=20    #number of elements in file
         interpretation=strain #interpretation of elements (strain|derivative)
         style=sparse   #storage style (sparse|grid)
         repn=float32   #representation of values
         size=1000 1000 #grid size of the transformation
         endian=low     #endianess of binary data (low|big) }

       This  example  header  has to be interpreted like follows: two-dimensional data, each entry consists of 7
       values the values etry consists of a  2D  vector,  a  scalar,  and  a  2x2  matrix  (saved  in  row-major
       format).The  data  records represent strain tensors, and only a sparse set of points is given. The values
       are given as single floating point (32 bit). The original transformation field corresponds to  images  of
       1000x1000 pixels and the binary data is stored in low endian format.

OPTIONS

   File-IO
              -i --in-file=(required, input); string
                     input  point  set,  if  this parameter is given a sparse evaluation of the quantity will be
                     done, otherwise the quantity is evaluated for each grid point of the transformation range.

              -o --out-file=(required, output); string
                     output strains file, for a format description see above.

              -t --transformation=(required, input); io
                     transformation of which the quantity will be evaluated.
                      For supported file types see PLUGINS:2dtransform/io

   Parameters
              -q --quantity=strain
                     Specify the quantity to be evaluated at the given points

                        derivative ‐ Evaluate the transformation derivative at the given points
                        strain ‐ Evaluate the strain tensor at the given points

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

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

                     Recognized file extensions:  .bbs

       datapool  Virtual IO to and from the internal data pool

                     Recognized file extensions:  .@

       vista     Vista storage of 2D transformations

                     Recognized file extensions:  .v2dt

       xml       XML serialized IO of 2D transformations

                     Recognized file extensions:  .x2dt

EXAMPLE

       Derivative of the transformation change.v2df for each  point given in input.csv are evaluated and written
       to output.s.

       mia-2deval-transformquantity -i input.csv -o output.s --transformation change.v2df

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