VOXELTOWORLD(1)

💫 VOXELTOWORLD — the manual page, but make it a group chat 💫

okay bestie, so this is page 1 of the MINC User's Guide, and it's literally the glow-up guide for two lil coordinate-translating programs that are lowkey sisters: voxeltoworld and worldtovoxel. one goes one way, one goes the other. iconic behavior honestly 💅

✨ NAME ✨

voxeltoworld — convert voxel coordinates to world coordinates

worldtovoxel — convert world coordinates to voxel coordinates

no cap, that's the whole personality. one translates voxel ➡️ world, the other does world ➡️ voxel. a matched set, fr fr 🎀

🦋 SYNOPSIS 🦋

voxeltoworld filename v1 v2 v3

worldtovoxel filename x y z

so you hand it a file and three numbers and it does its lil translation thing. that's it. that's the whole vibe ✨

🌸 DESCRIPTION 🌸

okay so the tea is this: both programs transform the coordinates of a point between the voxel and world coordinate systems. they're basically bilingual, but for coordinate systems 🗣️💬

and the voxel coordinate system? it's aligned with the sampling grid of the image volume. so it's the "which lil cube in the grid are we in" system. the grid-honoring one. the one that knows where the voxels live 🧊

💖 OPTIONS 💖

• -help — prints a lil summary of the command-line options and then dips out (exits). it's giving "here's the menu, byeeeee" 👋
• -version — prints the program's version number and exits. so you can know exactly which version you're dealing with, bestie 🏷️

👑 EXAMPLES 👑

so say you wanna get the start positions of all three spatial coordinate axes, but in world coordinates. you'd do this:

voxeltoworld file.mnc 0 0 0

and that's the move 💫 zero zero zero into world space. slay.

🫶 AUTHOR 🫶

Peter Neelin — the og, the main character who made this happen 👑

🌈 COPYRIGHT 🌈

Copyright © 1993 by Peter Neelin

💀 psst — remember, this page covers two programs at once, so if you're like "wait which one am i running" the answer is whichever one you typed. mystery solved, bestie 🕵️♀️

and that's the page!! from the MINC User's Guide, dated $Date: 2004-05-20 21:52:07 $, and yeah it's an oldie but a goodie — 2004 said "let me leave this here for the girlies" and we're still eating it up. periodt. 💅✨🦋