MRCAL(1)

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

✨ NAME ✨

mrcal-show-valid-intrinsics-region — bestie, this is the tool that shows you the valid-intrinsics region 👑 (it's a page out of the mrcal manual, section 1, if you were wondering 🎀)

🌸 SYNOPSIS 🌸

$ mrcal-show-valid-intrinsics-region --write-image --image image.png left.cameramodel
Wrote image-valid-intrinsics-region.png

💖 DESCRIPTION 💖

okay so. you hand this thing a camera model (or a whole lil squad of camera models), and it shows you the valid-intrinsics region(s). that's the whole vibe 💅

⚠️ every single model you pass in MUST have a valid-intrinsics region. no exceptions, fr fr. (empty regions are handled properly tho, so no stress there 🫶)

if you give it an image, the region gets rendered overlaid right on top of it ✨ iconic.

if you pass --points, then it also reads x,y points from STDIN and plots those too 📍

by default it uses gnuplotlib to make an interactive plot. alternately, pass --write-image and it'll annotate the image you gave it and write the new image out to disk 🦋

🚨 lowkey important: --write-image is not supported together with --points. pick a lane bestie 😭

🎀 OPTIONS 🎀

💫 POSITIONAL ARGUMENTS

  • models — the input camera model(s). yes you can bring multiple, it's a party 🌈

🍓 OPTIONAL ARGUMENTS

  • -h, --help — show this help message and exit. the classic. the icon 💖
  • --write-image — by default I make a plot. if --write-image is given, I output an annotated image instead. the image to annotate is then required, and you give it in --image 🖼️
  • --force, -f — with --write-image we refuse to overwrite any existing images. pass --force to allow overwriting (be brave, or don't 🙈)
  • --points — if given, I read a set of xy points from STDIN and include them in the plot. this applies ONLY if not --write-image ⭐
  • --title TITLE — extra title string for the plot 📝
  • --hardcopy HARDCOPY — write the output to disk, instead of making an interactive plot 💾
  • --terminal TERMINAL — gnuplotlib terminal. the default is good almost always, so most people don't need this option (iykyk) 🧚
  • --set SET — extra set directives to gnuplotlib. can be given multiple times 🔁
  • --unset UNSET — extra unset directives to gnuplotlib. can be given multiple times 🔁
  • --image IMAGE — image to annotate. used both with and without --write-image 🌸

🔥 REPOSITORY 🔥

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

👑 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

and that's the whole page bestie 🫶 this was mrcal 2.5.2-4build1, dated 2026-03-20, living in section 1 of the manual. go show someone their valid-intrinsics region, they'll literally thank you 💅✨

📦 where this page comes from