Main Window
This page is up-to-date as of Parallax version 0.28.1
When Parallax first starts up, you should see the Main Window, shown below.
The main window consists of two View Ports (large black squares upon startup), four Stage Control Panels, the Calibration Panel, and the Transform panel, and the Message Log (white text box at the bottom). This allows you to control up to 4 probes and 2 cameras simultaneously.
Right-clicking on a View Port will bring up a context menu. To start streaming a camera feed:
Right click > Parallax > Cameras > (camera name)
If you don't have any cameras plugged in, you will only see one option: MockCamera0, which streams white noise at the standard Parallax image resolution (4000,3000).
This allows you to get familiar with using the View Port: left-click to select an image point, mouse wheel controls zoom, click-and-drag to pan, middle-click to home the view.
The View Port widget shows up in many features of Parallax, so it has its own documentation page with more details here.
The Control Panel allows you to control a probe translation stage. To select a stage, click the drop-down menu and choose the serial number of the stage you want to control. Once a stage is selected, the Control Panel will begin to show the coordinates of the X, Y, and Z axes of the stage in microns:
To move the stage to a prescribed position, click the second button with the "cross hairs" icon to launch the Target Dialog, shown below
The Target Dialog allows you to enter the X, Y, and Z coordinates of your target location. Clicking "Move" will move the probe stage through a safe move to that location. Clicking "Randomize" will populate the coordinate values with random values (this is useful if, for example, you want to test out your triangulations, or introduce noise into your manual targeting prodecure to reduce bias).
The button at the bottom with the red "stop sign" icon is the Halt button. Clicking it will immediately halt this stage (and only this stage, see Halting for more details). Another Halt button with identical functionality is included on the Control Panel itself (rightmost button).
The "crosshairs" icon at the top of the dialog is a drag-and-drop widget (drop only) for coordinate values. See Drag-and-drop Coordinates for more details.
The "Retract" button at the bottom-right of the Control Panel will retract the probe to position (Z=0), keeping the X and Z axes the same.
In the center of the Main Window, you will find the Calibration Panel:
This section allows you to load, save, inspect, edit, generate, or use (triangulate) calibrations. To load a calibration into the application, click Load and select the calibration file (extension .pkl). This will populate the dropdown menu with the loaded calibration; you can have several calibrations loaded simultaneously, but only one will be active at any time.
Click the "gear" icon to open the Calibration Settings dialog:
Here, you can inspect (and for some fields, edit) the parameters of the active calibration. Parameters are organized into four tabs: General, Statistics (for the statistics of the reconstruction error), Intrinsics, and Extrinsics.
Clicking the Triangulate button will Triangulate the image points selected in the View Ports; the results will be reported (in microns) in the message log:
If you haven't selected an image point in both frames, you will get a warning message instead.
The most recently computed triangulation result will be available as [drag-and-drop coordinates] from the empty space in the Calibration Panel widget.
Clicking the Start button at the bottom-right will initiate the probe calibration procedure.
Just below the Calibration Panel, you'll find the Transform Panel:
Similar to the Calibration Panel, the Transform Panel allows you to load and save transforms from/into the application. To generate a new transform, click the "Generate" button. This will launch the Rigid Body Transform Tool - see that page for details on how to generate a transform.