mia-3ddistance(1)

📦
version 2.4.7 · 2 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

💖 mia-3ddistance(1) 💖

okay bestie, so this is a page from the General Commands Manual — it's mia-3ddistance, and it lives in the USER COMMANDS section. hi, hello, welcome, let's get into it ✨

🌸 NAME 🌸

mia-3ddistance — Evaluate the distance between two binary shapes.

like, two masks, how far apart are they, that's the whole vibe 🦋

✨ SYNOPSIS ✨

mia-3ddistance -i <in-file> -r <ref-file> -o <out-file> [options]

💅 DESCRIPTION 💅

So mia-3ddistance takes two binary masks as input and evaluates the distance of one mask with respect to the other in voxel space. No cap.

The output? It's a text file with the coordinates of the source voxels and their distance to the reference mask. That's it, that's the tea. 🍓

okay quick heads-up bestie — correction for voxel size must be done after processing. The program is not gonna do it for you. that part is on you. 😭

🎀 OPTIONS 🎀

🌈 File IO

  • -i, --in-file=(input, required); string — the input image(s) that contain the source pixel mask
  • -r, --ref-file=(input, required); string — the reference mask to evaluate the distance from
  • -o, --out-file=(output, required); string — the output file name

🫶 Help & Info

  • -V, --verbose=warning — verbosity of output; it prints messages of the given level and higher priorities. here are the supported priorities, starting at the lowest level:
    • 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.)
(yes it really says "Maxiumum", no I will not be fixing it, that's the canon 💀)

⭐ Test

  • --self-test — run a self test

👑 EXAMPLE 👑

Evaluate the distance of the mask given in the images srcXXXX.png to the mask given in refXXXX.png and save the result to distances.txt

mia-3ddistance -i srcXXXX.png -r refXXXX.png -o distances.txt

🦋 AUTHOR(s) 🦋

Gert Wollner

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

and that's the whole page, bestie!! this was written for v2.4.7 and the footer dates it at the bottom of the user commands section — slay, go evaluate some distances, periodt 💜✨

📦 where this page comes from