CONVERT_IMAGE(1)

💖 CONVERT_IMAGE(1) 💖

okay so bestie, welcome to the convert_image page — it lives in your General Commands Manual and it's literally the glow-up station for your detector images ✨

---

✨ NAME ✨

convert_image — turn images into CBF format using a template, no cap 🎀

---

🦋 SYNOPSIS 🦋

convert_image [options]

---

🌸 DESCRIPTION 🌸

So here's the tea, bestie: convert_image is that girl. She takes images from a MAR180, MAR300, MAR345 or ADSC CCD detector and converts them straight into CBF format. Iconic behavior honestly 💅

She needs two arguments: imagefile and cbffile. Those are the primary input and output, the main characters of this whole operation 👑

The detector type gets extracted from the image file or from the command line, then it's converted to lower case and used to build the name of a template cbf file for the copy. The template file name looks like this, exactly:

template_name_columnsxrows

To run makecbf with the example image, you type:

makecbf example.mar2300 test.cbf

not me showing you the exact line to copy-paste because I love you 🫶

---

💅 OPTIONS 💅

• -i input_img — (default: stdin) the input file as an image in smv, mar300, or mar345 format. If input_img isn't specified, or you pass it as "-", it gets copied from stdin to a temporary file. Sneaky but valid 🐛
• -p template_cbf — the template for the final cbf that's about to be produced. If template_cbf isn't specified, the name gets constructed from the first token of the detector name and the image size, like this:

template_<type>_<columns>x<rows>.cbf

• -o output_cbf — (default: stdout) the output cbf, aka the image and the template combined into one. If output_cbf isn't specified, or you give it as "-", it's written to stdout. Slay 💖
• -d detectorname — a detector name to use if none is provided in the image header. Your backup plan, your safety net, your ride-or-die 🌈
• -F — when writing packed compression, treat the entire image as one line with no averaging. One line. No averaging. That's the vibe ✨
• -m [x|y|x=y] — (default x=y, square arrays only) mirror the array in the x-axis (y -> -y), in the y-axis (x -> -x) or in x=y (x -> y, y-> x). Choose your reflection era 🪞
• -r n — rotate the array n times 90 degrees counter clockwise: x -> y, y -> -x for each rotation. n = 1, 2 or 3. Spin it, bestie 🌀
• -R — if you're setting a beam center, this sets the reference values of axis settings as well as the standard settings. Extra thorough, very main character 💜
• -z distance — detector distance along the Z-axis. Depth, literally 📏
• -c category_alias=category_root — 🌸
• -t tag_alias=tagroot — map the given alias to the given root, so that instead of outputting the alias, the root will be presented in the output cbf instead. These options may be repeated as many times as you need — go off, stack them, I'm not judging 💅

---

👑 SEE ALSO 👑

cif2cbf(1), img2cif(1), makecbf(1).

the whole friend group, fr fr 🫶

---

🎀 AUTHOR 🎀

convert_image was written by Herbert J. Bernstein.

This manual page was written by Morten Kjeldgaard <mok@bioxray.au.dk>, for the Debian project (but may be used by others). generous queen behavior ✨

---

and that's the whole page, bestie — April, 2008, CONVERT_IMAGE(1), you're welcome, mwah 💖💅🦋