imagingbook/imagingbook-calibrate

Java/ImageJ implementation of Zhang's camera calibration method

Java/ImageJ Implementation of Zhang's Camera Calibration Algorithm

This is a Java implementation of Zhang's camera calibration algorithm. It implements the geometric part only, i.e., does not include interest point detection and point correspondence calculations. For details see this extensive report.

Project Structure

This software is part of the imagingbook project. It is built with Maven and depends on ImageJ, the imagingbook library and Apache Commons Math.

This project consists of two sub-projects (Maven modules):

• imagingbook-calibrate-lib: the calibration library plus a small set of calibration test data,
• imagingbook-calibrate-plugins: various ImageJ demo plugins (embedded in a complete ImageJ setup).

Stand-Alone Installation

• Download the latest release of this repository.
• Enter imagingbook-calibrate-plugins.
• Start ImageJ by double-clicking ImageJ.exe (Win) or launching ij.jar (Mac). This requires an installed Java runtime version 1.8 or higher.
• In ImageJ, use the Plugins menu to run the demo plugins (test images are loaded automatically).

Use in an Existing ImageJ Environment

• Copy all JAR files from imagingbook-calibrate-plugins/ImageJ/jars.
• Copy the plugin .class files from imagingbook-calibrate-plugins/ImageJ/plugins.

Documentation

• JavaDoc: imagingbook-calibrate
• Report: Zhang's Camera Calibration Algorithm: In-Depth Tutorial and Implementation

imagingbook-calibrate's Issues

License

Hi,

Can you add a license file for the code in this project ?

Thanks,

Revise maven pom file

Make project independent of any parent pom.

Typo in PDF describing the ToRodriguesVector algorithm

Thank you for writing this detailed and truly excellent exposition of Zhang's camera calibration procedure.

I noticed a typo in the PDF document describing Algorithm 4.10 (ToRodriguesVector(R)). In particular, line 2 in the definition of the vector p. The first component of the vector is given as: R_{2,1} - R_{2,1} whereas it should be R_{2,1} - R_{1,2}.

Add source code comments

JavaDoc comments are incomplete.