Skip to main content

Plugin to use motioncor programs within the Scipion framework

Project description

This plugin allows to use motioncor3 program within the Scipion framework.

Motioncor3 is a GPU-accelerated program for correction of electron beam-induced sample motion. It is developed by Shawn Zheng.

PyPI release License Supported Python versions SonarCloud quality gate Downloads

IMPORTANT!

  1. If you have imported movies with a gain file in DM4 format, you need to flip the gain reference upside-down in the motioncor protocol! (see details)

  2. When importing EER movies, you should specify dose per single EER frame during import step.

  3. When importing EER tilt-series movies, you should specify dose per tilt during import step. It is not relevant for motion-correction (no dose-weighting is done here), but will be used later on.

  4. If you are processing EER movies and providing *.gain reference file camera defects will be automatically extracted from the gain file header and converted to Motioncor format. This step is omitted if you provide a defects file yourself.

Installation

You will need to use 3.0+ version of Scipion to be able to run these protocols. To install the plugin, you have two options:

  1. Stable version

scipion installp -p scipion-em-motioncorr
  1. Developer’s version

    • download repository

    git clone -b devel https://github.com/scipion-em/scipion-em-motioncorr.git
    • install

    scipion installp -p /path/to/scipion-em-motioncorr --devel

Important: Starting from plugin v3.15, the config variables have been renamed. See: scipion3 config -p motioncorr

  • Motioncor binaries will be installed automatically with the plugin, but you can also link an existing installation.

  • Default installation path assumed is software/em/motioncor3-1.1.2, if you want to change it, set MOTIONCOR_HOME in scipion.conf file to the folder where the Motioncor3 is installed.

  • Depending on your CUDA version this plugin will guess the right default binary from MotionCor3_1.1.2_CudaXY_06-11-2024 (X is for cuda major version, Y for the minor). You can always set a different one by explicitly setting MOTIONCOR_BIN variable.

  • If you need to use CUDA different from the one used during Scipion installation (defined by CUDA_LIB), you can add MOTIONCOR_CUDA_LIB variable to the config file. Various binaries can be downloaded from the official UCSF website.

For an automatically updated installation of motioncor binaries, do not define neither MOTIONCOR_HOME nor MOTIONCOR_BIN.

To check the installation, simply run the following Scipion tests:

scipion test motioncorr.tests.test_protocols_motioncor.TestMotioncorAlignMovies
scipion test motioncorr.tests.test_protocols_tomo.TestMotioncorTiltSeriesAlignMovies

Licensing

Motioncor3 is provided under BSD-3-Clause license

Supported versions

  • motioncor3 1.0.1, 1.1.1, 1.1.2

  • motioncor2 1.6.4

Protocols

  • movie alignment

  • align tilt-series movies

References

  1. Shawn Q Zheng, Eugene Palovcak, Jean-Paul Armache, Kliment A Verba, Yifan Cheng & David A Agard. MotionCor2: anisotropic correction of beam-induced motion for improved cryo-electron microscopy. Nature Methods volume 14, pages 331–332 (2017).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scipion-em-motioncorr-3.16.7.tar.gz (42.1 kB view details)

Uploaded Source

Built Distribution

scipion_em_motioncorr-3.16.7-py3-none-any.whl (47.9 kB view details)

Uploaded Python 3

File details

Details for the file scipion-em-motioncorr-3.16.7.tar.gz.

File metadata

File hashes

Hashes for scipion-em-motioncorr-3.16.7.tar.gz
Algorithm Hash digest
SHA256 3de02616bbafdee219d95e6b42d814501ae9ae9b5039cf023d156a53a848641f
MD5 252e945a2dc85e5935ddec1033690668
BLAKE2b-256 47865b0b2ae808d030df48e16ed0e7400e6dc76c5d96143f4df4419f4ccbd106

See more details on using hashes here.

File details

Details for the file scipion_em_motioncorr-3.16.7-py3-none-any.whl.

File metadata

File hashes

Hashes for scipion_em_motioncorr-3.16.7-py3-none-any.whl
Algorithm Hash digest
SHA256 7a0f1500350a6c7e028094a10223154b10fff5a94003c50dad9c00071d71bd13
MD5 cc121ba32608a13dceb461d4506761af
BLAKE2b-256 bde0fd2ab7ab1bc818fddc2279d9fd966aee2d355adf75a4e9f1b473814205d7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page