Leginon

h1. Running the application

h2. Import Notes about Image Intensity Recorded through

Tomography Node

Tomography node saves the images in a different format from other Acquisition nodes. By

default, the flat-field correct CCD counts are multiplied by 10 and converted to signed

16-bit integer before the image is displayed and saved. This makes CCD counts of 3276.8 or

larger overflow to negatives. Other Leginon Acquisition images are saved as float without

manipulation.

To avoid this problem, find out what exposure time corresponds to the fractionated dose

from your tilt angle step and range and total dose and take an image at tomo preset with

such an exposure in Navigation node. You will need to reduce the total dose if a good

fraction of the counts are larger than 3200 even though it would not appear to be saturated

in the float scale without the 10x factor. Alternatively, change the scale factor in

Tomography node.

h2. Multiscale Imaging

*  Preset image shift alignment/beam shift alignment are the same as in MSI

application

*  New dark/bright references should be reacquired for "tomo" preset that acquires the

final data. It is best to do this at the same dose per tomography image calculated from

the total dose, the tilt parameters, and the dose measurement.

*  For best focusing result, perform autofocus at the same magnification as the

tomography data collection, align microscope well at the eucentric focus and the

rotation center and save them before data collection.

h2. Using Tomography Preview

*  Preview targets (pink) can be selected when selecting targets in "Tomography

Targeting"

*  When the targets are processed, targets that are of the type "preview" are

processed before focus and acquisition targets.

*  Tomography Preview node acquires a image at the preview target using "preview"

preset which should be set at minimal dose.

h2. Dose Measurement

If "Measure Dose before collection" is checked in Tomography node, the stage will be

moved to the reference target and a dose image of the "tomo" preset will be acquired (center

512x512 of whateven binning of the preset) before each tilt series if the interval between

the series is longer than the limit time set in the settings of Dose Measurement node. The

measured value will then be used to recalculate the proper exposure time for tomography

imaging.

For this function to behave properly, the followings should be done during

operation:

* One, and only one, "reference" target should be selected in either "Square

Targeting" or "Hole Targeting" or "Tomography Targeting" node. The reference target

should be of either a broken square or a empty hole if no broken square can be

found.

* "Measure Dose" before collection should be selected in Tomography node.

* "Exposure time max/min" in Tomography node should be in a range that can accommodate

the electron beam fluctuation over time.

h2. Align Zero Loss Peak

This function applies only to Gatan energy filter EFTEM. If "Align ZLP before

collection" is checked in Tomography node, the stage will be moved to the reference target

and starts the procedure to align zero loss peak before each tilt series if the interval

between the series is longer than the limit time set in the settings of Dose Measurement

node.

For this function to behave properly, the followings should be done during

operation:

* One, and only one, "reference" target should be selected in either "Square

Targeting" or "Hole Targeting" or "Tomography Targeting" node. The reference target

should be of either a broken square or a empty hole if no broken square can be found.

This is the same reference target used for dose measurement.

* "Align ZLP" before collection should be selected in Tomography node.

h2. Low Magnification Model Fitting

The fitting of optical axis offset does not always works if the offset is so large that

the feature moves out of view with even a small tilt. In such a case, it is worth first

collect a tomography series at a lower magnification to define roughly the model.

At beginning of each session, or forced by the user, the model is initialized. By

default, at the initialization, Tomography node uses past fitting results that show good

agreement with the experimental data at the magnification of the preset used. If a good

model is not found, that from lower magnifications will be used. It is possible to force the

node to use a model fitted at a particular magnification by selecting it in

Tomography/Settings/Model.

Therefore, we recommend that, in case of fitting failure on good contrast images, the

followings should be done:

#  Tomography/Settings/Image Acquisition> change the preset to "hl".

#  Tomography/Settings> adjust Tilt and Exposure parameters to match.

#  Acquire the tiltseries images.

#  If the tracking is good, change the preset back.

#  Tomography/Settings/Model> Initialize with the model of (the mag of "hl"

preset).

#  Acquire the tomo-series.

#  If tracking is good, change back to Initialize with the model of "this preset and

lower" mag.

h2. What is a Good Tilt-Axis Model?

The goniometer-tilt-axis-based tracking model developed by Zheng et. al. corrects the

specimen height (z-axis) by a change of defocus using measured shift of feature shifts in

the images (x and y-axes). The tracking in the x and y directions does not involve the use

of such model, but is done by smooth curve fitting or preceding tilts. Therefore, to judge

the adequacy of the model, one should check the resulting defocii of the images in the

series remain unchanged.

On the other hand, the feature tracking in x and y is likely to fail only if the tilting

does not induce a smooth shift of the imaging feature a sudden drop of specimen position at

a particular tilt angle often throws off the smooth curve fitting. It is possible to reduce

such effect by increasing the number of data points included in the smoothing as set in the

model section of the tomography node settings window. Otherwise, the goniometer need to be

serviced.

[[Tomography Trouble Shooting]] 

h2. Failure of xy feature tracking

Feature tracking in x and y axes is a 2nd order polynomial fit of preceeding data

points. The default uses 5 data points. When a sudden jump occurs in the tracking error, it

tend to follow the trend of the last point. If the jump is a temporary clich in the

goniometer, this tend to over correct the tracking error and eventually loose track as shown

in Figure 5. A possible fix is to increase the number of data points in the fitting. This

can be set in the tomography setting "Smooth n tilts for defocus prediction". 4 in defocus

prediction is equivalent to 5 points (n+1) for xy tracking.

*Figure 5* 

!http://emg.nysbc.org/software/leginon/images/images/tomoxbad.png!

h2. Large tracking error between the first and second tilt

images

The first image in each tilt group of the tilt series at the "start" angle (normally 0

deg) and the second image at tilt of "step" angle from the "start" angle do not use the

fitted model.  It is assumed that the eucentric height judged by stage alpha wobbling in the

"Tomo Focus" node gives a stage height that the tracking of feature by such a small tilt

would be good enough.  In most cases this is a reasonable assumption.  However, we have had

experience of goniometer alignment problem where the assumption fails.  The symptom is

illustrated in Figure 6 below.  Note that the Feature tracking error is displayed as

percentage of the image length.

*Figure 6*

!http://emg.nysbc.org/software/leginon/images/images/tomoz0bad.png!

This tilt series was taken with a starting angle of zero and at an image size of < 1

um.  As can be seen here, apart from the 2 and minus 2 degree tilts, the tracking error was less

than 2 % of the image.  Only the tracking of the feature between 0 and +/- 2 degrees are

large.  At close to 20 % error, this made the overlap between plus and minus 2 degrees unacceptable and

often cause popular alignment programs to misalign the two half of the series.

The first solution is of course to report it to your microscope service engineer.  When

we had this problem, many users noticed that it was difficult to adjust stage to eucentric

height manually with alpha wobbler.  Features jumped while the goniometer changed rotation

direction.  In addition, different magnitude of tilt range suggests different eucentric

heights.  It is not easy to fix this, so it might take a while.

Before the hardware is fixed physically, it is still possible collect tomograms.  The

model fitting of the overall curve in the above case gave z0 of +5 um through the whole tilt

series (Figure not shown).  Therefore, by moving the stage up by such an amount after the

stage-tilt-based autofocusing can bring us to the correct height for tomography.  This can

be acheived by saving the "tomo eucentric" focus current to the database, align rotation

center for this stage height and focus.  Then change the correction type of the

"Beam_Tilt_Fine" focusing step to "Stage Z".

h2. Failure of model-based correction

The model used in the defocus correction in Leginon tomography node is a very simplified

one. There are a few cases when the approach fails. Here are ones that we have

encountered:

h2. Y-axis looping

The microscope goniometer does not move on only the tilt axis. With its complex

structure, a common problem is that when the stage is highly tilt, the position slips in

the y-direction. This is known as looping. Figure 7 shows an example of this problem.

*Figure 7*

!http://emg.nysbc.org/software/leginon/images/images/tomoxyloop.png!

While the x-axis position shifts monotonically as a stable model should be, the y-axis

in the positive tilt direction changes little from 0-30 degrees before it increases

rapidly after 30 degrees. Even though the tracking in xy plane is still good, the defocii

correction at these higher tilts may no longer be correct if the tilt axis parameters are

fitted dynamically. Figure 8 shows the model parameters of the same tilt series where the

fitted phi and offset starts to change above 30 degrees even though the tilt axis has not

moved according to the shrinking behavior of the images during the tilts. Note that in

this particular case the looping problem is still mild so that the over-correction is not

very strong. only a small slope change is resulted in z0 prediction. In worst cases, the

defocus over-correction is so large that the adjacent images can not correlate properly

and even the xy tracking would fail. The spikes around zero tilt is a display data sorting

error of the identical starting tilt of the two tilt groups.

*Figure 8*

!http://emg.nysbc.org/software/leginon/images/images/tomomodelloop.png!

Other than asking microscope service engineer to fix the looping, one can find the

best fixed model in the series to apply to future tilt data collection. To make the fixed

model permantly saved to the database, follow these steps:

# tomography/settings/model>activate "keep the tilt axis parameters

fixed".

# tomography/settings/model>initialize the model with "custom values". Enter best

estimate of the fixed model. For example, in the positive direction, enter phi as

-2.17 degrees and axis offset as -1.52 um. since these are the stable values up to the

point the y-looping starts.

# tomography>collect a full tilt series. If the run is successful with good

tracking in all three axis, the model will be saved in the database for this

magnification.

# tomography/settings/model>From now on, you can initialize the model with "only

this preset" or "this preset and lower mags"

h2. Grid slips between the first and second tilt directions

When the holder does not hold the grid tightly, the grid slips to a different position

when the first tilt direction ends and the goniometer quickly returns to zero tilt.

Leginon is designed to adjust the target before the second tilt group starts. The default

setting for this function is to use only the parent image (i.e. one ancestor) where the

target comes from as reference. If the slip is larger than the size of the parent image,

the adjustment may fail, and a random target would be acquired in the second tilt

group.

Starting from Leginon 1.6, the target adjustment can be done with all ancestor images

of the target by choosing "all" in the acquisition part of the tomography node setting to

adjust target with all ancestors. The node "Target Adjustment" limits the lowest

magnification that this target adjustment would go up in ancestry. The default is at 300x

so that the presence of the objective aperture does not create difference in the reacquired

ancestor image from its original.

h2. Strong and continuous specimen drift

The model used in Leginon considers any shift of feature in the image a result of tilt

axis not aligning to the center of the detector. With the phi and offset fixed, all errors

are accumulated in z0 and results in bad defocus correction. There is no solution to this

at the moment.

______

[[Set-up Before Running|< Set-up Before Running]] | [[Full Protocol on a F30 with an energy filter| Full Protocol on a F30 with an energy filter >]]