Leginon System version 1.6¶

Version 1.6 contains enhancement that is not available in version 1.5 and release of a
series of Robot Screening application. Most significant changes are the split of Drift Manager
functions to Transform Manager which handles the transformation of targets using any level of
ancestry rather than one in the original Drift Manager. This allows an expansion of method that
is meant to improve targeting accuracy. There are also significant improvement in Tomography
node and its operation.

1. pyScope Change
2. New User Features
3. Updated Applications (All)
4. New Project Web Tool Features
5. New dbemtool Web Tool Features (1.5.1)
6. Bug Fixes
7. Recommended Application Preference Changes when updated from version 1.5
8. Known Bugs

pyScope Change¶

With increasing number of instrument conflict, a configuration file is now required to
specify the instrument available on a host.

New User Features¶

General¶

• The settings window gui can all fit in 12" laptop display now

Acquisition/Navigator Class¶

The following applies to an acquisition node that uses the navigator to move to its
target:

• Based on a threshold, Targets can either be aborted or forced to collect when the
  multiple move failed to reduce further before reaching the goal.

• It is possible to improve the targeting accuracy with a combination of stage
  movement and final image shift. However, this requires specific relationship between
  the acquiring presets and parent image presets. It works currently only for tomography
  and depth-first traversal MSI scheme.

BeamFixer Class (New)¶

Simple beam shift adjustment to correct unstable beam position in long runs.

BeamTiltImager Class (New)¶

Visual aid to coma-tilt alignment. It is used to acquire images of beam tilt
difractogram tableau. The user can then click at the location of the tableau where he/she
considers as the coma-free and therefore adjust the beam tilt. See Node Description Chapter
for details.

Corrector Class¶

• A bad pixel region can be specified by clicking the corners and added to the bad
  pixel plan

• Extreme intensity pixels can be found by a click on this tool!http://emg.nysbc.org/software/leginon/images/icons/stagelocations.png!

• Normalization image of the chosen camera configuration can be displayed.

DriftManager Class¶

• A timeout for drift monitoring can now be specified so that if the drift is
  incorrectly detected due to an empty imaging area, the acquisition of the target will
  be aborted.

DTFinder Class (New)¶

Dynamic template finder is developed for tissue section imaging. An initial template is
defined by the user. The subsequent images it receives are then shifted and rotated against
the template to find the best match to the section so that the target selected on the
template can be transferred on to the new image.

FFTMaker Class¶

• Power Spectrum is displayed if processed.

• Option for calculating power spectrum but not saved to disk.

• Option for calculate a truncated power spectrum to speed up the calculation for
  large images.

GridEntry Class (New)¶

Direct entry of grid information to Leginon database to organize the data acquired. The
main use is for simple one-pass grid screening of multiple grids when the robot does not
exist.

ImageProcessor Class (New)¶

Base class for process images of a completed image target list. Mainly used for
development of batch processing of the images acquired such as image stack creation of a
tilt series. An example of its use is in filenames.py.

ManualAcquisition Class¶

• The acquired image can be sent to FFTMaker.

PresetsManager Class¶

• Preset Beam Ajustment Tool allows easier semi-automated adjustment of multiple
  presets at the same magnification.

PixelSizeCalibrator Class¶

• Power spectrum calculated from acquired image is displayed.

• Distances measured between diffraction spots are used for an user-interactive
  pixel size calculation and averaging.

Robot2 Class (Replacing Robot)¶

This class replaces Robot Class in all applications. It commnunicates to grid handling
robot(s) through database. A few default settings are changed to reflect it and also the
more general usage

• Simulate Robot Insert/extraction = True

• Default Z Position = 0

TargetFilter Class¶

• The images and targets that are filtered are displayed.

• User inspection and editing of the filtered targets are allowed.

Tomography Class¶

• Allow the model to remain fixed to the initial values.

• Separate goniometer models for positive and negative tilts.

• Options that are not found useful are removed.

TransformManager Class (New)¶

This class will eventually handle the transformation of an old target to a new one for
reacquisition after shift, tilt, and/or rotation in the grid plane. The current use is to
replace the shift adjustment in Drift Manager. As an option, it can transform targets based
on more than just its parent but all direct ancestors which makes the range of shift it can
handle much larger than the original drift manager implementation.

Updated Applications (All)¶

Manual¶

Power spectrum can be automatically calucated from the acquired image and displayed in
its own node to allow easy inspection.

Calibrations¶

New binding required by Navigation node.

MSI¶

New binding required by Navigation node. Drift management is divided between Drift
Monitor and Target Adjustment. A Preview and a Beam Fixing node are now standard in all MSI
applications

Robot-related applications¶

Robot2 class that uses database as midpoint to communicate bettween leginon and the
robot controller replaces Robot class

New Project Web Tool Features¶

Grid entry for Robot Trays (1.1)¶

This is used to enter grid information for robot trays.

Appion processing database creation (1.2)¶

This is used to create and link the project to a new database ready for Appion usage.

New dbemtool Web Tool Features (1.5.1)¶

Hide or exemplify an image in the viewers¶

Images can be one of the three status: Normal, Hidden, or Exemplar. Clicking on the hide
button above the displayed image where it is available moves the image from its current
list. In other words, to hide an image from any of the normal preset list, click on "hide"
while display a normal image. This image will now display only if "hidden" is selected from
the preset list. Clicking on "hide" above an image displayed in the hidden list removes it
from the "hidden" list and return it back to the normal list. Images put in the "exemplar"
list will also be shown in the normal list.

The mrc images are cached as jpegs in the viewers¶

The cache system allows faster access to the same image next time.

More options for image display intensity adjustment¶

You can manually define min/max of the display range in absolute number or relative
percentage, as well as in standard deviation unit based on the statistics of the image. The
manually determined values are saved for individual image displayed in the same panel until
the page is closed.

Queue counter in LOI¶

It updates the number of unprocessed queue targets and estimate how much time it will
still take to finish them.

Queue deletion tool in 3-way and LOI viewers¶

Click on this tool<inlinegraphic
fileref="http://emg.nysbc.org/software/leginon/images/images/deq_bt_off.gif"
format="GIF"/> above a displayed image pops up a window where you can remove targets
derived from that and all its descendent images. In other words. if you have put in the
queue targets from 10 holes, each selected from the same square image, you will delete all
theses targets if you perform queue deletion on the square image. Please use this
carefully.

Hole template and 2-way viewers¶

You can see your custom hole templates saved and used in the past leginon sessions in
the hole template viewer. 2-way viewer gives you a bigger view of the parent images than the
3-way viewer.

Model parameter display in the tomography viewer¶

The model paramters can be displayed for diagnosis by activating the check box.

Deletion candidate marking in the tomography viewer¶

The "Mark for deletion" button saves the selected tilt series in the leginon database in
a table that the system administrator can look up and delete from the file server in a later
time.

Appion processing function possible with installation¶

If you install Appion's processing server programs, the processing tag direct you to its
menu page.

Bug Fixes¶

GUI¶

• Tomography node settings is set in a scrolled window so that it is possible to fit
  it in a smaller display such as 12" screen of laptop computers

• Goniometer Modeler settings are automatically set.

.

Recommended Application Preference Changes when updated from version 1.5¶

Adjust Target For Drift Check Box is now a choice¶

If you checked "adjust target for drift" in any node of Acquisition class, it should be
changed to select "one" ancestor. A python script "update16.py" is provided for a complete
update of such setting in all related nodes. If the drift is so large that the different
versions of the parent images can not be correlated, you should change the choice from "one"
to "all" ancestors.

Known Bugs¶

• (New for v1.5) Resuming image acquisition from Square Targeting after Leginon
  restart may cause reacquisition of children of the unfinished target list on 32-bit
  Linux machine.

Dictionary ordering problem of MySQL query, No temporary solution.

• (New for v1.5) DataAccessError may show up when a user starts new application if
  default is loaded to an existing database.

Temporary solution: See <link linkend="bad_default_reference">Operation Trouble
Shooting</link> on the subject.

• (New for 1.3) Navigator multiple move option does not work properly in MSI imaging
  sequence with image shift as the move type.

Temporary solution: Always use preset manager when move type is image shift.

• Web viewer may not display all targets on the parent image since target is
  transferred to a different version.

No temporary solution.

• Kill Application may not kill all process cleanly and may cause problem in
  connecting to TEM or camera when a new application is reloaded.

Temporary solution: Close leginon and clients and restart.

• Simulate Target use the current image shift as the target shift on top of its preset
  shift. Therefore, the acquired image may carry an additional image shift if there is an
  offset created from previouis acquisition.

Temporary solution: Always use Presets Manager to send the preset to be used in
simulation first before usinging Simulate Targets tool.

• Some, although fewer, User Notification "processing " icons do not disappear but
  stay pointing up after the node is done.

Temporary solution: None.

• When running on LINUX system, Preset selection in /Presets Manager/Importing Presets
  from Another Session/ add a selection when mouse is left-clicked rather than toggle the
  selection as in convention.

Temporary solution: Hold down to Ctrl key to select and deselect multiple presets.
Shift key still means selecting all between the two clicks.

Note: This problem is caused by some bug in wxPython for LINUX.

• Web 3way Image viewer does not always show in yellow the revised (i.e. after drift
  correction) current target in the parent image.

Temporary solution: None.

• Starting Manual Focus directly by clicking on the tool does not use preset but still
  check for the preset assigned for the focuser node.