.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "MRCAL 1"
.TH MRCAL 1 2024-02-04 "mrcal 2.3-4.1~exp1" "mrcal: camera projection, calibration toolkit"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
mrcal\-show\-distortion\-off\-pinhole \- Visualize the behavior or a lens model
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&  $ mrcal\-show\-distortion\-off\-pinhole \-\-vectorfield left.cameramodel
\&
\&  ... a plot pops up showing the vector field of the difference from a pinhole
\&  projection
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This tool is used to examine how a lens model behaves. Depending on the model,
the vectors could be very large or very small, and we can scale them by passing
\&'\-\-vectorscale s'. By default we sample in a 60x40 grid, but this spacing can be
controlled by passing '\-\-gridn w h'.
.PP
By default we render a heat map of the lens effects. We can also see the
vectorfield by passing in \-\-vectorfield. Or we can see the radial distortion
curve by passing \-\-radial
.SH OPTIONS
.IX Header "OPTIONS"
.SS "POSITIONAL ARGUMENTS"
.IX Subsection "POSITIONAL ARGUMENTS"
.Vb 2
\&  model                 Input camera model. If "\-\*(Aq is given, we read standard
\&                        input
.Ve
.SS "OPTIONAL ARGUMENTS"
.IX Subsection "OPTIONAL ARGUMENTS"
.Vb 10
\&  \-h, \-\-help            show this help message and exit
\&  \-\-gridn GRIDN GRIDN   How densely we should sample the imager. By default we
\&                        report a 60x40 grid
\&  \-\-vectorscale VECTORSCALE
\&                        Scale the vectors by this factor. Default is 1.0
\&                        (report the truth), but this is often too small to see
\&  \-\-radial              Show the radial distortion scale factor instead of a
\&                        colormap/vectorfield
\&  \-\-vectorfield         Plot the diff as a vector field instead of as a heat
\&                        map. The vector field contains more information
\&                        (magnitude AND direction), but is less clear at a
\&                        glance
\&  \-\-show\-fisheye\-projections
\&                        If given, the radial plots include the behavior of
\&                        common fisheye projections, in addition to the
\&                        behavior of THIS lens
\&  \-\-cbmax CBMAX         Maximum range of the colorbar
\&  \-\-title TITLE         Title string for the plot. Overrides the default
\&                        title. Exclusive with \-\-extratitle
\&  \-\-extratitle EXTRATITLE
\&                        Additional string for the plot to append to the
\&                        default title. Exclusive with \-\-title
\&  \-\-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\*(Aqt need this option
\&  \-\-set SET             Extra \*(Aqset\*(Aq directives to pass to gnuplotlib. May be
\&                        given multiple times
\&  \-\-unset UNSET         Extra \*(Aqunset\*(Aq directives to pass to gnuplotlib. May be
\&                        given multiple times
.Ve
.SH REPOSITORY
.IX Header "REPOSITORY"
<https://www.github.com/dkogan/mrcal>
.SH AUTHOR
.IX Header "AUTHOR"
Dima Kogan, \f(CW\*(C`<dima@secretsauce.net>\*(C'\fR
.SH "LICENSE AND COPYRIGHT"
.IX Header "LICENSE AND COPYRIGHT"
Copyright (c) 2017\-2021 California Institute of Technology ("Caltech"). U.S.
Government sponsorship acknowledged. All rights reserved.
.PP
Licensed under the Apache License, Version 2.0 (the "License");
You may obtain a copy of the License at
.PP
.Vb 1
\&    http://www.apache.org/licenses/LICENSE\-2.0
.Ve