Skip to main content

Plugin to use cryoSPARC2 programs within the Scipion framework

Project description

cryoSPARC2 plugin

This plugin allows to use cryoSPARC2 programs within the Scipion framework

CryoSPARC is a backend and frontend software system that provides data processing and image analysis capabilities for single particle cryo-EM, along with a browser based user interface and command line tools.

You will need to use 3.0.0 version of Scipion to run these protocols.

  • 2D Classification: Classify particles into multiple 2D classes to facilitate stack cleaning and removal of junk particles. Also useful as a sanity check to investigate particle quality.

  • 3D Ab-Initio Reconstruction: Reconstruct a single (homogeneous) or multiple (heterogeneous) 3-D maps from a set of particles, without any initial models or starting structures required.

  • 3D Homogeneous Refinement: Rapidly refine a single homogeneous structure to high-resolution and validate using the gold-standard FSC.

  • 3D Non uniform Refinement: Apply non-uniform refinement to acheive higher resolution and map quality

  • Particle Subtraction: Subtract projections of a masked volume from particles.

  • 3D Local Refinement Naive local refinement.

  • Heterogeneous Refinement: Heterogeneous Refinement simultaneously classifies particles and refines structures from n initial structures, usually obtained following an Ab-Initio Reconstruction

  • Local CTF Refinement (per-particle defocus): Local CTF Refinement performs per-particle defocus estimation for each particle in a dataset, against a given 3D reference structure.

  • Global CTF Refinement (per-group beam tilt, trefoil, spherical aberration, tetrafoil): Global CTF Refinement performs per-exposure-group CTF parameter refinement of higher-order aberrations, against a given 3D reference.

  • Sharppening: Sharpen a volume following refinement.

  • Helical 3D Refinement: Reconstruct and refine a homogeneous helical assembly, with or without imposition and refinement of symmetry parameters.

  • 3D Homogeneous Refinement(new): Rapidly refine a single homogeneous structure to high-resolution and validate using the gold-standard FSC. Using new faster GPU code, and support for higher-order aberration (beam tilt, spherical aberration, trefoil, tetrafoil) correction and per-particle defocus refinement on the fly.

  • 3D Non uniform Refinement(new): Apply non-uniform refinement to achieve higher resolution and map quality. Specially designed for small proteins and membrane proteins.

  • 3D Local Refinement(new) Refine a masked region within a consensus structure by allowing particle alignments to vary only slightly.

  • Symmetry Expansion: Duplicate particles around a point-group symmetry.

  • Homogeneous Reconstruction: Reconstruct half-maps from input particles with alignments

  • 3D Classification: Classify particles into multiple 3D classes and optimize 3D class densities (currently, without re-aligning particle pose or shift).

Latest plugin versions

v3.3.15

  • new : Compatibility with cryoSPARC v3.3.2

v3.3.14

  • new : Added the option to use the plugin in a CS installation in a cluster

  • new : Added a wizard to select the lane where the protocols will be launched

  • new : Added the varaiable CRYOSPARC_DEFAULT_LANE to define the name of the cryoSPARC default lane

  • new : Added the variable CRYOSPARC_STANDALONE_INSTALLATION to specify whether the CS installation is standalone or not

v3.3.13

  • new : Compatibility with cryoSPARC v3.3.1

  • new : Added a new 3D Classification protocol

  • new : Added Homogeneous Reconstruction protocol

  • new : Anisotropic magnification can now be estimated during Global CTF refinement, and is corrected for in Refinement, Reconstruction, 3D Classification protocols

  • updated : Improving performance when generating the outputs(use of emtable library to read star file)

  • fixed : Fixed the FSC calculation in some protocols

  • updated : Modifying Refinements viewer

Installing the plugin

In order to install the plugin follow these instructions:

  1. Install the plugin

scipion installp -p scipion-em-cryosparc2

or through the plugin manager by launching Scipion and following Configuration >> Plugins

  1. Install CryoSPARC software

CryoSPARC v2 software will NOT be installed automatically with the plugin. The independent installation of CryoSPARC software suite by the user is required before running the programs.

To install CryoSPARC v2 software review the detailed system requirements and install instructions available here. These cover workstation and cluster installs, file configuration and how to update cryoSPARC v2 when new versions become available.

  1. Add the following variables bellow the PACKAGES section at ~/.config/scipion/scipion.conf file:

    # The root directory where cryoSPARC code and dependencies is installed.
    CRYOSPARC_HOME = <install_path>   (CRYOSPARC_DIR will work for legacy reasons)
    
    # full name of the initial admin account to be created
    CRYOSPARC_USER = <user_name>
    
    # Optional variables
    
    #Folder (available to all workers) where scipion will create cryosparc projects
    CRYO_PROJECTS_DIR = <path> (default to <CRYOSPARC_HOME>/scipion_projects)
    
    # Specifies whether the CS installation is standalone or not. If False,
    # it is assumed that CS is installed in a cluster. If the variable is not
    # defined, by default assume that the installation is standalone and its
    # value would be True
    CRYOSPARC_STANDALONE_INSTALLATION = <True or False>
    
    # Name of the default lane where the protocols will be launched
    CRYOSPARC_DEFAULT_LANE = <lane name>

To install in development mode

  • Clone or download the plugin repository

git clone https://github.com/scipion-em/scipion-em-cryosparc2.git
  • Install the plugin in developer mode.

scipion installp -p local/path/to/scipion-em-cryosparc2 --devel

Buildbot status

Status devel version:

http://scipion-test.cnb.csic.es:9980/badges/cryosparc2_devel.svg

Status production version:

http://scipion-test.cnb.csic.es:9980/badges/cryosparc2_prod.svg

Project details


Release history Release notifications | RSS feed

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-cryosparc2-3.3.15.tar.gz (114.6 kB view details)

Uploaded Source

File details

Details for the file scipion-em-cryosparc2-3.3.15.tar.gz.

File metadata

File hashes

Hashes for scipion-em-cryosparc2-3.3.15.tar.gz
Algorithm Hash digest
SHA256 3161ac8679a60534e2d2c1105254415a000e57a45f5ed9b920ee1ee03e428cb9
MD5 a05b46c98498ecb7648110313e3817fe
BLAKE2b-256 a6d9c88d441d1cc96df5911b0216e75595b7d737ecdacfb72badf4377a92cf96

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