Skip to main content

The perfectem package provides a set of scripts designed to test TEM performance. Some tests have been adapted from TFS SAT procedures. The scripts are using SerialEM’s Python module. Installation on both Windows and Linux OS is supported.

PyPI release License Supported Python versions Downloads

Installation

Requirements:

  • python >= 3.8

  • matplotlib, mrcfile, numpy, scipy

  • SerialEM Python module will be compiled during installation unless already present

Installation from PyPI

This assumes you have connection to the internet.

Execute from the command line (assuming you have your Python interpreter in the path):

Windows:

py -m pip install perfectem

Linux:

pip install perfectem

Offline installation

  1. Download *.whl files for matplotlib, mrcfile, numpy and scipy into the current folder

  2. Download https://github.com/azazellochg/perfectem sources

  3. Execute from the command line (assuming you have your Python interpreter in the path):

Windows:

py -m pip install matplotlib mrcfile numpy scipy perfectem --no-index --find-links .
py -m pip install -e <perfectem_source_directory>

Linux:

pip install matplotlib mrcfile numpy scipy perfectem --no-index --find-links .
pip install -e <perfectem_source_directory>

Available scripts

  • AFIS validation
    • Specification (Krios): coma < 750 nm, astigmatism < 10 nm for 5 um shift. Glacios: coma < 1200 nm, astigmatism < 15 nm for 6 um shift

    • Description: Measure residual beam tilt and astigmatism at different image shift positions while EPU is open.

  • Atlas realignment
    • Specification: none

    • Description: Compare the shift and rotation between two atlases acquired when reloading the same grid.

  • Magnification anisotropy
    • Specification: <1%

    • Description: Acquire a defocus series and plot astigmatism versus defocus. Calculate anisotropy by estimating deviation from linear behaviour.

  • C2 Fresnel fringes
    • Specification: on FFI system there should be <5 fringes at 96 kx in nanoprobe close to focus

    • Description: Take a picture of a flood beam to see if the fringes from C2 aperture extend all the way to the center (non-FFI systems).

  • Eucentricity check
    • Specification: <2 um in X/Y, <4 um defocus (Krios G2, G3, G3i)

    • Description: Estimate X,Y and defocus offset while tilting the stage.

  • Gain reference check
    • Specification: none

    • Description: Take a picture of a flood beam and check the auto-correlation image.

  • Gold diffraction
    • Specification: none

    • Description: Take a high magnification image of Au-Pt and check the diffraction spots up to 1 A in all directions.

  • Information limit
    • Specification (Krios < G4): 0.14 nm at 0 tilt, 0.23 nm at 70 deg. tilt. Glacios: 0.23 nm at 0 tilt, 0.34 nm at 70 deg. tilt.

    • Description: Take two images with a small image shift (0.12 nm), add them together and calculate FFT. You should observe Young fringes.

  • Point resolution
    • Specification (Krios): 0.2 nm at 73 nm defocus. Glacios: 0.24 nm at 82 nm defocus.

    • Description: Take a high-resolution image on carbon (Pt-Ir grid recommended) at extended 1.2 Scherzer defocus. The first CTF ring defines the point resolution.

  • Stage drift
    • Specification: 0.5 nm/min (but TFS does the test in a very different way)

    • Description: From a starting position move 1 um in each direction and measure drift until it is below threshold (1 A/s).

  • Thon rings
    • Specification (Krios): rings visible beyond 0.33 nm at -1 um defocus. Glacios: rings visible beyond 0.37 nm at -2 um defocus.

    • Description: Take a high-resolution image on carbon and fit CTF rings as far as you can. Calculate a radial average from one quadrant.

  • Tilt axis offset
    • Specification: <1 um

    • Description: Estimate the tilt axis offset optimized for movement along the z-axis during tilting

Running scripts

The scripts have been tested only on TFS Titan Krios and Glacios microscopes. All tests except maybe Point resolution (which needs a Pt-Ir grid) require a cross-grating grid (e.g. AGS106L Diffraction grating replica with latex spheres) inserted and the eucentric height adjusted. Also, it is assumed that the microscope is already well aligned.

First, have a look at config.py: edit microscopes dictionary and individual parameters for each test. Make sure SerialEM is open. To start the program, simply type in the Windows CMD / Linux console:

perfectem

If you prefer clicking buttons over console, you can create a desktop script PerfectEM.bat that contains one line:

perfectem-gui

PS. The simple GUI requires Python built with tkinter support.

Metadata

Release files for perfectem 0.9.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for perfectem 0.9.5
File Size Uploaded
perfectem-0.9.5.tar.gz 71.9 kB Details

Release files / perfectem-0.9.5.tar.gz

Download URL perfectem-0.9.5.tar.gz
Size 71.9 kB
Tags Source
SHA-256 checksum
How to use checksums
10adbdaebbe638674833c5127ec037dccdcbff77408a7cd31a33290e01b8f62f
BLAKE2b-256 checksum
How to use checksums
341209f540b9e5c33ebb9af7ab4ae6e583fc44ba44ee00065c8d0180c4b2aa54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.8.18

Release history Release notifications | RSS feed

This release

0.9.5 This release

1 release file

0.9.4

1 release file

0.9.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page