Queuing Example 1 - Exposure Targeting¶

Queuing targets for Exposure node is used when a large number of exposure images need to
be acquired and immediate need of evaluation is required only up to intermediate mag of Hole
images. One example for such data collection mode is during high throughput single particle
data acquisition.

Configuration¶

Use the configuration for MSI until queuing is about to be used

• /Square/Toolbar/Setup/Wait for a node to process image = yes (as in depth-first
  MSI).

• /Hole Targeting/Toolbar/Setup/Queue up targets=no (as in depth-first MSI).

• /Hole/Toolbar/Setup/Wait for a node to process image = yes or no

yes: Pro-It won't cause problem if you forget to change this when you decide not to
use queuing later. Con-Time is wasted while holefinder picks targets.
(recommanded)

no: Pro-It saves some time by acquiring images while holefinder and YOU are picking
targets. Con-If you forget to switch it back on when you decide not to use queue later,
many things can go wrong, starting from nodes competing for the microscope

• /Exposure Targeting/Toolbar/Setup/Queue up targets=yes.

"Declare drift when queue is submitted" is optional but recommended. Use it if
accurate targeting is required. The time required to finish target will be
longer.

• /Exposure Targeting/Toolbar/Setup/Declare drift when queue is submitted=yes.

You may leave it off if you do not require acturate targeting (>0.5 um). The time
required to finish target will be longer with the option on.

• /Z Focus/Focus Sequence/Manual_after Enable=yes (optional but highly recommanded
  because further z height adjustment in Focus node affects only the current hole in
  queuing mode)

Operation¶

• Select square targets on grid atlas and submit as usual.

• One sq image will be acquired and then "Hole Targeting" finds the targets on the sq
  image.

• If user verification is turned on in "Hole Targeting", the targets should be
  submitted using "submit"<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/play.png" format="PNG"/>
  tool.

• The Z focus target will be processed first and the grid U-centered at the
  square.

• <link linkend="MSI_z_focus_check">Check if the grid is at U-center height in manual
  focus window</link>. Note that you won't see nice Thon rings because the preset is
  "hl"

• All hl images from the sq images wiil be acquired while "Exposure Targeting" finds
  the targets on each hl image if waiting in "Hole" node is off. Note that since the
  "Hole" node acquires images continuously, both hole finding and acquisition may compete
  for processing and memory time. If it affects your interaction with the program, just
  wait for the acquisition to complete.

• If user verification is turned on in "Exposure Targeting", the targets should be
  submitted using "submit"<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/play.png" format="PNG"/>
  tool.

• You may refresh atlas in "Square Targeting" and repeat the above steps to add more
  targets to the queue.

• The Queue is processed only when "Submit Queued Target"<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/send_queue_out.png"
  format="PNG"/> icon is clicked.

*Important: You should only do Submit Queued Target when leginon IS DONE
acquiring image if there is no waiting on "Hole". Otherwise, the "Hole" and "Exposure"
nodes may compete for the microscope and you can have images with the wrong
magnification.

Interruption¶

Hole and Square acquisitions are paused and aborted as usual.

Once the queue is submitted there are several modes of interruption

• If leginon crashes during queue processing, the data queue acquisition can be
  resumed by "Submit Queued Target"<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/send_queue_out.png"
  format="PNG"/> in "Exposure Targeting" node.

• Queued targets can be paused in "Exposure" node with the "pause" button and is
  <link linkend="MSI_pause">the recommanded pausing point for the liquid nitrogen refill
  of the side-entry cryo stage</link>.

• The "Abort" button<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/stop.png" format="PNG"/>
  in "Exposure" node aborts the acquisition of the remaining targets from the same parent
  "hl" image and proceeds to process targets from next hole in the queue.

• The "Abort Queue" button<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/stop_queue.png"
  format="PNG"/> in "Exposure" node aborts all remaining targets in the queue.

• If you want to pause queue processing and switch to depth-first mode temporarily,
  and then continue the queue processing, do the following:

• "Pause" the queue in "Exposure" node.

• Quit leginon once the program is standby in the paused mode.

• Restart leginon and the application.

• Change configuration to that of non-queuing mode and operate as such.

• When ready to continue queue processing, configure the related nodes as such
  when leginon is idle.

• Click on "Submit Queued Target"<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/send_queue_out.png"
  format="PNG"/> icon in "Exposure Targeting".

• Since the queued targets first reverts to its parent image stage position
  (including stage Z), you CAN NOT rescue bad U-centric height adjustment once the queue
  is submitted. You will have to abort the targets from the same square and hope the next
  square works.

• You can still change image shift, beam shift, exposure time of the presets during
  queue processing. Again, pause the queue and first send the problem preset to scope
  before making adjustment. You are warmed that the current location will be sacrifised
  during this process if the sample is exposed to the beam during your adjustment.

Adding more targets to the queue¶

It is possible to add more targets to the queue even when the queue is still being
processed. The reason is that "Submit Queued Target" <inlinegraphic
fileref="http://emg.nysbc.org/software/leginon/images/icons/send_queue_out.png"
format="PNG"/> really only signals that there are new targets updated to the queue that is
to be processed.

• Pause in "Exposure" node with the "pause" <inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/pause.png" format="PNG"
  /> button and is <link linkend="MSI_pause">the recommanded pausing point for the liquid
  nitrogen refill of the side-entry cryo stage</link>.

• Go to "Square Targeting" node, submit more square targets.

• Go to "Hole Targeting" node, submit more hole and z-focus targets as the images
  come in.

• Go to "Exposutr Targeting", submit <inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/play.png" format="PNG"/>
  to the queue more exposure and focus targets as the images

• When you have enough targets, click on "Submit Queued Target"<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/send_queue_out.png"
  format="PNG"/> icon in "Exposure Targeting".

• Go back to "Exposure", click on<inlinegraphic
  fileref="http://emg.nysbc.org/software/leginon/images/icons/play.png" format="PNG"/>
  to continue data acquisition.