---
name: "mia-3deval-transformquantity"
section: "1"
platform: "linux"
package: "mia-tools"
version: "2.4.7-11+b1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/mia-3deval-transformquantity"
---

# mia-3deval-transformquantity(1)

Evaluate derivative of a transformation

## NAME

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

## SYNOPSIS

**mia-3deval-transformquantity -o \<out-file\> -t \<transformation\> \[options\]**

## DESCRIPTION

**mia-3deval-transformquantity** Get derivative a transformation obtained by by using image registration for any given positions in 3D. The position data is given in CSV format:\
    id;time;x;y;z;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=3          #number of dimensions of the data\
   components=13  #number of components per element\
   component\_description=vector3,scalar,matrix3x3 #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 200 #grid size of the transformation\
   endian=low     #endianess of binary data (low\|big)  }

This example header has to be interpreted like follows: three-dimensional data, each entry consists of 13 values the values etry consists of a 3D vector, a scalar, and a 3x3 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 1000x1000x200 voxels and the binary data is stored in low endian format.

## OPTIONS

### File-IO

- \-i --in-file=(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=(input, required); io

  transformation of which the quantity will be evaluated.\
    For supported file types see PLUGINS:3dtransform/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: 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

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

mia-3deval-transformquantity -i input.csv -o output.s --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'.