Camera‐to‐Probe Transform Tool
This page is up-to-date as of Parallax version 0.33.0
The Camera-to-Probe Transform Tool streamlines the process of registering correspondence points between the camera coordinate system (given by the calibration) and the probe's motor coordinates. It is accessed via the Tools menu:
Main Window > Tools > Transforms > Camera-to-Probe Transform Tool
This window is divided into three panels:
Here, we can set the parameters of the automated trajectory that the probe will be moved through. The trajectory will progress along a cubical lattice. The parameters of automation are:
- Stage: Which stage to drive through the automation procedure.
- Resolution: The number of lattice points per dimension of the cube. 2 will lead to 8 correspondence points, 3 will lead to 27, etc.
- Extent: The side length, in microns, of the cubical lattice.
- Origin: The center of the cubical lattice in stage coordinates. You can click "Set current position as origin" to set this from currently selected stage position.
- Calibration: The calibration to be used when triangulating image points into object points for the correspondence. Make sure the calibration you're looking for has been loaded into the application from the Calibration Panel, otherwise it won't appear in the dropdown here.
When ready (make sure the probe is clear of obstacles!) click "Start Automation". The probe will move to the first correspondence point, and a message will appear in the message log, e.g:
Registration point 1 (of 8) reached: [5500.500000, 5499.500000, 1000.000000]
Here, we collect the correspondence points to be used in the transform. To add a correspondence point, simply click-to-select the probe tip in both view ports in the Main Window, and then click "Register Points and Continue" in the Correspondence Panel:
If you check the box labeled "Trigger from keyboard (C)", the routine will automatically register points and continue when the hot key "C" is pressed (requires keyboard focus on the Main Window).
Once we've collected enough correspondence points (at least 8 are recommended), we can enter some metadata and generate the transform:
- Name: The name to associate with the transform. Auto-populated with timestamp.
- "From" Coordinates: The name of the coordinate system that we are transforming from. Auto-populated as "camera".
- "To" Coordinates: The name of the coordinate system that we are transforming to. Auto-populated as "probe".
When ready, click the "Generate" button to generate the transform. The transform will be added to the the dropdown menu in the Transform Panel of the Main Window, and from there you can save the transform to disk.