Skip to main content
Version: 8.0

Image Reprojection

Created by: Cameras

Overview

Reprojection error is the error in the position of a feature in an image, as compared to the position of its corresponding feature in object space. More simply put, it tells you how well the camera model generalizes in the real world.

Reprojection is often seen as the only error metric to measure precision within an adjustment. Reprojection errors can tell us a lot about the calibration process and provide insight into what image effects were (or were not) properly calibrated for.

Definition

Image reprojection metrics contain the following fields:

Field
TypeDescription
metadataA common image metadata objectThe metadata associated with the image that this reprojection data was constructed from.
object_space_idUUIDThe UUID of the object space that was observed by the image this reprojection data corresponds to.
idsAn array of integersThe identifiers of the object space features detected in this image.
usAn array of floatsThe u-coordinates for each object space feature detected in this image.
vsAn array of floatsThe v-coordinates for each object space feature detected in this image.
rsAn array of floatsThe radial polar coordinates for each object space feature detected in this image.
tsAn array of floatsThe tangential polar coordinates for each object space feature detected in this image.
dusAn array of floatsThe error in u-coordinates for each object space feature detected in this image.
dvsAn array of floatsThe error in v-coordinates for each object space feature detected in this image.
drsAn array of floatsThe error in radial polar coordinates for each object space feature detected in this image.
dtsAn array of floatsThe error in tangential polar coordinates for each object space feature detected in this image.
world_extrinsicAn extrinsics objectThe pose of the camera (camera from object space) for this image.
object_xsAn array of floatsThe object space (3D) X-coordinates for each object space feature detected in this image.
object_ysAn array of floatsThe object space (3D) Y-coordinates for each object space feature detected in this image.
object_zsAn array of floatsThe object space (3D) Z-coordinates for each object space feature detected in this image.
rmseFloatRoot mean square error of the image residuals, in pixels.

Camera Coordinate Frames

MetriCal uses two different conventions for image space points. Both can and should be used when analyzing camera calibration statistics.

CV (Computer Vision) Coordinate Frame

xy image space

This is the standard coordinate system used in computer vision. The origin of the coordinate system is (x0,y0)(x_0, y_0), and is located in the upper left corner of the image.

When working in this coordinate frame, we use lower-case xx and yy to denote that these coordinates are in the image, whereas upper-case XX, YY, and ZZ are used to denote coordinates of a point in object space.

This coordinate frame is useful when examining feature space, or building histograms across an image.

UV Coordinate Frame

uv image space

This coordinate frame maintains axes conventions, but instead places the origin at the principal point of the image, labeled as (u0,v0)(u_0, v_0). Notice that the coordinate dimensions are referred to as lower-case uu and vv, to denote that axes are in image space and relative to the principal point.

Most charts that deal with reprojection error convey more information when plotted in UV coordinates than CV coordinates. For instance, radial distortion increases proportional to radial distance from the principal point — not the top-left corner of the image.

Cartesian vs. Polar

In addition to understanding the different origins of the two coordinate frames, polar coordinates are sometimes used in order to be able to visualize reprojections as a function of radial or tangential differences.

When using polar coordinates, points are likewise centered about the principal point. Thus, we go from our previous (u,v)(u, v) frame to (r,t)(r, t).

CartesianPolar
cartesian pointpolar point

Analysis

Below are some useful reprojection metrics and trends that can be derived from the numbers found in results.json.

Feature Coverage Analysis

Data Based In: Either CV or UV Coordinate Frame

All image space observations made from a single camera component over the entire calibration process are plotted. This gives us a sense of data coverage over the domain of the image. For a camera calibration process, this chart should ideally have an isometric distribution of points within the image without any large empty spaces. This even spread prevents a camera model from overfitting on any one area.

feature coverage analysis

In the above example, there are some empty spaces near the periphery of the image. This can happen due to image vignetting (during the capture process), or just merely because one did not move the target to have coverage in that part of the scene during data capture.

Radial Error - δr vs. r

Data Based In: UV Coordinate Frame

The δr\delta r vs. rr graph is a graph that plots radial reprojection error as a function of radial distance from the principal point. This graph is an excellent way to characterize distortion error, particularly radial distortions.

ExpectedPoor Result
good radial distortion modelingbad radial distortion modeling

Consider the graph above: This distribution represents a fully calibrated system that has modeled distortion using the Brown-Conrady model. The error is fairly evenly distributed and low, even as one moves away from the principal point of the image.

However, were MetriCal configured to not to calibrate for a distortion model (e.g. a plex was generated with metrical init such that it used the no_distortion model), the output would look very different (see the right figure above). Radial error fluctuates in a sinusoidal pattern now, getting worse as we move away from the principal point. Clearly, this camera needs a distortion model of some kind in future calibrations.

Tangential Error - δt vs. t

Data Based In: UV Coordinate Frame

Like the δr\delta r vs. rr graph, δt\delta t vs. tt plots the tangential reprojection error as a function of the tangential (angular) component of the data about the principal point.

This can be a useful plot to determine if any unmodeled tangential (de-centering) distortion exists. The chart below shows an adjustment with tangential distortion correctly calibrated and accounted for. The "Poor Result" shows the same adjustment without tangential distortion modeling applied.

ExpectedPoor Result
good tangential distortion modelingbad tangential distortion modeling

Error in u and v

Data Based In: UV Coordinate Frame

These plot the error in our Cartesian axes (δu\delta u or δv\delta v) as a function of the distance along that axis (uu or vv).

Both of these graphs should have their y-axes centered around zero, and should mostly look uniform in nature. The errors at the extreme edges may be larger or more sparse; however, the errors should not have any noticeable trend.

Expected δu vs. uExpected δv vs. v
good du vs u modelinggood dv vs v modeling

Unmodeled Intrinsics Indicators

There are certain trends and patterns to look out for in the plots above. Many of these can reveal unmodeled intrinsics within a system, like a distortion that wasn't taken into account in this calibration process. A few of these patterns are outlined below.

Unmodeled Tangential Distortion

It was obvious that something was amiss when looking at the Poor Result plot for the δt\delta t vs. tt graph, above. However, depending on the magnitude of error, we may suspect that any effects we see in such a graph are noise. If we then look at the δu\delta u vs. uu and δv\delta v vs. vv graphs, we might see the following trends as well:

Unmodeled Tangential - δu vs. uUnmodeled Tangential - δv vs. v
bad du vs u with tangential distortionbad dv vs v with tangential distortion

Comparative Analysis

Beyond the above analyses, the charts provided are incredibly useful when comparing calibrations for the same component over time. Comparing these charts temporally is useful when designing a calibration process, and likewise can be useful in deciding between different models (e.g. Brown-Conrady vs. Kannala-Brandt distortion, etc.).

Comparing these charts across components can be helpful if the components are similar (e.g. similar cameras from the same manufacturer). There are some caveats; for example, one cannot compare these charts across two cameras if they have different pixel pitches. Pixel errors from a camera that has 10µm pixels cannot be directly compared to pixel errors from a camera that has 5µm pixels, as the former is 2 times larger than the latter. One might understandably see that the former component has reprojection errors 2 times smaller than the latter, but this would be a false distinction — that difference is due to the difference in size between the pixels of both cameras and not due to some quality of the calibration.

Pose Data

The world_extrinsic from the image reprojection data represents the pose (camera from object space) of the camera when a given image was taken. Knowing which image is which by uniquely identifying it by its component UUID and timestamp (present in the metadata), these poses can be plotted or used to determine the position of the camera when a given image was taken.

This is one way to perform a hand-eye calibration with MetriCal, by extracting the world pose of each image given a timestamp or sequence number.

Object XYZs

In addition to image reprojections, the final "unprojected" 3D coordinates of the object space features are also included in image reprojection metrics. This can be used in conjunction with other modality information to determine how an individual image contributed to errors in the final optimized object space.

While MetriCal does not have any means to single out and filter an individual image, this can help during the development of a calibration process to ascertain if certain poses or geometries negatively contribute towards the calibration.