Skip to content

kylelmorris/localrec_control

Repository files navigation

Localised reconstruction control framework

Description

Python and shell scripts for initial stages and control of localised reconstruction for sub-particle extraction in single particle cryo electron microscopy.

These scripts provide a framework controlling relion_localized_reconstruction.py.

Motivation

These scripts are designed to control Localised Reconstruction (LocalRec, as described in Ilca 2015). They were developed with a view to extract subparticles from C1 reconstructions of truly pseudo-symmetric complexes. Certain pseudo-symmetric complexes approximately follow the symmetry groups used in cryo-EM refinement. In these cases the repeating unit of the complex that is to be refined lies on a symmetry axis, and so can be refined using standard symmetry imposed refinements or using LocalRec and the symmetry group that describes the subparticle locations fully. Other methods exist that also deal with these cases (Relion symmetry expansion). However, certain truly pseudo-symmetric complexes may contain some of the repeating subparticles lying off-symmetry-axis. In these cases the subparticle does not conform to any symmetry group and is truly pseudo-symmetric, sometimes referred described as having local symmetry.

In these cases it was found that a C1 refinement of the truly pseudo-symmetric complex could be obtained and subsequently LocalRec used to localise and extract the repeating subparticles in asymmetric space. This can account for the local non-symmetric locations of repeating substructures in a pseudo-symmetric complex. The subparticles can then be combined into a single refinement to determine the structure of the pseudo-symmetric substructure.

Prerequisites

A single particle data set already refined in Relion in C1.

relion_localized_reconstruction.py should first be installed, with its dependancies including:

Relion-1.4
Scipion
Associated python libraries

Brief protocol

  1. Determine your structure in C1 using Relion
  2. Fit a PDB into every repeating subparticle that you wish to extract, this can be any number, the more the better!
  3. Get organised, set up the following directory structure:
./map/run_class001.mrc
./PDB/substructure1.pdb	# Subparticle 1
./PDB/substructure2.pdb # Subparticle 2
./PDB/substructure3.pdb	# Subparticle 3
  1. Run localrec_create_cmm.sh, this will create a new directory (cmm_markers) using UCSF Chimera. These vectors describe the location of each subparticle in the C1 map
  2. Get more organised, add the following directories:
./star/run_data.star	# This is the star file from the C1 refinement (relion1.4 format required)
./Extract		# Symbolic link to the Extract directory containing the particles that were used in the C1 refinement
  1. Edit localrec_create_subpartices.sh header to suit your refinement.
  2. Source Relion-1.4
  3. Run localrec_create_subparticles.sh. This will use LocalRec to localise the subparticle of interest in each image and extract it
  4. Run localrec_create_substructures.sh. This will use the LocalRec particles from (8) to reconstruct the subparticle volume
  5. Combine the subparticle star files and perform image processing in the latest version of Relion

Notes for signal subtraction

Coming soon!

Versioning

Authors

  • Kyle Morris, UC Berkeley

License

This project is licensed under the GNU GENERAL PUBLIC LICENSE - see the LICENSE.md file for details

Acknowledgments

  • Juha Huiskonen (University of Helsinki) and Daniel Asarnow (UCSF) for helpful discussion

About

For controlling relion_localized_reconstruction.py

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published