User Tools

Site Tools

This version is outdated by a newer approved version.DiffThis version (2021/02/19 14:19) was approved by shaikh.

This is an old revision of the document!


Correct Beam Tilt : Applies beam-tilt correction to particles.


Usage in command line output_directory --input_stack=INPUT_STACK --star_file=STAR_FILE --kv=KV --cs=CS --apix=APIX --tiltx=TILTX --tilty=TILTY --micdir=MICDIR --box_size=BOX_SIZE --coordsdir=COORDSDIR --partdir=PARTDIR --verbosity=verbosity_level --debug

Typical usage

sp_beamtilt exists in both MPI and non-MPI versions (Running MPI version does not require –MPI flag).

The purpose of is to:

: read beam-tilt information, from a STAR file or from the command line
: corrects images for beam tilt
: applies those corrections to either an input stack or extracts them from particles
: write the correct particle stack to disk

1. Standard usage: Read beam-tilt data from STAR file and particles from stack:

mpirun -np 16 output_directory --input_stack bdb:Particles#data --star_file 

STAR files from RELION v3.0 and v3.1 have been tested and should work.

2. Provide the beam-tilt parameters directly from the command line:

mpirun -np 16 output_directory --input_stack bdb:Particles#data --kv=200 --cs=1.4 --apix=0.885 --tiltx=-0.096436 --tilty=0.26850

Beam tilt is to be provided in units of milliradians. Other required parameters are accelerating voltage, spherical aberration constant, and pixel size.

3. Particles are to be extract directly from micrographs

mpirun -np 16 output_directory --star_file --micdir=input_micrograph_directory  --box_size=256 --coordsdir=output_coordinates_directory --partdir=output_particles_directry

This option has not been tested thoroughly.


Main Parameters

Input particle stack. (default None)
Input STAR file. (default None)

Advanced Parameters

Accelerating voltage, kilovolts. (default None)
Spherical aberration constant. (default None)
Pixel size, Angstroms. (default None)
Beam tilt along x, in milliradians. (default None)
Beam tilt along y, in milliradians. (default None)
Input micrograph directory, if extracting particles. (default None)
Box size, in pixels, if extracting particles. (default None)
Output coordinates directory, if extracting particles. (default None)
Output particles directory, if extracting particles. (default None)
Controls how much information will be written to the screen. (default 3)
Performs a dry run. (default False)


Tilt-corrected particles




Zivanov J., Nakane T., Forsberg B.O., Kimanius D., Hagen W.J.H., Lindahl E, Scheres S.H.W. (2018) “New tools for automated high-resolution cryo-EM structure determination in RELION.” eLife 7: e42166.

Developer Notes

Eventually, we want to correct for beam tilt on the fly, and not write the corrected images to disk.

Author / Maintainer

Tapu Shaikh





See also


Beta:: Under evaluation and testing. Please let us know if there are any bugs.


pipeline/meridien/sp_beamtilt.1613740753.txt.gz · Last modified: 2021/02/19 14:19 by shaikh