NAME

       mrcal-reproject-points - Reprojects pixel observations from one model to another

SYNOPSIS

         $ < points-in.vnl
           mrcal-reproject-points
             from.cameramodel to.cameramodel
           > points-out.vnl

DESCRIPTION

       This tool takes a set of pixel observations of points captured by one camera model, and
       transforms them into observations of the same points captured by another model. This is
       similar to mrcal-reproject-image, but acts on discrete points, rather than on whole
       images. The two sets of intrinsics are always used.  The translation component of the
       extrinsics is always ignored; the rotation is ignored as well if --intrinsics-only.

       This allows one to combine multiple image-processing techniques that expect different
       projections. For instance, planes projected using a pinhole projection have some nice
       properties, and we can use those after running this tool.

       The input data comes in on standard input, and the output data is written to standard
       output. Both are vnlog data: human-readable text with 2 columns: x and y pixel coords.
       Comments are allowed, and start with the '#' character.

OPTIONS

   POSITIONAL ARGUMENTS
         model-from         Camera model for the input points.
         model-to           Camera model for the output points.

   OPTIONAL ARGUMENTS
         -h, --help         show this help message and exit
         --intrinsics-only  By default, the relative camera rotation is used in the
                            transformation. If we want to use the intrinsics ONLY,
                            pass --intrinsics-only. Note that relative translation is
                            ALWAYS ignored

REPOSITORY

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

AUTHOR

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

LICENSE AND COPYRIGHT

       Copyright (c) 2017-2021 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