---
name: "mia-3dtrackpixelmovement"
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-3dtrackpixelmovement"
---

# mia-3dtrackpixelmovement(1)

Track positions in 3D

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