This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | Last revision Both sides next revision | ||
pipeline:meridien:sp_beamtilt [2021/02/19 14:19] shaikh [Reference] |
pipeline:meridien:sp_beamtilt [2021/02/19 16:19] shaikh |
||
---|---|---|---|
Line 5: | Line 5: | ||
Correct Beam Tilt : Applies beam-tilt correction to particles. | Correct Beam Tilt : Applies beam-tilt correction to particles. | ||
- | \\ | ||
===== Usage ===== | ===== Usage ===== | ||
Usage in command line | Usage in command line | ||
- | sp_beamtilt.py 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 ===== | ===== Typical usage ===== | ||
- | sp_beamtilt exists in both MPI and non-MPI versions (Running MPI version does not require | + | sp_beamtilt exists in both MPI and non-MPI versions (Running MPI version does not require |
The purpose of sp_beamtilt.py is to: | The purpose of sp_beamtilt.py is to: | ||
- | | + | < |
- | : corrects images for beam tilt | + | : read beam-tilt information, |
- | : applies those corrections to either an input stack or extracts them from particles | + | : corrects images for beam tilt |
- | : write the correct particle stack to disk | + | : 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__: | + | |
- | | + | </ |
+ | |||
+ | |||
+ | __1. Standard usage: Read beam-tilt data from STAR file and particles from stack__: | ||
+ | < | ||
+ | mpirun -np 16 sp_beamtilt.py output_directory --input_stack bdb: | ||
+ | |||
+ | </ | ||
STAR files from RELION v3.0 and v3.1 have been tested and should work. | 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__: | + | \\ |
+ | __2. Provide the beam-tilt parameters directly from the command line__: | ||
+ | < | ||
+ | mpirun -np 16 sp_beamtilt.py output_directory --input_stack bdb: | ||
- | mpirun -np 16 sp_beamtilt.py output_directory --input_stack bdb: | + | </ |
Beam tilt is to be provided in units of milliradians. Other required parameters are accelerating voltage, spherical aberration constant, and pixel size. | 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__ | ||
- | | + | \\ |
+ | __3. Particles are to be extract directly from micrographs__ | ||
+ | < | ||
+ | mpirun -np 16 sp_beamtilt.py output_directory --star_file particles.star --micdir=input_micrograph_directory | ||
+ | |||
+ | </ | ||
This option has not been tested thoroughly. | This option has not been tested thoroughly. | ||
- | + | ||
- | \\ | + | |
===== Input ===== | ===== Input ===== | ||
+ | |||
=== Main Parameters === | === Main Parameters === | ||
- | | + | |
- | | + | ; ; < |
- | + | ||
- | \\ | + | |
=== Advanced Parameters === | === Advanced Parameters === | ||
- | | + | |
- | | + | ; ; < |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | + | ||
- | \\ | + | |
===== Output ===== | ===== Output ===== | ||
- | | + | |
- | + | ; ; bdb: | |
- | \\ | + | |
===== Description ===== | ===== Description ===== | ||
- | \\ | ||
==== Method ==== | ==== Method ==== | ||
- | \\ | ||
==== Reference ==== | ==== Reference ==== | ||
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." | 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." | ||
- | |||
- | |||
==== Developer Notes ==== | ==== Developer Notes ==== | ||
+ | |||
Eventually, we want to correct for beam tilt on the fly, and not write the corrected images to disk. | Eventually, we want to correct for beam tilt on the fly, and not write the corrected images to disk. | ||
- | \\ | ||
==== Author / Maintainer ==== | ==== Author / Maintainer ==== | ||
+ | |||
Tapu Shaikh | Tapu Shaikh | ||
- | \\ | ||
==== Keywords ==== | ==== Keywords ==== | ||
+ | |||
Category 1:: APPLICATIONS | Category 1:: APPLICATIONS | ||
- | \\ | ||
==== Files ==== | ==== Files ==== | ||
+ | |||
sphire/ | sphire/ | ||
- | \\ | ||
==== See also ==== | ==== See also ==== | ||
- | \\ | ||
==== Maturity ==== | ==== Maturity ==== | ||
+ | |||
Beta:: Under evaluation and testing. Please let us know if there are any bugs. | Beta:: Under evaluation and testing. Please let us know if there are any bugs. | ||
- | \\ | ||
==== Bugs ==== | ==== Bugs ==== | ||
- | \\ | ||