Project

General

Profile

JEOLCOM installation specifics » History » Version 24

Anchi Cheng, 03/03/2016 11:16 AM

1 1 Anchi Cheng
h1. JEOL installation specifics
2
3 2 Anchi Cheng
These implementations have pyscope modules included in our repository
4
5 1 Anchi Cheng
h2. JEOL 1230
6
7 24 Anchi Cheng
Developed at New York Structure Biology Center by David Stokes
8 1 Anchi Cheng
9 21 Anchi Cheng
h2. JEOL 1400, 2100, 3100 and 3200 (and other scopes with JEOL's COM library)
10 1 Anchi Cheng
11 13 Anchi Cheng
Developed originally at Northwestern University by Christian Suloway
12 1 Anchi Cheng
13 10 Anchi Cheng
h3. Install 32-bit version of myami package on the associated camera computer
14
15 12 Anchi Cheng
* Instead of installing myami package on JEOL scope-controlling PC, the access to JEOLCOM usually work through the computer controlling the digital camera, regardless of the camera manufacturer.
16 10 Anchi Cheng
17 1 Anchi Cheng
* In addition, probably because of the way JEOLCOM works, the installation is limited to 32-bit version.
18 12 Anchi Cheng
19
h3. Alternatively, install myami package on JEOL scope-controlling microscope
20
21
* This is only possible if this PC has TEMExternal3 installed and if it is on the same secured network as Leginon processing and database server.
22
23
See [[JEOL External3 setup]]
24 9 Anchi Cheng
25 7 Anchi Cheng
{{include(comtypes installer)}}
26 8 Anchi Cheng
27 1 Anchi Cheng
Please check [[Windows_Installation_All]] for important installation instruction regarding comtypes
28 8 Anchi Cheng
29 13 Anchi Cheng
h2. jeol.cfg
30
31
jeol.cfg records some instrument specific parameters that are required to convert the COM output to SI units that Leginon depends on as well as standard focus values needed for initializing defocus reference.
32
33 22 Anchi Cheng
To do the pyscope communication test, copy pyscope/jeol.cfg.template to pyscope/jeol.cfg without any change.
34 4 Anchi Cheng
35
h2. instruments.cfg
36
37
[scope]
38
class: jeolcom.Jeol
39
cs: 4.1e-3
40
41
h2. Testing with pyscope
42
43
In python command
44
<pre>
45 1 Anchi Cheng
from pyscope import jeolcom
46 15 Neil Voss
t =jeolcom.Jeol()
47 4 Anchi Cheng
t.getMagnification()
48
</pre>
49 1 Anchi Cheng
50 20 Anchi Cheng
You should get the current magnification at the microscope at the film camera position
51 1 Anchi Cheng
52
h2. Leginon Calibration specifics
53
54 22 Anchi Cheng
h3. Initial [[Setup and Calibration for jeol.cfg]]
55
56
h3. Follow the general installation and Leginon setup manual until you run "Calibrations" application and finishes obtaining your [[Bright_and_Dark_reference_images]].
57
58 1 Anchi Cheng
h3. Refining scales in jeol.cfg
59 20 Anchi Cheng
60
Unfortunately, Leginon's targeting relies on fairly good scale values in jeol.cfg.  If you have low confidence on these initial estimate, we recommend doing some iterations of the following:
61 22 Anchi Cheng
# Calibrate [[Pixel Size Calibration|pixel size]] more accurately at each magnification used, including lower magnification with the defocus that will be used in experiment.
62
# Iterate adjustment of IMAGESHIFT_SCALE values in jeol.cfg and recalibrate in Leginon.
63 23 Anchi Cheng
# Test the beam tilt scale using [[TEM_Scripting_Beam_Tilt_Calibration|get_beamtilt_scale.py]]
64 20 Anchi Cheng
65
h3. Image Beam Compensation calibration
66 16 Anchi Cheng
67
JEM scopes do not have a high level function we can access through scripting to move image shift without affecting beam location.  Therefore, any Leginon node that uses IMAGE SHIFT move type should be changed to BEAM-IMAGE SHIFT.
68
69 19 Anchi Cheng
This affects calibration procedure in two ways:
70 20 Anchi Cheng
* Image Shift should be calibrated at smaller shift distance if the beam moves too much to affect correlation.
71 17 Anchi Cheng
* [[Image Beam Compensation Calibration]] at mid and high mags (i.e. mags for hl and fa,fc,en,ef) is required to perform the compensation
72 18 Anchi Cheng
73
h2. Custom Lens Programs
74
75
Note: This part requires microscopy knowledge.  If you are a system admin, ask your local microscopist.
76
77
h3. sq preset magnification
78
79
For Leginon to function efficiently, it is highly desirable to have sq preset in Mag1 mode as the energizing/de-energizing of the objective lens is very slow.  If the image acquired in standard Mag1 mode does not give large enough area to accommodate error in repeated targeting or covers too few holes, it may be a good idea to design and request a custom lens program that replaces an unused MAG1 magnification (typically the lowest one).  For example, we have made such program replacing MAG1 1500x on JEM3200FSC @ NYSBC that gave us effective magnification of 750x. The lens program should be designed to energize objective lens and with balance of projection system to minimize distortion.  Rotation of the image is o.k.
80
81
h3. lower intensity of the beam for very low magnification (such as gr) preset
82
83
For Gatan K2 camera installed on JEM microscope, the beam may to too intense at the low end of the magnification for grid atlas collection.  While the camera is designed to protect itself when the beam is strong by retracting, it may not realize the problem when grid bar of the em grid reduces the average value.  It is worth asking your local service engineer to make a lens program that has lower CL1 value.  We replaced our spot 5 value with such a custom value.
84 17 Anchi Cheng
85 1 Anchi Cheng
h2. [[Leginon Operation  for JEM scopes]]