MRCAL(1)

📦
version 2.5.2 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 MRCAL(1) — mrcal: camera projection, calibration toolkit 💖

okay bestie, welcome to the mrcal cinematic universe ✨ this whole manual lives under the umbrella of the mrcal: camera projection, calibration toolkit thing, and today's main character is a lil tool called mrcal-from-cahvor. she's small, she's focused, she eats file formats for breakfast 🍓

🌸 NAME 🌸

mrcal-from-cahvor — Converts a .cahvor-formatted camera model to the .cameramodel file format 🦋

like. that's it. that's the job. and she does it flawlessly, no cap.

✨ SYNOPSIS ✨

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

see how she just... does it? two in, two out, no drama 💅

💜 DESCRIPTION 💜

File formats supported by mrcal are described at <https://mrcal.secretsauce.net/cameramodels.html#cameramodel-file-formats> — go read that if you want the full lore, it's giving encyclopedia but make it camera models 📸

This tool converts the given model(s) to the cameramodel file format. And here's the thing, bestie: no changes to the content are made. None. Zero. This is purely a format converter — it's not out here fitting anything, it's just repackaging the vibes into a different container. (If you do want different lens models actually fitted, that's a whole different girl: the mrcal-convert-lensmodel tool. she's the one doing the math. this one is just doing the paperwork 🎀)

Model filenames are given on the commandline. Output is written to the same directory, with the same filename, but with a .cameramodel extension. same name, glow-up extension, iconic behavior honestly ✨

If the model is omitted or given as -, the input is read from standard input, and the output is written to standard output. yes bestie, she does pipes. she's flexible like that 🌈

👑 OPTIONS 👑

🧚 POSITIONAL ARGUMENTS

  • model — Input camera model. this is the file you're feeding her, she'll take it from here 💖

⭐ OPTIONAL ARGUMENTS

  • -h, --help — show this help message and exit. the classic. the icon. when in doubt, ask her to explain herself 🫶
  • --force, -f — By default existing files are not overwritten. Pass --force to overwrite them without complaint. so like... she's polite by default, she will NOT bulldoze your existing files 🙈 but if you hand her the --force flag she stops asking questions and just goes. your files, your call, bestie 💀
  • --outdir OUTDIR — Directory to write the output models into. If omitted, we write the output models to the same directory as the input models. so by default she drops the new files right next to their originals, cute little siblings 🦋 or you point her somewhere else and she goes there instead, no complaints 💅

🌈 REPOSITORY 🌈

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

go say hi, star the repo, it's the respectful thing to do ⭐

💖 AUTHOR 💖

Dima Kogan, "<dima@secretsauce.net>"

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
fr fr, that's the whole page. legal said what legal said, and we respect it 🫡

okay that's the tea, bestie — go convert some camera models, you got this 💅✨

signing off from mrcal version 2.5.2-4build1, dated 2026-03-20 — mwah, love u, bye 🩷

📦 where this page comes from