The MOTOR CONTROLS window pertains to (optional) control of a stage/motor controller system supported by ScanImage.
The Motor Controls panel only appears if a motorControllerType is specified in the Machine Data File. Other motorXXX settings in the Machine Data File pertain to this controller, if specified - e.g. the COM port controller is connected to if it is serial-port controlled.
If a Secondary Z motor controller is activated in the Machine Data File (by specifying the motor2ControllerType), and the primary motor controller is configured with motorDimensions='XYZ' (the default value), then MOTOR CONTROLS controls 4 dimensions in total (termed the XYZ-Z configuration), as shown at right above. In all other configurations (XY, Z, XYZ, XY-Z), 3 dimensions are shown, as at left above (inactive dimensions, if any, are shown with value 0).
Current Motor Position
These controls play two roles:
|Forces ScanImage to read the current motor position in all three axes and to update the displayed X/Y/Z values, e.g. following manual adjustment of the motor position using the motor controller outside of ScanImage control.|
|Read-only control that displays the squared-sum of the 3-4 displayed X/Y/Z values|
Pressing these buttons forces ScanImage Relative positions to be used in the specified axes (if not used already) and resets the relative origin in the specified axes to the current position (which is first read from the motor controller).
|Increment or decrement stage position in X, Y, or Z dimension by the specified step, in microns. In 4-dimension XYZ-Z case, the Sec Z value determines which motor controller is used when incrementing/decrementing the Z position.|
Image Stack Acquisition
These controls configure Image Stack acquisitions, of which ScanImage supports two types:
- Standard ('Slow Z') stepping stacks
- Volume Imaging ('Fast Z') stacks (when Enable is selected in the Fast Z Controls)
When value of #Slices is greater than 1, an image stack acquisition is implied for each GRAB or LOOP Repeat. For standard stacks, each Slice is an individually triggered acquisition taken at a distinct axial (Z) position, consisting of one or more Frames, as specified by #Frames on the Main Controls window. See Volume Imaging for more information about FastZ stacks.
Core Image Stack Controls
If enabled, motor controller returns to Home position – the initial axial position when a GRAB or LOOP was initiated – following the GRAB acquisition or each LOOP Repeat. This ensures subsequent acquisitions or Repeats traverse the same axial positions.
If enabled, axial position at start of Image Stack acquisition is taken as the center of the stack. Motor is moved backwards by half the total span implied by #Slices and Step/Slice prior to the start of the stack acquisition.
Image Stack Endpoint & Power Controls
Often, users may wish to select the starting and ending axial positions, as well as the imaging power, interactively, i.e. during FOCUS when the axial position and power can each be adjusted during live imaging.
|Sets the starting axial position of stack interactively. Motor controller will be moved to specified axial position at start of subsequent (standard) Image Stack acquisitions.|
|Sets the current axial position as Posn start.|
|Sets the ending axial position of stack interactively. When both Posn start and Posn end are set, the values of #Slices and Step/Slice are constrained so that Image Stacks traverse the specified axial extent.|
|Sets the current axial position as Posn end.|
|Clears Posn start, Posn end, Power start, and Power end (if configured.)|
|Clears Posn end and Power end (if configured) only.|
If P/z Adjust is enabled for a particular Beam on the Power Controls window, the following controls pertain:
|Power to use at starting axial position of stack can be set interactively. If Use start pwr is enabled, then power is adjusted to this level (for selected/displayed Beam) at start of subsequent (standard) Image Stack acquisitions.|
|Power to use at ending axial position of stack can be set interactively. When both Posn start and Posn end are set, user can choose to automatically or manually Override Lz, i.e. override the length constant Lz set on the Power Controls for the selected Beam, with the exponential length-constant value implied by (computed from) the start/end positions and powers.|
When Posn start/end and Power start/end values are all set, the Lz (length constant) value in Power Controls can be overridden with value computed from the specified position/power endpoints.