mia-2deval...rmquantity(1)

💅 mia-2deval-transformquantity — bestie edition

okay so real talk, the full name of this page is mia-2deval-transformquantity(1) and it lives in the General Commands Manual, and it's about evaluating the derivative of a transformation ✨ buckle up, it's actually not that deep, i promise 🫶

---

✨ NAME ✨

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

---

🌸 SYNOPSIS 🌸

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

---

💖 DESCRIPTION 💖

so mia-2deval-transformquantity gets you the derivative of a transformation that you got by using image registration, at literally any positions you want, in 2D 💅 The position data comes in CSV format, like this:

id;time;x;y;reserved

The output data gets stored in a binary file with an ascii header describing the data. Here's an example header for you, bestie:

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

Now the way you read this example header, let me break it down: it's two-dimensional data, and each entry is 7 values — and those values are a 2D vector, a scalar, and a 2x2 matrix (saved in row-major format, no cap). 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. periodt 💅

---

✨ OPTIONS ✨

🎀 File-IO

• -i, --in-file=(required, 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 every single grid point of the transformation range. it's giving "your choice bestie" 💫
• -o, --out-file=(required, output); string — output strains file. for the format description, scroll up to the header example, i got you 🫶
• -t, --transformation=(required, input); io — the transformation whose quantity is gonna get evaluated. for supported file types, see PLUGINS:2dtransform/io below 👑

🌈 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: automatic estimation). yes it multithreads, slay 🧚

---

👑 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. iconic, honestly 🔥

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.

lowkey important bestie: that "ABSOLUTELY NO WARRANTY" part is not a vibe, it's literally the license. no cap 🙈

---

okay that's the whole page, you ate it 💅 this was USER COMMANDS, version v2.4.7, and the page goes by mia-2deval...rmquantity(1) — go forth and evaluate those derivatives, bestie 🎀✨🦋