mia-3dtrackpixelmovement(1)

✨ NAME ✨

mia-3dtrackpixelmovement — bestie, we're tracking positions in 3D 💅

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

okay so mia-3dtrackpixelmovement tracks where a pixel ends up by using a transformation you got from image registration. like, the glow-up journey of one single pixel, fr fr ✨

The pixel data comes in as CSV, and it looks like this:

id;time;x;y;z;reserved

The fields time, x, y, and z get updated (they're the main characters), while id and reserved are preserved exactly as they were (they're just here for the vibes, and we respect that 🫶). Empty lines? Ignored. Not even a vibe check.

---

🎀 OPTIONS 🎀

💖 File-IO

• -i, --in-file=(input, required); string — the input point set. yes queen, you have to give us one.
• -o, --out-file=(output, required); string — the output point set. also mandatory, no skips.
• -t, --transformation=(input, required); io — the transformation that describes the monitored change. required, and for the supported file types go peek at PLUGINS:3dtransform/io below 👇

💜 Parameters

• -T, --time-step=1 — the time step used for the position update. default is 1, iconic.

🩷 Help & Info

• -V, --verbose=warning — how chatty the output is. it prints messages at the given level and anything higher-priority. the supported priorities, starting at the 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, periodt

💙 Processing

• --threads=-1 — maximum number of threads to use for processing. this number should be lower than or equal to the number of logical processor cores in the machine. (-1: automatic estimation). so like, let the machine decide if you don't wanna ✨

---

🌈 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. slay 💅

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.

no cap, ABSOLUTELY NO WARRANTY means what it says bestie, read it again if you have to 😭

---

okay that's the whole page!! this was USER COMMANDS, version v2.4.7, and the page is mia-3dtrackpixelmovement(1) — go track some pixels, you got this 🧚✨🫶