MRCAL(1)

✨ MRCAL(1) ✨

okay so bestie, you've stumbled into the mrcal man page zone β€” camera projection, calibration toolkit energy, and honestly? iconic. this one's about mrcal-to-cahvor, and yes it does exactly what it says on the tin πŸ’…


πŸ’– NAME πŸ’–

mrcal-to-cahvor β€” converts a cameramodel to the cahvor file format

no cap, that's the whole job. she's a format converter and she's thriving.


πŸŽ€ SYNOPSIS πŸŽ€

  $ mrcal-to-cahvor model1.cameramodel model2.cameramodel
  Wrote model1.cahvor
  Wrote model2.cahvor

see how chill that is? you hand her some models, she hands you back .cahvor files and a lil receipt. main character behavior fr fr πŸ¦‹


🌸 DESCRIPTION 🌸

File formats supported by mrcal are described at <https://mrcal.secretsauce.net/cameramodels.html#cameramodel-file-formats>

This tool converts the given model(s) to the cahvor file format. No changes to the content are made; this is purely a format converter (the mrcal-convert-lensmodel tool fits different lens models instead). Model filenames are given on the commandline. Output is written to the same directory, with the same filename, but with a .cahvor extension.

so like. no glow-up, no edits, no notes β€” she is not changing your content, she's just putting it in a different outfit. if you actually wanted a different lens model, that's mrcal-convert-lensmodel's whole thing, not hers. don't come for her about it 😭

you pass the model filenames on the commandline, and the output lands in the same directory with the same filename, except the extension is now .cahvor. periodt.

🫢 and if the model is omitted, or given as -, the input is read from standard input, and the output is written to standard output. pipes? she loves pipes.

🌈 OPTIONS 🌈

🌟 POSITIONAL ARGUMENTS 🌟

  • model β€” Input camera model. the whole point. the moment. the vibe check. give her one (or more) and she'll convert them πŸ’–

⭐ OPTIONAL ARGUMENTS ⭐

  • -h, --help β€” show this help message and exit. tiny, helpful, beloved.
  • --force, -f β€” By default existing files are not overwritten. Pass --force to overwrite them without complaint. so like, by default she's polite and won't clobber your stuff. --force is her "say less" mode β€” she overwrites and does not complain about it at all πŸ’€
  • --outdir OUTDIR β€” Directory to write the output models into. If omitted, we write the output models to the same directory as the input models. basically: tell her where to drop the files, or she'll just leave them right next to their siblings πŸŽ€

🧚 REPOSITORY 🧚

<https://www.github.com/dkogan/mrcal>

come thru, the source is right there ✨


πŸ‘‘ AUTHOR πŸ‘‘

Dima Kogan, <dima@secretsauce.net>

the legend herself. we stan 🫢


Copyright (c) 2017-2023 California Institute of Technology ("Caltech"). U.S. Government sponsorship acknowledged. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

read the license bestie, it's literally right there and it's giving responsible 🌸


πŸ’… sign-off: this page is from mrcal 2.5.2-4build1, dated 2026-03-20, and it's the MRCAL(1) manual. now go convert some models, you absolute icon πŸ’–βœ¨πŸ¦‹
πŸ“¦ where this page comes from