NOTICE

This package is meant to consolidate the camera models previously found in the Julia package ecosystem. There are still many gaps and community contributions are encouranged.

CameraModels.jl

Basic Camera Models including pinhole, radial distortion etc.

Click on badges to follow links:

Stable Release Dev branch Coverage Documentation
cms-ci-stb
version
cms-ci-dev-img cms-cov-img cjl-slack-badge
caesar-docs

Consolidated Package of Camera Models from Julia Community

The following camera calibration / projection models were found and consolidated in to a common CameraCalibration type with many helper functions to facility downstream adoption of this package:

JuliaRobotics/CameraModels.jl Image Convention

The image convention is intended to be the best compromise between JuliaImages's unified Array stack, and established OpenCV conventions. Also see Augmentor.jl's Images description, and open issues to help resolve miscommunication or convention issues. The following figure is hosted in this repo, with raw image for easy update via Excalidraw.com.

Camera frame and pixel indices

Images Convention

Robotics reference to camera frame

Image m_T_c

Roadmap

Project organization is currently done here:

Initial TODO List

  • Copy existing camera code from Caesar.jl and RoME.jl here,
  • Functional tests for consolidated CameraCalibration type
  • Implement radial distortion computations,
  • Numerical tests for pinhole camera model,
  • Homography point projections in 2D,
  • Improve documentation,
  • Integrate downstream with packages like AprilTags.jl and Caesar.jl
  • Tests for radial distortion model,
  • Homogeneous coordinates model,
  • ...

History

See NEWS.md.