Skip to content

doc: Add FAQ on reusing OpenCV/Kalibr calibration parameters#4566

Open
behnamasadi wants to merge 1 commit into
colmap:mainfrom
behnamasadi:docs/2587-opencv-kalibr-intrinsics
Open

doc: Add FAQ on reusing OpenCV/Kalibr calibration parameters#4566
behnamasadi wants to merge 1 commit into
colmap:mainfrom
behnamasadi:docs/2587-opencv-kalibr-intrinsics

Conversation

@behnamasadi

Copy link
Copy Markdown
Contributor

Summary

Adds a FAQ entry for a recurring question (#2587, also raised for Kalibr) on
reusing externally-calibrated intrinsics in COLMAP:

  • Pixel-coordinate convention: COLMAP uses a corner origin (the top-left
    pixel center is at (0.5, 0.5), a centered principal point is
    (width/2, height/2)), whereas OpenCV/Kalibr use pixel-center integer
    coordinates. The principal point therefore shifts by +0.5 in both axes
    (cx_colmap = cx_opencv + 0.5); focal lengths and distortion coefficients
    transfer unchanged.
  • Distortion parameter order for the OPENCV/FULL_OPENCV models.

Verified against Camera::CreateFromModelId / CameraModelInitializeParams
(principal point is initialized at width/2, height/2). Docs build cleanly with
Sphinx.

Documents the 0.5-pixel principal-point offset between COLMAP's
corner-origin convention and the pixel-center convention used by OpenCV
and Kalibr, plus the OPENCV/FULL_OPENCV distortion parameter order.

Addresses recurring confusion in colmap#2587.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant