MRGINGHAM(1)

NAME
mrgingham-rotate-corners - Adjust mrgingham corner detections from rotated cameras

SYNOPSIS
  # camera A is rightside-up
  # camera B is mounted sideways
  # cameras C,D are upside-down
  mrgingham --gridn N                \
    'frame*-cameraA.jpg'             \
    'frame*-cameraB.jpg'             \
    'frame*-cameraC.jpg'             \
    'frame*-cameraD.jpg' |           \
  mrgingham-rotate-corners --gridn N \
    --90 cameraB --180 'camera[CD]'

DESCRIPTION
The mrgingham chessboard detector finds a chessboard in an image, but it has no way to know whether the detected chessboard was upside-down or otherwise rotated: the chessboard itself has no detectable marking to make this clear. In the usual case, the cameras as all mounted in the same orientation, so they all detect the same orientation of the chessboard, and there is no problem. However, if some cameras are mounted sideways or upside-down, the sequence of corners will correspond to different corners between the cameras with different orientations. This can be addressed by this tool. This tool ingests mrgingham detections, and outputs them after correcting the chessboard observations produced by rotated cameras.

Each rotation option is an awk regular expression used to select images from specific cameras. The regular expression is tested against the image filenames. Each rotation option may be given multiple times. Any files not matched by any rotation option are passed through unrotated.

REPOSITORY
<https://github.com/dkogan/mrgingham>

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

LICENSE AND COPYRIGHT
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

Copyright 2017-2018 California Institute of Technology

Copyright 2017-2018 Dima Kogan ("dima@secretsauce.net")