mia-3dimagecombine(1)

👑 mia-3dimagecombine — the girlies' guide (manual page, section 1)

okay so bestie, welcome to mia-3dimagecombine from the General Commands Manual — she's a real one, no cap 💅

---

✨ NAME ✨

mia-3dimagecombine — combine two 3D images, fr fr. that's it, that's the whole job, and she does it beautifully 🫶

---

🌸 SYNOPSIS 🌸

mia-3dimagecombine -1 <image1> -2 <image2> -c <combiner> -o <out-file>
[options]

---

💖 DESCRIPTION 💖

okay so mia-3dimagecombine — this program is literally the tool for combining two images. you give it a combiner, you give it two images, and it does its little thing. main character energy only 💅✨

---

🎀 OPTIONS 🎀

• -1, --image1=(input, required); io — input image 1, the one to be combined (required, so like, you cannot skip her 🙈). for supported file types, go check out PLUGINS:3dimage/io.
• -2, --image2=(input, required); io — input image 2, also to be combined, also required (she's not optional either, bestie). for supported file types, see PLUGINS:3dimage/io.
• -c, --combiner=(required); factory — the combiner operation, aka the how of the combining. required, obviously. for supported plugins see PLUGINS:3dimage/combiner.
• -o, --out-file=(output, required); io — the output image file, where all your hard work lands. required! for supported file types see PLUGINS:3dimage/io.

🦋 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 (she's helpful like that 💁)
• -?, --usage — print a short help, for when you're in a hurry
• --version — print the version number and exit, iconic

⚙️ 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 the manpage really spells it "maxiumum", we keep the lore intact 😭✨

---

🔥 PLUGINS: 3dimage/combiner 🔥

the combiner besties, all of them, absolutely serving:

• absdiff — Image combiner 'absdiff'

(no parameters)

• add — Image combiner 'add'

(no parameters)

• div — Image combiner 'div'

(no parameters)

• mul — Image combiner 'mul'

(no parameters)

• sub — Image combiner 'sub'

(no parameters)

---

🌈 PLUGINS: 3dimage/io 🌈

the file-format girlies, each one a different vibe:

• analyze — Analyze 7.5 image

Recognized file extensions: .HDR, .hdr

Supported element types:

• unsigned 8 bit, signed 16 bit, signed 32 bit, floating point 32 bit, floating point 64 bit

• datapool — Virtual IO to and from the internal data pool

Recognized file extensions: .@

• dicom — Dicom image series as 3D

Recognized file extensions: .DCM, .dcm

Supported element types:

• signed 16 bit, unsigned 16 bit

• hdf5 — HDF5 3D image IO

Recognized file extensions: .H5, .h5

Supported element types:

• binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, signed 64 bit, unsigned 64 bit, floating point 32 bit, floating point 64 bit

• inria — INRIA image

Recognized file extensions: .INR, .inr

Supported element types:

• signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

• mhd — MetaIO 3D image IO using the VTK implementation (experimental).

experimental, bestie — she's still figuring herself out, be gentle 🥺

Recognized file extensions: .MHA, .MHD, .mha, .mhd

Supported element types:

• signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

• nifti — NIFTI-1 3D image IO. The orientation is transformed in the same way like it is done with dicomtonifti --no-reorder from the vtk-dicom package.

Recognized file extensions: .NII, .nii

Supported element types:

• signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, signed 64 bit, unsigned 64 bit, floating point 32 bit, floating point 64 bit

• vff — VFF Sun raster format

Recognized file extensions: .VFF, .vff

Supported element types:

• unsigned 8 bit, signed 16 bit

• vista — Vista 3D

Recognized file extensions: .-, .V, .VISTA, .v, .vista

Supported element types:

• binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

• vti — 3D image VTK-XML in- and output (experimental).

experimental again — handle with care and love 💜

Recognized file extensions: .VTI, .vti

Supported element types:

• signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

• vtk — 3D VTK image legacy in- and output (experimental).

yep, also experimental. we stan a work-in-progress ✨

Recognized file extensions: .VTK, .VTKIMAGE, .vtk, .vtkimage

Supported element types:

• signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

---

🍓 EXAMPLE 🍓

Take two images l1.v and l2.v and evaluate the per-voxel sum.

mia-3dimagecombine -1 l1.v -2 l2.v -c sum.v -c add

okay so this is exactly how the manpage writes it — -c twice, and sum.v sitting in the combiner slot — so we're keeping it character-for-character because that's the assignment, bestie. don't @ me 💀

---

💜 AUTHOR(s) 💜

Gert Wollny — the legend herself 👑

---

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

ABSOLUTELY NO WARRANTY — she said what she said, and she meant it 🫶

---

and that's the whole page, bestie! this was the USER COMMANDS version, v2.4.7, and yeah, the page is literally titled mia-3dimagecombine(1). go combine some 3D images, you've got this 💅✨🎀