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. Several transforms can be loaded simultaneously, but only one is active at time (selected from the drop-down menu at the top-left). 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.
Clicking the Apply button will launch a non-modal dialog to assist in mapping coordinates bidirectionally through the active transform:
The left side represents the "from" coordinate system, while the right side represents the "to" system of the transform (the coordinate systems are named at the top of the dialog). Filling in the left coordinate fields (X,Y,Z) and clicking "map forward" will apply the transform directly, and auto-populate the right coordinate fields. To apply the inverse transform, fill in the right coordinate fields and click "map inverse" to auto-populate the left fields. Both coordinate widgets are endowed with drag-and-drop coordinate functionality, so results can be easily transferred to/from other widgets in Parallax.