JEOLCOM installation specifics » History » Revision 22
Revision 21 (Anchi Cheng, 11/07/2015 07:53 PM) → Revision 22/25 (Anchi Cheng, 11/07/2015 10:40 PM)
h1. JEOL installation specifics
These implementations have pyscope modules included in our repository
h2. JEOL 1230
Developed at New York Structure Biology Center
Please contact David Stokes
h2. JEOL 1400, 2100, 3100 and 3200 (and other scopes with JEOL's COM library)
Developed originally at Northwestern University by Christian Suloway
h3. Install 32-bit version of myami package on the associated camera computer
* 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.
* In addition, probably because of the way JEOLCOM works, the installation is limited to 32-bit version.
h3. Alternatively, install myami package on JEOL scope-controlling microscope
* 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.
See [[JEOL External3 setup]]
{{include(comtypes installer)}}
Please check [[Windows_Installation_All]] for important installation instruction regarding comtypes
h2. jeol.cfg
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.
To do the pyscope communication test, copy pyscope/jeol.cfg.template to pyscope/jeol.cfg without any change. See [[Setup and Calibration for jeol.cfg]]
h2. instruments.cfg
[scope]
class: jeolcom.Jeol
cs: 4.1e-3
h2. Testing with pyscope
In python command
<pre>
from pyscope import jeolcom
t =jeolcom.Jeol()
t.getMagnification()
</pre>
You should get the current magnification at the microscope at the film camera position
h2. Leginon Calibration specifics
h3. Initial [[Setup and Calibration for jeol.cfg]]
h3. Follow the general installation and Leginon setup manual until you run "Calibrations" application and finishes obtaining your [[Bright_and_Dark_reference_images]].
h3. Refining scales in jeol.cfg
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:
# Calibrate [[Pixel Size Calibration|pixel size]] more accurately STAGE_SCALE in jeol.cfg is the most accurate. You should do Leginon stage position calibration first against it.
# During the calibration, you may find that pixel error is large at each magnification used, including lower magnification with low magnifications. You may want to refine pixel size, if the defocus error is consistently off to the same value and that will be used in experiment. these pixel size were obtained roughly through extrapolation.
# Iterate adjustment of Use the refined pixel size to calibrate image shift coil. If pixelsize error is large (> 40%), you may want to adjust jeol.cfg IMAGESHIFT_SCALE values in jeol.cfg and recalibrate in Leginon.
# Test the beam tilt scale. using [[TEM_Scripting_Beam_Tilt_Calibration|get_beamtilt_scale.py]] and repeat these steps
* Note that reproducibility and accuracy of stage movement becomes small at high magnification. but it will be easier to obtain accurate pixel size.
h3. Image Beam Compensation calibration
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.
This affects calibration procedure in two ways:
* Image Shift should be calibrated at smaller shift distance if the beam moves too much to affect correlation.
* [[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
h2. Custom Lens Programs
Note: This part requires microscopy knowledge. If you are a system admin, ask your local microscopist.
h3. sq preset magnification
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.
h3. lower intensity of the beam for very low magnification (such as gr) preset
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.
h2. [[Leginon Operation for JEM scopes]]