Skip to content

Tutorial: Calibration by Probe

Jump to bottom
Chris Chronopoulos edited this page Aug 12, 2023 · 3 revisions

This page is up-to-date as of Parallax version 0.28.2

This procedure generates a stereo camera calibration by moving a probe through a set of known points, and prompting the user to identify the probe tip in each camera view.

Instructions

  1. In the main window, right-click on each view port and select the camera for that view (Right Click -> Parallax -> Camera)

  2. Ensure that the probe is within each camera's field of view, and in good focus. If you need to move the probe to achieve this, you can do so via the Stage Control Panel.

  1. In the Calibration Panel, click "Start". This will open the "Calibration Routine Parameters" dialog.

  1. Fill out the dialog with your chosen settings:

    a. Stage: the stage (identified by serial number) that the routine will control

    b. Resolution: the stage will be moved through a cubical lattice, with n points along a side - "resolution" here refers to n. Being a cubical lattice, the number of calibration points is n3. The default value of 3 will yield 27 calibration points.

    c. Extent: the side length, in microns, of the cubical lattice

    d. Origin: the center of the cubical lattice (in probe coordinates). You can set this to the current stage position by clicking "set current position as origin"

    e. Coordinate System: this is a string that will name the coordinate system of the resulting calibration. By default it is populated with the serial number of the stage.

    f. Provide Intrinsics: by default, the procedure will do a calibration without guessing at the initial intrinsics. If you have a set of intrinsic parameters - for example from the Checkerboard Tool (mono) - then you can load them here.

  2. Click "Start Calibration Routine"

  3. The routine will move the probe to the first calibration point, then print a message in the Message Log. Select the probe tip in both camera views (left click), then press "C" to continue.

  1. Repeat this for every point in the calibration routine. If you need to cancel mid-way, you'll notice the "Start" button has become a "Stop".

  2. When the routine completes, the calibration will be loaded in the model and available in the dropdown menu of the Calibration Panel.

  1. (Optional, Recommended) With your calibration selected in the dropdown, click "Save" to save this calibration to disk. Later, you can load it back into the model by clicking "Load".
Clone this wiki locally