Troubleshooting

Camera Optimization - PIX4Dmapper

Issue

When the quality report shows camera optimization above 5%, this can indicate an issue with a project.

Description

The focal length/affine transformation parameters are a property of the camera's sensor and optics, and these actual values can vary with temperature, shocks, altitude, or time. The calibration process starts with an initial camera model and optimizes the parameters used to model the camera in Pix4D to produce more accurate results.

Indicators:

Review the initial checks section of the quality report as shown below.

  • green_checkmark.png An initial camera model should be within 5% of the optimized value to ensure a fast and robust optimization.
  • yellow_warning.jpgThe percentage of the difference between the initial and optimized focal length for a perspective lens, affine transformation parameters C and F for a fisheye lens, is between 5% and 20%.
  • red_warning.jpgThe percentage of the difference between the initial and optimized focal length for a perspective lens, affine transformation parameters C and F for a fisheye lens, is more than 20%.

Camera_optimization_table.jpg

Causes

Several causes can lead to this issue:

  1. Flat and homogenous areas do not provide enough visual information for optimal camera calibration.
  2. The images have significant rolling shutter distortion.
  3. Blurry images, a dataset with low overlap, damaged camera.
  4. Wrong initial internal camera parameters. The camera has been physically modified with a lens filter or similar accessory that affects the optic.
  5. Preprocessed or cropped images.

Solutions

Possible solutions to the previously listed causes are proposed below.

For cause 1:

For cause 2:

For cause 3:

  • Recapture Image Dataset.
  • Check the camera for any potential damage.

For cause 4:

  • Verify that the camera model defined is correct for the images used in the project.
  • If the camera is not in the Pix4D database, then it may be necessary to generate these values by following the instructions:

For cause 5:

  • Do not modify the images before importing them into PIX4Dmapper for processing.
Tip: It is recommended to add Ground Control Points (GCPs) and Manual Tie Points (MTPs) in order to improve the reconstruction and to evaluate the accuracy of the reconstruction.