Leginon

h1. Presets Manager

Configuring the Presets can be critical to many different applications. Presets describe

camera configurations such as image size and exposure time as well as many other microscope

parameters such as magnification and defocus. Different nodes can use these predefined presets

to change conditions of the microscope and CCD.

<highlights>

Required bindings for using preset image shift alignment tool

<simplelist type="vert">

<member>Presets Manager - (MoveToTargetEvent) -> NavigatorNode</member>

</simplelist>

</highlights>

<highlights>

Required bindings for using presets in any acquisition class (including focuser) of

nodes

<simplelist type="vert">

<member>AcquisitionNodeAlias - (ChangePresetEvent) -> Presets Manager</member>

<member>Presets Manager - (PresetChangedEvent) -> AcquisitionNodeAlias</member>

</simplelist>

</highlights>

<highlights>

Required bindings for nodes that can use preset instrument configuration set by presets

manager

<simplelist type="vert">

<member> PresetsManagerNode - (PresetChangedEvent) -> Node</member>

</simplelist>

</highlights>

<highlights>

Required bindings for auto dose measurement as initiated by MSI-Tomography

<simplelist type="vert">

<member>TomographyNode - (MeasureDosePublishEvent) -> MeasureDoseNodeAlias</member>

<member>MeasureDoseNodeAlias - (ChangePresetEvent) -> Presets Manager</member>

</simplelist>

</highlights>

h2. Available functions

* Toolbar

* Presets Manager Settings

* Main Presets node panel (panel image icon)

*  Preset Selector

*  (up/down icon) Move preset up/down in the cycle order

*  (to scope icon) Sends parameters of the preset to scope

*  (from scope icon) Saves parameters of the preset from current scope and CCD

settings

*  (acquire icon) Acquires 512x512 image at current sent preset

*  (remove icon) Removes selected preset from list

*  (align icon) Align image shift between presets

*  (new from scope icon) Creates new preset from current scope and CCD

settings

*  (import from session icon) Imports preset(s) from another session.

*  Calibrations - Displays the date and time when calibrations related to the

selected preset was last saved.

*  Parameters - Displays and Allows direct setting of parameters associate with

the selected preset.

h2. Settings - Movement

* Pause between preset changes

- The pause allows the optics to settle between preset changes

*  Move stage x and y axis only

- Rather than target to x,y,z,alpha, and beta settings of the goniometer, only x

and y axis values are sent. Checking this selection allows eucentric height adjustment

at regular interval during a long session.

h2. Settings - Cycle

Hysteresis of image and beam shift is experienced everyday when using the microscope.

This general hysteresis affects many Leginon calibrations. Keeping current in the lenses,

particularly the objective lens, has been seen to help reduce the effects of this

hysteresis. Likewise, stepping through magnifications in a fixed order (low to highest to

low to highest etc.) has been empirically helped reducing the hysteresis effects.

It is highly recommended to leave the first two check boxes in this section

(Leginon/Presets Manager/Settings) enabled. Cycle Magnification Only should be checked if

the hysteresis from changing beam intensity is negligible.

*  Cycle presets

- The presets' cycle Order will be used whenever changing between presets.

*  Optimize Preset Cycle

- If there are multiple presets with the same magnification in the Cycle Order,

only the first preset in the order list or the destined preset will be sent. This

helps speed up the cycling time. Use of this option assumes that the main source of

hysteresis is change of magnification.

*  Cycle Magnification Only

- Other than the case for the final destination preset, only the magnification

will be sent to the microscope instead of all the other preset's parameters. All of

the destined preset's settings will be sent to the microscope. This option will reduce

the cycle time as well. Use of this option also assumes that the main source of

hysteresis is change of magnification.

h2. Presets Selector and Cycle Order List

*  Leginon/Presets Manager> select a preset from the Preset Selector.

*  Up/Down: Move the presets up or down in the Cycle Order.

NOTE: To reduce cycling time, it is best to group the presets that often occur

consecutively in order. For example, the typical MSI preset order is

[ gr, sq, hl, fc, fa, en, ef ]

h2. Sending Presets to the microscope

*  Leginon/Presets Manager> select a preset from the Preset Selector.

*  Leginon/Presets Manager> click To Scope icon to send the current preset to the

microscope.

h2. Adjusting Presets at the microscope

*  Leginon/Presets Manager> select a preset from the Preset Selector.

*  Leginon/Presets Manager> click To Scope icon to send the current preset to the

microscope.

*  Adjust the microscope settings either at the microscope or in a node that

controls the microscope (em*) and/or the camera (navigator,etc.).

*  Leginon/Presets Manager> click From Scope icon to save the current settings to

this preset.

h2. Acquistion / Dose Image

This section is used to acquire a "Dose Image" and calculate the electron dose per area

on the specimen at the current preset using the averaged intensity of the image and various

calibrations. The dose value is then updated in the database for the current preset. To

acquire a dose image, no object must obstruct the path of the electron beam.

The dose calculated by this function relies on the camera sensitivity calibration

obtained in the <link linkend="dosecal">Dosecal</link> node as well as the <link

linkend="pcal_node">pixel size calibration</link>. The result of the calibration is CCD

sensitivity value that converts number of electrons to camera signal count (i.e. intensity).

With both information, the average CCD intensity of the Dose Image acquired through the

Presets Manager can be used to calculate the dose in unit of electrons per angstrum. Change

of preset scope parameters will reset the dose value.

*  Move the stage to an empty area or a broken hole so that the whole screen can

have uniform illumination.

*  Leginon/Presets Manager> Send a selected preset and its parameters to

scope.

*  Leginon/pm/Presets Manager> click Acquire Dose Image.

*  The image and the calculated dose will be display.

*  In order to reduce the acquisition time, the dose image has a maximal

dimension of 512x512 and is centered at the same position as the camera

configuration of the preset.

*  The rest of the preset's settings (e.g. Camera Binning, Exposure Time, Beam

shift, Intensity, etc.) are unchanged during the dose image acquisition.

*  Exposure time can be changed automatically by matching a desired

dose.

h2. Removing a Preset

*  Leginon/Presets Manager> select a preset from the Preset pull-down list in the

Selection section.

*  Leginon/pm/Presets Manager> click Remove icon.

h2. Align Presets To Each Other

To align presets by image shift, first a global reference is chosen. The global

reference serves two purposes. First as the parking preset that the scope returns to after

acquiring images at various mags. Second as the preset for initial alignment. The automatic

sequence centered at the magnification of the global reference First it aligns pairs of

magnification towards higher and higher magnification for those at higher magnification than

the global reference and then toward lower and lower magnification for those at lower

magnification than the global reference.

For each magnification, a preset is automatically chosen to be used in the alignment and

is displayed in the window. The left panel displays the reference preset and the right panel

displays the preset to be aligned. Navigate on the reference image moves the stage while

navigate on the align image moves image shift.

The image shift is saved at each move to the specified preset but not other presets of

the same magnification until "continue" is clicked.

To switch to custom alignment between arbitrary presets, change the preset assigned for

either panel when the window is first open.

h2. Create Presets from the current Session

*  Adjust the microscope settings either at the microscope or in em* node or any

node where camera configuration can be set)

*Aliased as instrument in most applications).

*  Leginon/Presets Manager> Click New From Scope icon to open "Create New Preset"

setting window.

*  Leginon/Presets Manager/Create New Preset> Type a descriptive name for a

Preset, "hole" for example, left-click "Create" to save and close the window.

*  Leginon/Presets Manager/Parameters/Camera Configuration> Change the camera

configuration and exposure time if desired. It will be saved automatically when

changed. This step is necessary sometimes because the preset is created with the

current camera configuration at the CCD.

h2. Import Presets from a previous Session

*  Leginon/Presets Manager> select (import preset icon) to open the import

presets window.

*  Leginon/Presets Manager/Import Presets> select the session from which the

presets will be imported in the pull-down list. Only sessions from the same instrument

used in the current session will be displayed.

*  Leginon/Presets Manager/Import Presets> select the presets to be imported,

import them and then press done to exit the window. You can select all presets by

highlighting all presets (select the first preset with left click, and then select the

last preset with shift-left click).

h2. Calibration Status

This section may prove to be very useful to troubleshoot calibration problems. Over

time, certain calibrations may need to be repeated. This section will display the latest

calibrations that were completed for the settings the current preset has and when they were

completed.

If a new presets needs to be created. Then after creating the new preset, check this

section to see which calibrations the new preset will need to be completed.

*  Pixel Size: This value is entered through the Pixel Size Calibrator node.

(required)

*  Image Shift Matrix: This is calculated through the Image Shift matrix

calibration. (required)

*  Stage Shift Matrix: This is calculated through the Stage Shift matrix

calibration. (necessary to build an Atlas).

*  Beam Shift Matrix: This is calculated through the Beam Shift matrix calibration

(necessary to move the beam in Navigator).

*  Modeled Stage: This is calculated through the Modeled Stage Position calibration

(necessary to accurately center holes/targets for medium magnification images).

h2. Parameters-Instruments

Select the instruments available on the scope client

*  TEM

*  CCD Camera

h2. CCD settings

*  Common Configuration - choose one of the common configurations (dimension x

binning). All of these configurations use the center portion of the CCD.

*  Or, use Manual camera configuration settings.

*  Common Configuration> choose Manual

*  Enter the image Dimension (x,y).

- Pay attention to the binning and offset to ensure the proper actual

coverage of the CCD.

*  Enter the image Binning (x,y).

*  Enter the offset from the top left hand corner of the CCD. Remember to

check that the Dimension, Binning, and Offset are set to values to make sense

(i.e. do not enter 4096x4096 dimension, 4x4 binning, 512x512 offset for a 4k

CCD).

*  Camera Configuration> Enter the Exposure Time (in milliseconds).

h2. Microscope settings

*  magnification

*  defocus (in meters)

*  spot size (1-11)

*  intensity (0.0-1.0)

*  image shift (in meters)

*  beam shift (in meters)

*  Pre-exposure (s): Lowers the main screen for the given time as a pre-exposure

before image acquisition

*  Dose-Displays the dose estimate from the most recent dose image acquired with

current preset parameters. This value has the units of # electrons / (Angstrom)^2. If

the dose image has not been acquired for this preset, 0.00000e+0.0 is the

default

h2. Film settings

An exposure onto film can be done instead of acquiring an image with the CCD. To acquire

an image onto film, simply enable the "film" checkbox:

h2. Energy Filter settings

If EFTEM is on, and if "Energe Filtered" is checked, the energy filter will be set to a

width of the specified value when the preset is sent to the scope

______

[[Pixel Size Calibrator|< Pixel Size Calibrator]] | [[Raster Finder|Raster Finder >]]

______