Project

General

Profile

Using Gatan K2 Summit in Leginon » History » Version 26

Anchi Cheng, 07/11/2014 05:24 PM

1 4 Anchi Cheng
h1. Using Gatan K2 Summit in Leginon
2 1 Anchi Cheng
3 4 Anchi Cheng
The main use of K2 Summit is in Counted or Super-resolution mode in combination with dose fractionation (frame saving).
4
5 1 Anchi Cheng
If you want to use DM's dose fractionation, activate the "save frames" check box in the particular preset camera configuration.  You can also use DM's frame alignment algorithm by activating "align frames" check box, but the latter is not recommended since the alignment in DM will delay the return of the image to Leginon and therefore affects throughput greatly.
6
7 26 Anchi Cheng
h2. [[K2 configuration|Configuration]]
8
9
h2. [[K2 counting exposure|Recommended dose rate and exposure time for different K2 modes]]
10
11
h2. Preset Recommendation
12
13
See [[Pre-MSI_Set-up#Preset-Design-Example-for-small-pixel-Gatan-K2-camera-alone]] specific for K2 camera using counted/super-resolution mode.
14
15
h2. Calibrations
16
17
Most calibration and operation are similar to that of a typical digital camera.
18
19
Leginon treats linear/counted/super-resolution modes of K2 Summit as three cameras.  Therefore, each needs its own calibrations.
20
A python script is available to make the copying of the calibrations easier.  See message#1498.  You may need to modify it for different modes you are copying calibrations to.
21
22
h2. [[K2 Gain Correction|Gain/Dark Correction Handling]]
23
24 2 Anchi Cheng
h2. Configuration
25 1 Anchi Cheng
26 2 Anchi Cheng
# Make sure your camera configuration is set to [[Leginon image orientation]] and instruments.cfg matches that resulting orientation and dimension.
27 21 Anchi Cheng
** This is likely 270 degree rotated with a flip around vertical axis. New version of DM can acquire its internal darkware gain references in this configuration.
28 2 Anchi Cheng
# K2's dose fractionation (frame saving) only works with full camera dimension without binning.
29
# K2 interface in DM restricts the exposure time to multiple of some set number, depending on the mode.  When you enter in DM an invalid number, it automatically change it to the valid one when you click the acquire button.  pyscope/dmsem.py has hard-coded values for these precision. Compare them to the precision of the DM version you have since it may change with DM version.
30
# K2 frame exposure time is adjustable in Leginon gui.  However, you need to check if the number is acceptable by DM.
31 16 Anchi Cheng
# Frames are saved as unsigned 16-bit mrc image stack in K2 computer under D:\frames by default as set in the code inside pyscope/dmsem.py in the function calculateFileSavingParams.  You must create the frames directory first.  Leginon will not do that for you.  You may change where the frames are saved here but will need to make corresponding changes when setting up [[DDD_raw_frame_file_transfer|raw frame file transfer]]
32 24 Anchi Cheng
# The frames are "unprocessed" or "dark corrected" in DM terms.  Gain correction is still needed.
33
# Unless you want to develop your own frame alignment program.  We recommend that you [[appion:Direct_Detector_Frame_Processing|use Appion to do frame gain correction and alignment]].  These are parallelized by images so it cam almost keep up with the acquisition.
34 2 Anchi Cheng
35 17 Anchi Cheng
h2. Recommended dose rate and exposure time for different K2 modes
36
37
This recommendation is based on our experience.
38
39
As a general rule, the dose rate corresponds to the value used during DM gain reference acquisition.  You can put down the small viewing screen once the intensity is adjusted at the beginning of DM procedure to get the values.  You will notice that Linear mode calibration uses much higher beam intensity than the calibration for counted/super-resolution modes.  For our Tecnai F20 at 200 kV, the former reading of exposure time by the small viewing screen is 0.25 s while the value for latter is 1.6 s.  You should use similar intensity during Leginon calibration and data collection.
40
41
At 1.2 A/pixel, we use the following for final exposure that has binning of 1:
42 22 Anchi Cheng
|mode|small viewing screen exp time (s)|detector dose rate (e/physical pixel)|acquisition exposure time for ~ 20 e/A^2 specimen dose with 1.2 A/pixel pixel size (s)|
43 1 Anchi Cheng
|Linear|0.25|64|0.5|
44 22 Anchi Cheng
|Counted/Super-resolution*|1.6|10|5.0|
45
*Most literature recommend at even lower dose in the range of 6-8 e/s/pixel.  This is just a number we have had success with.
46 17 Anchi Cheng
47 1 Anchi Cheng
h2. Preset Recommendation
48
49 17 Anchi Cheng
See [[Pre-MSI_Set-up#Preset-Design-Example-for-small-pixel-Gatan-K2-camera-alone]] specific for K2 camera using counted/super-resolution mode.
50 1 Anchi Cheng
51
h2. Calibrations
52
53
Most calibration and operation are similar to that of a typical digital camera.
54
55 4 Anchi Cheng
Leginon treats linear/counted/super-resolution modes of K2 Summit as three cameras.  Therefore, each needs its own calibrations.
56 1 Anchi Cheng
A python script is available to make the copying of the calibrations easier.  See message#1498.  You may need to modify it for different modes you are copying calibrations to.
57
58
h2. Gain/Dark Correction Handling
59
60
h3. Counted/Super-Resolution mode
61 11 Anchi Cheng
62
K2 Summit in counted/super-resolution mode has two layers of gain reference correction, known as hardware (HW) correction and software correction.
63
64
Hardware dark correction is essential for electron counting, without it, its processor can not find individual electrons.
65
Hardware gain correction is a rough gain correction.  It is only done to make sure the data from different ADC boards are reasonably normalized before counting.
66
67
After these hardware correction and counting, the images are integers, representing the number of counts received at each pixel.  We call this type of data "raw".
68
69
Software dark correction for counted/super-resolution mode is fake.  The image taken in dark condition is set to 0 internally and output as such if a dark exposure is requested externally by SerialEM and Leginon.
70
Software gain reference taken in DM is equivalent to the bright image taken in Leginon.  The software gain correction, as well as Leginon's correction use this image of the blank area to normalize the more subtle differences from pixel to pixel.
71
72
After this level of gain normalization, the image data type is float.
73
74
Since Leginon duplicates the DM software gain normalization, we decided to receive images from DM  without software gain normalization.   This is set in the code, and means gain correction is still needed in Leginon.
75 1 Anchi Cheng
76 2 Anchi Cheng
# The hardware correction has been applied in DM before counting.  Therefore, the "raw" image Leginon get are integers and roughly gain corrected.
77 4 Anchi Cheng
# The dark image in Leginon should always be 0.  Therefore, acquiring dark image only need to be done once per camera configuration.  There is also no need to average several images in the making.
78 19 Anchi Cheng
# The bright image acquired in Correction node should be taken at the dose rate to be used.  It should also be taken so that accumulated exposure time is at least 100 second (DM reference accumulates 500 seconds of exposure by taking 50 of 10 second exposure).  If you don't want to wait this long, a reasonably good reference can normally be obtained with averaging 20 of 5 second exposure.  Alternatively, take a single very long exposure (100 s).
79 1 Anchi Cheng
80 19 Anchi Cheng
The bright image will display variation in sensitivity of the pixels.  There is likely a general gradient across the detector known as growth zone like this attached image:
81
82 18 Anchi Cheng
!K2brght.png!
83 12 Anchi Cheng
84
h3. Frame Saving
85
86
When frames are saved:
87
88 13 Anchi Cheng
* The image returned to Leginon gui and saved as usual IS gain normalized by Leginon as usual.  This is an integration over all the frames.  With the gain correction, the image is 32-float mrc image.
89 12 Anchi Cheng
90
* The movie frames recorded are "raw" as defined above.  This saves some time and keeps the file at 1/2 the size.  The format is 16-bit integer MRC image stack.  We plan to save in the future even smaller number of bits.  Appion will use the bright/dark/correction plan of the image transferred to Leginon to make corrected frame during [[appion:GainDark correction of the raw frame with or without drift correction|frame stack making]].
91 1 Anchi Cheng
92 9 Anchi Cheng
h3. Linear mode (Not recommended as we found the quality is unstable)
93 1 Anchi Cheng
94 2 Anchi Cheng
# The dark image will have a large mean and the value changes with exposure time.  Ideally, the dark images should therefore be taken at the same exposure time as the later images to be corrected.  Leginon can account for small differences but not a full range.
95
# To avoid saturation by the accumulated dark current, long exposure in linear mode is not recommended.  0.5 s is typical.
96
# Do not use frame saving with linear mode.  It is not worth while.
97 1 Anchi Cheng
98 9 Anchi Cheng
h2. Preparation in DM
99
100 25 Anchi Cheng
Hardware dark and gain correction need to be done by DM to count electrons.  You should therefore obtain dark and gain references and upload them to the hardware (HW).  You can do these in [[Leginon image orientation]] in 2.21 and above versions of DM.
101 9 Anchi Cheng
102
Once a while, but not very often (such as once a week or longer), all references should be retaken.  This takes at least 15 minutes.
103
104
Gatan recommends frequent hardware dark reference update.  This does not require beam.  You can do it everyday while getting the scope ready.
105
# Make sure the temperature of the camera is stable at where it should be cooled to.
106 10 Anchi Cheng
# Set the Direct Detection mode to Counted (just in case of DM gui bug).
107 9 Anchi Cheng
# Click on "Update HW Dark Reference".  This takes about 4 minutes.
108 2 Anchi Cheng
109 1 Anchi Cheng
h2. Operation
110
111 19 Anchi Cheng
# Typical frame saving preset parameters for counted/super-resolution: 0.2 s frame exposure time, 4-5 s total exposure time at 8-10 e/physical pixel/s (Some argues that 5 e/physical pixel/s is better).  You can use DM's reading of dose rate while it is in counted mode and *UNBINNed* to get a reasonable estimate.
112 2 Anchi Cheng
# Because of its small size, we have a modified [[MSI_Quick-start_for_DD_only|Quick-start procedure]] we use regularly at NRAMM FEI F20.
113 10 Anchi Cheng
# /myami/rawtransfer.py should be run on the file server to transfer the raw frames and give them names that are synced with the integrated image as it is produced. See [[DDD_raw_frame_file_transfer]].  K2 frames are saved as mrc stacks.
114 2 Anchi Cheng
# See [[appion:Direct_Detector_Frame_Processing]] for tools used for processing the frames.
115 9 Anchi Cheng
# To gain correct and align the frames, start parallel instances of Appion makeDDRawFrameStack.py See [[appion:GainDark correction of the raw frame with or without drift correction]].
116 26 Anchi Cheng
117
h2. Camera configuration for frame saving
118
119
# "Exposure time" specifies the total time in which the frames are saved.
120
# "Frame time" defines the length of each frame.  The minimal value is 50 ms for K2 Summit
121
# "Frames to use" is not used
122
# "Readout Delay" is not used
123
124
!K2Saveframe.png!
125
126 9 Anchi Cheng
127
h2. Warning
128
129 19 Anchi Cheng
* Because of a delay in communication with DM when Leginon is started, camera configuration shown in Correction Node settings may not corresponds to what is used last time when you quit Leginon.  Make sure you check this.
130 6 Anchi Cheng
131
h2. Leginon functions that do not work with K2 camera
132
133
h3. General functions
134
# The dose matching tool in Preset Manager.  K2's exposure time is not fine grained enough to make small adjustment according to the small dose deviation.  You will have to use fixed exposure time and adjust beam intensity by hand to achieve the right dose.  We find out the equivalent screen reading from the microscope for the acceptable 8-10 e/physical pixel/s dose rate for the detector and make adjustment there.
135 20 Anchi Cheng
# Tomography correlation algorithm only takes square images.  Until that is changed, Frame saving is not possible since only a full size unbinned image can be paired with frame saving.
136 6 Anchi Cheng
137
h3. Frame saving camera functions
138
# The image returned to Leginon display is always integrated over all the frames with K2 summit camera.  Selection of frames to use as in DE series does not work here.
139
# Readout delay is not adjustable on K2.  Leave it at 0.
140 2 Anchi Cheng
141
h2. Clean up
142
143
Frame saving generates a lot of files during acquisition and during processing.
144
145 5 Anchi Cheng
# python script in leginon directory "cleanddraw.py" can help you clean up the transferred raw frames when you start to run out of disk space.  See Feature #1784 for more details.
146 2 Anchi Cheng
# Selective removal of aligned frame stack in Appion runs is still to be written.