Project

General

Profile

JEOLCOM installation specifics » History » Revision 24

Revision 23 (Anchi Cheng, 11/07/2015 10:42 PM) → Revision 24/25 (Anchi Cheng, 03/03/2016 11:16 AM)

h1. JEOL installation specifics 

 These implementations have pyscope modules included in our repository 

 h2. JEOL 1230 

 Developed at New York Structure Biology Center by 

 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. 

 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 at each magnification used, including lower magnification with the defocus that will be used in experiment. 
 # Iterate adjustment of 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]] 

 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]]