UNU-CONVERT(1)

💖 UNU-CONVERT(1) 💖

okay bestie, gather round, because unu-convert is literally the glow-up station for your nrrd files. it's a user command, it lives in section 1 of the manual, and it is about to change your data's whole type. no cap.

---

✨ NAME ✨

unu-convert — convert to another type (as if by cast, w/ optional clamp)

---

🌸 SYNOPSIS 🌸

unu convert -t,--type <type> [-i,--input <nin>] [-clamp] [-o,--output
<nout>]

---

🦋 DESCRIPTION 🦋

so here's the vibe: unu convert converts to another type, as if by cast, w/ optional clamp. 💅

and the tea is — by default this does not transform, scale, or intelligently quantize values. it just copies them from one type to another. that replicates exactly what you'd get in C when you assign from a variable of one type to another, or when you cast to a different type. like, it's giving raw cast energy, no fancy glow-up, no remix. 🔥

but — and this is the main character moment — clamping values to the representable range of the output type is possible with -clamp. 🎀

see also unu-quantize(1), unu-2op(1) x, and unu-3op(1) clamp if you want the other tools in this friend group.

• Uses nrrdConvert or nrrdClampConvert

---

💅 OPTIONS 💅

• -t <type>, --type <type> — the type you're converting to. this is the whole point, bestie, it's required, don't skip it. ✨
• -i <nin>, --input <nin> — the input nrrd. your raw material. 🍓
• -clamp — clamp input values to the representable range of values of the output type, to avoid wrap-around problems. okay so this one matters: without it you can get wrap-around weirdness, and with it you get safely squished-into-range values. it's giving seatbelt. 🫶
• -o <nout>, --output <nout> — output nrrd (string); default: "-". yeah default is "-", which is the classic "just send it somewhere sensible" move. 🌈

---

👑 SEE ALSO 👑

unu(1), unu-2op(1), unu-3op(1), unu-quantize(1)

---

and that's the whole page, babe 💜 this little icon was living in the User Commands section, source/version vibes from May 2021, and yeah, it's literally titled UNU-CONVERT(1). periodt. 🧚💖