Python API Overview¶

This is the Python API documentation for libCalibGeom, adapted from the C++ library workflow.

libCalibGeom is a feature-rich calibration library for geometric camera calibration. It supports automatic target detection, initialization, nonlinear optimization, and analysis for single- and multi-camera setups.

A typical Python calibration workflow is:

Detect and refine target features in images.
Define the calibration setup (cameras, targets, poses, detections).
Initialize parameters to get a robust starting point.
Optimize all parameters jointly.
Analyze calibration quality and stability.

1) Feature Detection¶

Use the detection and subpixel functions to extract accurate image features:

2) Define the Calibration Setup¶

Build a Calibration object and add cameras/targets/poses that describe your rig and observations:

3) Initialize¶

Initialize before optimization to obtain a strong starting point and avoid poor local minima.

Main entry point: Calibration.initialize
Settings: InitializationSettings
Results: InitializationResult

4) Optimize¶

Run bundle adjustment to refine intrinsic and extrinsic parameters.

Main entry point: Calibration.optimize
Settings: OptimizationSettings
Results: OptimizationResult

5) Analyze¶

Inspect calibration quality using comparison and error-analysis tools.

Licensing¶

Validate your license at application startup:

validate_license_with_certificate