Leginon

h1. Troubles with Focusing and Drift Check

* <link linkend="driftforever">Focuser and drift manager toggle back and forth

forever</link>

* <link linkend="focfail">Autofocus failure-high mags</link>

* <link linkend="focfailz">Autofocus to eucentric (Z Focus node) failure</link>

* <link linkend="focdark">Autofocus image of holes become dark at one or more beam

tilts</link>

* <link linkend="focfail">The specimen appears over-dosed in the high magnification images

(while using a Gatan CCD)</link>

h2. Focuser and drift manager toggle back and forth

forever

Commonly Why: Threshold set in focuser/autofocus is significantly smaller than that in

drift manager in absolute scale. This is a bug in Leginon to some extend caused by a small

movement of the image when the a new state of the beam is set so that the focuser records

bigger drift than the drift manager.

Solution: Increase Focuser/Autofocus Drift Threshold and/or increase the wait time

between checking drift in Drift Manager.

Still not working: Despike might not work in the corrector

Solution: Consider increasing Despike neighbor size (odd number only) or decreasing

despike threshold.

Still not working: You are on a day with a lot of cosmic events that cause the cross

correlation fails.

Solution: Finding a way to reduce exposure time might help as it reduces the possibility

of cosmic ray hitting the CCD.

h2. Failed autofocus in Focus node

Commonly Why:

* The actual defocus is outside of measurable range.

* No image contrast for correlation due to thick ice, no ice and support film, or at

Gaussian focus

* Stage drift, charging, or ice melts during the focus measurement. All three cause

change in images not accountable by beam tilt induced image shift.

* Artifacts in the images such as spikes not corrected by the corrector node that

fool the correlation procedure to consider the image is never moved or moved a

lot.

* Bad rotaion center and beam tilt pivot point alignment

* <link linkend="focdark">Objective aperture is off alignment</link>.

* Bad calibration

Solutions:

* Out of range:

* Make sure that the lower mag autofocus, i.e., Z focus node, is preformed

successfully by observing its progress, and, if necessary, adjust the stage height

in its Manual focus tool.

* Make sure that Z Focus node autofocus accuracy is compatible with the Focus

node. For example, Z Focus at 5000x has an accuracy of +/- 5 um and Focus at

50,000x can handle range up to about +/- 10 um.

* Choose a flater grid square.

* For thick ice

* Leginon/Focus/Settings/Autofocus> Increase the ice melt time in autofocus

setting

* Leginon/Exposure Targeting/Hole Targeting Setting/Target Template/Focus

Template Thickness> Adjust allowed ice thickness values to pick focus target in

area with thinner ice

* Leginon/Presets Manager> reduce "fa" preset CCD binning and/or increase

exposure time.

* Bad rotaion center and beam tilt pivot point alignment

* Bad calibration

* For stage drift during the procedure

* Leginon/Focus/Settings/Autofocus> Reduce drift check threshold.

* For charging during the procedure

* Leginon/Exposure Targeting> Pick targets away from ice chunk, grid bar, and

large ice gradient.

* For ice melting during the procedure

* Leginon/Focus/Settings/Autofocus> Increase ice melt time

* For image spikes

* Leginon/Correction> Adjust despike parameters

* Leginon/Correction> Reduce exposure time? Might reduce number of random

event

h2. Failed autofocus in Z Focus node

Commonly Why:

* The stage height relative to Eucentric point is outside of measurable range due to

very uneven grid or stage far away from U-center.

* Empty area or area with very thick ice, or at Gaussian focus

* Objective aperture is off alignment.

* Bad recorded eucentric focus.

* Bad rotaion center and beam tilt pivot point alignment

* Bad calibration

To identify which is the source, observe the image, correlation, and peak

during beam tilt autofocusing. Also check in the log the residual value (so called min) of

the fitting.

* Image has very good contrast but features are completely different from one tilt

image to the next-Out of range.

* No image contrast or correlation peaks move randomly-empty or thick ice, or at

Gaussian focus

* Contrast reverse in the holes relative to the support matrix in one or more beam

tilt images-Objective aperture is off alignment.

* If you know that the stage is at U-center, but the images appear to be strongly

defocused-Recorded eucentric focus is incorrect.

* Correlation peaks are well defined but fitting fails-Bad rotaion center and beam

tilt pivot point alignment, or bad calibration.

Solutions:

* Out of range:

* U-center the stage before the run and when Z focus fails.

* Activate Manual Check after autofocus to make adjustment in stage Z

height.

* For expert user: Add another focus step before the current autofocus step at

even lower magnification for a larger range usability. For example, use sq preset.

You will need to perform a calibration with Beam Tilt node in the Calibration

application.

* Empty area or thick ice:

* Pick better focus target.

* Leginon/Z Focus/Hole Targeting Settings/Ice Thickness Threshold/Focus Hole

Selection> Consider using "Good hole" rather than "Any hole".

* At Guassian focus:

* There is no problem, don't worry.

* Bad recorded eucentric focus

*  Leginon> send to scope the preset used to autofocus in Z Focus node (i.e.,

hl in MSI).

*  TEM> Adjust the stage to U-center.

*  TEM> Focus the image and reset defocus.

*  Leginon/Z Focus> start Manual focus tool.

*  Leginon/Z Focus/Manual Focus> send 0 defocus to scope.

*  Leginon/Z Focus/Manual Focus> save "Eucentric focus from

Instrument".

* Bad rotation center and beam tilt pivot point alignment:

* Make sure you are at the eucentric focus during the alignment.

* Bad alignment on objective aperture:

* <link linkend="focdark">Center the objective aperture in diffraction

mode</link>.

h2. Objects reverse contrast during autofocus

In this case of autofocus failure, objects such as holes change from lighter than matrix

to darker as if a dark-field image is collected during the autofocus beam tilts.

Commonly Why:

* The objective aperture is off.

* Bad rotation center and beam tilt pivot point alignment.

Solutions:

* Align objective aperture at mags where autofocus is performed in HM mode. Here is

how:

*  TEM>Make sure the rotation center is correct.

*  TEM>Change the mag to that of the autofocus preset that shows the

problem.

or

Leginon/Presets Manager>Send the autofocus preset.

*  Imaging an area that have scattering matter such as with ice or

carbon.

*  TEM>Press the diffraction button to go into diffraction mode.

*  TEM>Use the Mag adjustment knob to change diffraction distance to ~1

m.

*  TEM>You should see a bright and condensed image of your imaging area which

would condenses to a point if you are right at focus (adjust with focus knob). The

faint disk outside of the bright area defines the opening of the objective

aperture. Center the image using the MULTIFUNCTION KNOBS if you can not see the

edge. Move the STAGE to area with more scattering matter if the faint disk is not

visible.

*  TEM>Physically move the aperture so the faint disk is centered on the

bright image.