Skip to content

scipion-em/scipion-em-miffi

Repository files navigation

Miffi plugin

This plugin provides a wrapper for miffi software tools for automatic micrograph assessment.

Miffi: Cryo-EM micrograph filtering utilizing Fourier space information

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-miffi
  1. Developer's version

    • download repository
    git clone -b devel https://github.com/scipion-em/scipion-em-miffi.git
    
    • install
    scipion installp -p /path/to/scipion-em-miffi --devel
    

miffi software will be installed automatically with the plugin but you can also use an existing installation by providing MIFFI_ENV_ACTIVATION (see below). You also have to download training models separately (see below).

Important: you need to have conda (miniconda3 or anaconda3) pre-installed to use this program.

Configuration variables

CONDA_ACTIVATION_CMD: If undefined, it will rely on conda command being in the PATH (not recommended), which can lead to execution problems mixing scipion python with conda ones. One example of this could can be seen below but depending on your conda version and shell you will need something different: CONDA_ACTIVATION_CMD = eval "$(/extra/miniconda3/bin/conda shell.bash hook)"

MIFFI_ENV_ACTIVATION (default = conda activate miffi-1.0.0): Command to activate the miffi environment.

MIFFI_MODELS (default = software/em/miffi-1.0.0/miffi-models)

Verifying

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

scipion test miffi.tests.test_protocols_miffi.TestMiffi

Supported versions

1.0.0

Protocols

  • categorize micrographs

References

1. Da Xu, Nozomi Ando, Miffi: Improving the accuracy of CNN-based cryo-EM micrograph filtering with fine-tuning and Fourier space information, Journal of Structural Biology, Volume 216, Issue 2, 2024,108072,ISSN 1047-8477,https://doi.org/10.1016/j.jsb.2024.108072.