Calibrate line-scan camera🔗

Calculates intrinsic calibration parameters for a line-scan camera. The tool requires several images of the standard VisionAppster line-scan calibration plate. It calculates the intrinsic parameters (principal point, focal length and radial distortion) of the camera the pictures were taken with.

Once the calibration factors have been calculated, they can be copied to the image source connected to the camera.


  • sync: An optional synchronization input. This input makes it possible to feed multiple independent images to the calibration procedure. If sync is connected, the tool will collect input images related to the object received in it. This makes it possible to use an iteration to collect multiple calibration images.

  • image: A picture of the standard VisionAppster line-scan calibration plate taken with the camera being calibrated. The picture may be composed of several images of equal width and height which have been stacked as a single image outside of the tool. In such a case, sampleCount should be set equal to the number of stacked sub-images.

  • markerHeight: Height of the markers on the calibration plate in world units.

  • markerSpacing: Distance between the markers on the calibration plate in world units.

  • markerCount: Number of markers on the calibration plate on each side of the center. So there are 2 * markerCount markers in total.

  • threshold: Threshold used in detecting the markers. The bigger the threshold, a larger contrast is required for reliable detection. The smaller the threshold, the larger is the probability for false detection. A number between 50 and 100 is typically a good compromise.

  • sampleCount: The number of sample profiles extracted from each input image. This can be used to sample each single input image multiple times, but is mostly useful if the input image is composed of equally sized sub-images stacked on top of each other.

  • sampleWidth: The number of scan lines summed up and averaged in each sampleCount image.

  • focalLength: Focal length in world units, typically in millimeters.

  • pixelSize: The horizontal width of a pixel on the image sensor, in world units. Typical pixel sizes of line-scan sensors range from 0.005 to 0.02 millimeters.


  • focalLength: The focal length of the camera in pixels (fx, fy). Only fx will actually be estimated, and fy will be set equal to it.

  • principalPoint: The location of the principal point in pixel coordinates (cx, cy). The principal point is the point where the optical axis hits the image sensor. Note that with a line-scan camera, this should actually be stated “where the optical axis would hit the image sensor, if it was wide enough”. Imperfect lens centering will usually cause the center to be slightly off the sensor.

  • distortionFactors: The radial and tangential distortion factors (k1, k2, p1, p2). Tangential factors aren’t actually estimated and will be zeros.

  • detectedMarkerCount: A N-by-2 matrix containing the number of detected markers on left and right sides of the calibration plate. For each input image, sampleCount rows will be inserted to this matrix. The total number of lines thus varies depending on the number of images received. Ideally, both values on every line should be equal to markerCount if the images are such that all markers are visible.

  • errorMeasure: A measure of how successful the calibration procedure was. The smaller the value, the better. A value between 0 and 1 is good, between 1 and 2 is fair and larger than 2 is poor. If the calibration fails completely, the value is infinite. In that case it is likely that the calibration plate was not detected at all in at least one image.