Leginon

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

Notes from the developer:

<pre>

There are a few conversion factor at the top of the file that may need adjustment depending on the microscope.

</pre>

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.

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 when the main viewing screen is up

h2. Leginon Calibration specifics

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:

* Beam Shift should be calibrated at mid and high mags (i.e. mags for hl and fa,fc,en,ef)

** Use the updated Calibrations or Calibrations2 to access "Image Beam Comp(ensation)" node which can be used to assist Beam Shift Calibration

* Image Shift should be calibrated at smaller shift distance if the beam moves too much to affect correlation.

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