Leginon

h1. Raster finder nodes set-up

The user should setup the presets and the preference configuration of the nodes in MSI raster application in the way identical to MSI application. Since MSI raster application is used when continuous carbon support is used rather than holey film, the name of the nodes are changed accordingly so that the node "Hole Targeting" in MSI is now "Sub-Square Targeting" and "Hole" is now "Sub-Square". Both "Sub-Square Targeting" and "Exposure Targeting" nodes are now derived from "raster finder" node class and the following set-up apply to both nodes.

h2. Initial Raster Finder Preference Setup in MSI-raster (1.3)

To use MSI-raster after MSI-Edge or MSI-T preference has been set by the administrator or customized by the user, the administrator should set the following preference with MSI-raster application loaded:

Subsquare Targeting/Settings and Exposure Targeting/Settings>

*  Allow for user verification of picked holes = yes

*  Queue up targets= no

*  Declare drift when queue is submitted = yes (default)

h2. Raster Finder basics

Raster finder works in three steps:

*  It creates raster points on the image defined by the center, the spacing between the points and the angle of the raster axis from the image axis. Number of points defines the number across each raster axis. The total number of raster points are also limited by the image size as no raster point is allowed outside the image.

A symmetric raster have equal spacing and number at both raster axis. If symetric is chosen, only x spacing and number need to be entered.

*  If an image acquired is loaded, it is possible to calculate the best spacing and angle to achieve a desired overlapping image. The calculator uses the preset used in the loaded image and the preset with which the raster images will be collected and their calibrations for the move type the raster targets will be moved by.

*  A polygon can be drawn by the user to limit the raster region that will be considered in the later steps.

*  Ice thickness is used to limit the valid raster points to usable region.

*  Target templates are applied to the valid raster points to create the final acquisition and focus targets. The template can be constant, meaning that it is defined relative to the image coordinate. The template can also be convolved with the raster points which will create multiple targets, each defined relative to the coordinate of the valid raster points.

h2.  Select a raster on the first image of a square

Select a raster arrangement to collect data from by making selections on the first image of a square.

*  Go to Leginon/Sub-Square Targeting> It should display the current square image. If not, following MSI operation instruction on <link linkend="MSI_select_sq">Selecting Squares on Atlas</link>.

*  If the target selection is acceptable, uncheck User Check in Leginon/Sub-Square Targeting/Toolbar/Settings>.

*  If the target selection is not acceptable, try adjusting the Raster Finder to find holes in the current image of a square.

*  Display the raster (sky-blue cross hairs) and then open raster setting window next to the display selection panel.

*  If the exposure and focus selection is not acceptable, try adjusting the Raster Finder to pick the correct targets.

*  Leginon/Sub-Square Targeting/Raster Setting>

Choose a Raster Spacing that makes sense with the overlap of the beam, e.g. 100+ or use the "Spacing/Angle Calculator" to achieve a desired overlap. Note that Raster Preset and Move Type are those set at "Subsquare" node.

Increase raster spacing if there is too much overlap of imaging area for the next preset. Decrease number of points if the square opening is much smaller than the square image or if there is no need to explore all area of the square. Angle the raster to either fit the square best or to create optimal coverage.

Test the parameters in the setting window and check the results on the node image display panel. Click on O.K. to save and leave the setting window.

*  Activate display for Polygon Vertices and Polygon Raster. Select the marker input tool for the polygon vertices and pick the vertices on the image if polygon is used to limit the raster region. No limit is set to the raster region if no vertices are picked.

*  Leginon/Sub-Square Targeting/Polygon Setting>

Check the polygon raster (orange cross hairs) by clicking on "test"

If the polygon need adjustment for each future image, turn on "Wait for polygon selection".

*  Undisplay the raster (sky-blue cross hairs) and polygon raster (oragne cross hairs) by clicking on the display selection again. Alternatively, click on both Acquisition and Focus target display selection twice to move them to the top layer of the display.

* Hover the mouse over the image in the display panel of the node to find the maximum and average intensity value of the usable region.

*  Find a Focus postion (e.g. (360,145) ) on the image that will be entered in Focus Targets/Constant Template>.

*  Hover the mouse over the image with the "42" button enabled where the Focus position is desired.

*  The (x,y) value that appears over the image is the value that should be entered in the Focus Targets/Constant Template area.

*  Leginon/Sub-Square Targeting/Acquisition or Focus Setting>

*  Enter a value above the maixmal intensity found in the previous step into the Zero Thickness field in /Ice Analysis>.

*  Click Analyze Ice and check the raster arrangement that passed the intensity analysis test. Adjust the Zero Thickness value to change the raster pattern. You may also change the ice thickness max, min, and standard deviation threshold to rejects area with stain that is too thick ,too light or too uneven, respectively.

*  Select target templates to modify the targeting scheme. A constant Focus template for Z focus should be included. The automatic focus targeting routine found in hole finder is not yet implemented in this node class. Click on "Analyze Ice" to test the template before saving and leaving the setting window.

*  Click Submit (in Leginon/Sub-Square Targeting/Toolbar> to process the final targets.

*  If the target selection is acceptable, uncheck User Check in Leginon/Sub-Square Targeting/Toolbar/Settings>.

h2.  Select Exposure and Focus targets on the first Sub-square image

Pick exposure and focus targets on the first hole preset (Sub-Square) image

*  Go to Leginon/Exposure Targeting> It should display the current Sub-Square image

*  Check whether exposure (red cross hair) and focus (blue cross hair) targets were selected correctly (in the correct raster fashion).

*  If the target selection is acceptable, uncheck User Check in Leginon/Exposure Targeting/Toolbar/Settings>.

*  If the target selection is not acceptable, try adjusting the Raster Finder to find holes in the current image of a square.

*  Display the raster (sky-blue cross hairs) and then open raster setting window next to the display selection panel.

*  Leginon/Exposure Targeting/Raster Settings>

Choose a Symmetric (x=y) or Asymmetric Raster Spacing and angle that makes sense with the overlap of the beam. If symetric is chosen, only x spacing and number need to be entered. Alternatively, use the "Spacing/Angle Calculator" to achieve a desired overlap. Note that Raster Preset and Move Type are those set at "Subsquare" node.

Test the parameters in the setting window and check the results in the node image display panel. Click on O.K. to save and leave the setting window.

*  Activate display for Polygon Vertices and Polygon Raster. Select the marker input tool for the polygon vertices and pick the vertices on the image if polygon is used to limit the raster region. No limit is set to the raster region if no vertices are picked.

*  Leginon/Exposure Targeting/Polygon Setting>

Check the polygon raster (orange cross hairs) by clicking on "test"

If the polygon need adjustment for each future image, turn on "Wait for polygon selection".

*  Undisplay the raster (sky-blue cross hairs) and the polygon raster (orange cross hairs) by clicking on the display selection again. Alternatively, click on both Acquisition and Focus target display selection twice to move them to the top layer of the display.

* Hover the mouse over the image in the display panel of the node to find the maximum and average intensity value of the usable region.

*  Find a Focus postion (e.g. (360,145) ) on the image that will be entered in Focus Targets/Constant Template>.

*  hover the mouse over the image with the "42" button enabled where the Focus position is desired.

*  The (x,y) value that appears over the image is the value that should be entered in the Focus Targets/Constant Template area.

*  Leginon/Exposure Targeting/Acquisition or Focus Settings>

*  Enter a value above the maximal intensity found in the previous step into the Zero Thickness field in /Ice Analysis>.

*  Click Analyze Ice and check the raster arrangement that passed the intensity analysis test. Adjust the Zero Thickness value (up/down) to change the raster pattern. You may also change the ice thickness max, min, and standard deviation threshold to rejects area with stain that is too thick ,too light or too uneven, respectively.

*  Select target templates to modify the targeting scheme including the constant template for focus. Click Analyze Ice to test the template before leaving the setting window by clicking OK.

*  Click Submit in Leginon/Exposure Targeting/Toolbar> to process the targets.

*  If the target selection is acceptable, uncheck User Check in Leginon/Exposure Targeting/Toolbar/Settings>.