mia-3deval...rmquantity(1)

💖 mia-3deval-transformquantity — a Gen Z field guide 💖

okay bestie, so this whole page is from the General Commands Manual, section 1, and the command it's all about is mia-3deval-transformquantity. Say it with me one more time: mia-3deval-transformquantity. It's a mouthful but she's worth it. 🫶

---

✨ NAME ✨

mia-3deval-transformquantity — evaluate the derivative of a transformation. that's it, that's the whole vibe.

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

so like, mia-3deval-transformquantity gets you the derivative of a transformation that you got from image registration, evaluated at literally any positions you want in 3D. main character energy fr. 💅

Your position data comes in as CSV, formatted like this:

id;time;x;y;z;reserved

The output? It gets stored in a binary file with an ascii header describing what's inside. Here's an example header for you:

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) }

and now let's decode this header together because it's giving ✨lore✨:

• three-dimensional data 🧊
• each entry has 13 values, and those 13 values break down into 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 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

no cap, that's a whole lot of information in one little header. she ate. 👑

---

🎀 OPTIONS 🎀

💜 File-IO

• -i, --in-file=(input); string — input point set. if you pass this, you get a sparse evaluation of the quantity. if you don't, the quantity gets evaluated for each grid point of the transformation range. your call bestie.
• -o, --out-file=(output, required); string — output strains file. format description? see above, we literally just went over it 💖
• -t, --transformation=(input, required); io — the transformation whose quantity is getting evaluated. for supported file types, go peek at PLUGINS:3dtransform/io (it's right down there ⬇️)

🌈 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; prints messages of the given level and higher priorities. 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

🧚 Processing

• --threads=-1 — maximum 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 means automatic estimation, so like, she'll figure it out herself 💫)

---

⭐ PLUGINS: 3dtransform/io ⭐

the supported file types for -t, in all their glory:

• 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 🔥

so the derivative of the transformation change.v3df for each point given in input.csv gets evaluated and written to output.s. here's the moment, bestie:

mia-3deval-transformquantity -i input.csv -o output.s --transformation change.v3df

ngl, copy it, run it, slay. 🫶

---

👑 AUTHOR(s) 👑

Gert Wollny — yes, an actual legend wrote this.

---

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

⚠️ ok real talk, "ABSOLUTELY NO WARRANTY" is in all caps for a reason — that's the legal vibe, don't skip it.

---

and that's the whole page, bestie!! this one's from the USER COMMANDS crew, v2.4.7, and it was living under the title mia-3deval...rmquantity(1) the whole time (yes, the manpage header really does abbreviate it like that, iconic behavior honestly 😭). go evaluate some derivatives. periodt. 💖✨🦋