User Tools

Site Tools


crisp_mm_plugin

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
crisp_mm_plugin [2018/11/21 00:48]
melissa updating to v2.02 first draft
crisp_mm_plugin [2019/04/18 23:34] (current)
Line 1: Line 1:
 +====== Micro-Manager’s CRISP Control Plugin ======
  
 +===== Accessing the Plugin =====
 +
 +The Plugin comes default in current versions Micro-Manager;​ if you don't have it in **Plugins** > **Beta**, update Micro-Manager to the [[https://​micro-manager.org/​wiki/​Micro-Manager_Nightly_Builds|latest nightly build]]. ​
 +
 +
 +[{{ ::​micromanager_crisp.gif?​direct |Fig. 1\\ **Access the Plugin window**\\ Micro-Manager Window > **Plugins** > **Beta** }}]
 +
 +===== Plugin Controls Explained =====
 +
 +[{{ ::​mm_crisp2.02marked.png?​400 |Fig. 2\\ **CRISP Plugin'​s control window**\\ The red rectangle indicates which axis the Plugin is controlling.}}]
 +=== Buttons ===
 +  * **1) IDLE**: turns off the IR LED and stops position adjustments
 +  * **2) LOG CAL**: puts the CRISP in Log Amp Calibration state and measures SNR
 +  * **3) DITHER**: causes CRISP to dither in order to measure the Error #
 +  * **4) SET GAIN**: puts the CRISP in Set Gain state
 +  * **Reset Offsets**: resets the focus offset to zero for the present position
 +  * **Lock**: sets the focal position
 +  * **Unlock**: unlocks the focal position
 +  * **Save**: saves the settings (for all of the spin boxes) onto the controller
 +=== Spin Boxes ===
 +  * **LED Intensity**:​ controls CRISP’s infrared (IR) LED from 0-100%
 +  * **Gain**: controls the gain multiplier or loop gain; decrease the value if CRISP seems to oscillate or jitter
 +  * **Avg**: the number of samples to be averaged
 +  * **Obj NA**: the objective’s numerical aperture
 +=== Check Box ===
 +  * **Polling**:​ directs the Plugin to poll or query the controller at frequent intervals for CRISP state, error number, and SNR; uncheck when done with the 4-step calibration
 +=== Reported Values ===
 +  * **CRISP State**: such as Idle, Calibrating,​ Ready, In Focus, etc.
 +  * **Error #**: during DITHER higher error values are better; after SET GAIN the Error # will be close to zero
 +  * **SNR**: (in decibels) should be at least 2 dB else CRISP performance may be unstable and lock will be lost easily; increasing LED intensity and performing the 4-step calibration again to increase the SNR
 +  * **AGC**: minimum of ~20 is acceptable for average samples; may be much higher for very reflective samples
 +  * **Sum**: indicates the amount of light hitting the photodiode; if outside 50-80, redo the 4-step calibration
 +  * **Offset**: the difference between the locked-in focal position and the current position
 +
 +===== Quick Setup Guide =====
 +  * Start the 4-step calibration((Note that the 4-step calibration should always go through all 4 steps before re-starting;​ Log Amp Calibration has a countdown in the CRISP State display but otherwise you can quickly click through them to get back to the beginning.)) by clicking the **1) Idle** button. ​
 +  * Enter the objective’s NA (which affects the dither).
 +  * Click the **2) LOG CAL** button.
 +  * Check the SNR display. If <2 dB, click through the rest of the 4-step calibration,​ increase the LED Intensity, and begin the calibration again. If SNR is still low after the LED is at maximum intensity, proceed to the next step anyway.
 +  * Click the **3) DITHER Button**.
 +  * Check the Error #. It must be at least +/- 100; if it isn’t, move the Lateral Adjustment Screw. The farther from zero the error number, the stronger the lock.
 +  * Press the **4) Set Gain** button.
 +  * Press the **Lock** button to preserve the focal position. (Press the **Unlock** button to release CRISP'​s focus lock.)
 +  * If CRISP loses lock, repeat the calibration steps and try to get a higher error number after dithering.
 +
 +[{{ ::​crisplateraladjknob.png?​300 |Fig. 3\\ **Lateral Adjustment Knob**\\ Used to increase error number during dither}}]
 + 
 +===== Additional Tips =====
 +
 +If you would like CRISP to maintain focus at a certain position, but the error isn’t 0, use the **Reset Offsets** button to make your desired focal position have “0” error.
 +
 +Further Reading
 +Refer to [[crisp_manual|CRISP : Continuous Autofocus System]] for a description of CRISP operation and troubleshooting guides.
 +
 +{{tag>​crisp tech_note MicroManager Micro-Manager}}
crisp_mm_plugin.txt · Last modified: 2019/04/18 23:34 (external edit)