CryoSPARC Guide
  • About CryoSPARC
  • Current Version
  • Licensing
    • Non-commercial license agreement
  • Setup, Configuration and Management
    • CryoSPARC Architecture and System Requirements
    • CryoSPARC Installation Prerequisites
    • How to Download, Install and Configure
      • Obtaining A License ID
      • Downloading and Installing CryoSPARC
      • CryoSPARC Cluster Integration Script Examples
      • Accessing the CryoSPARC User Interface
    • Deploying CryoSPARC on AWS
      • Performance Benchmarks
    • Using CryoSPARC with Cluster Management Software
    • Software Updates and Patches
    • Management and Monitoring
      • Environment variables
      • (Optional) Hosting CryoSPARC Through a Reverse Proxy
      • cryosparcm reference
      • cryosparcm cli reference
      • cryosparcw reference
    • Software System Guides
      • Guide: Updating to CryoSPARC v4
      • Guide: Installation Testing with cryosparcm test
      • Guide: Verify CryoSPARC Installation with the Extensive Validation Job (v4.3+)
      • Guide: Verify CryoSPARC Installation with the Extensive Workflow (≤v4.2)
      • Guide: Performance Benchmarking (v4.3+)
      • Guide: Download Error Reports
      • Guide: Maintenance Mode and Configurable User Facing Messages
      • Guide: User Management
      • Guide: Multi-user Unix Permissions and Data Access Control
      • Guide: Lane Assignments and Restrictions
      • Guide: Queuing Directly to a GPU
      • Guide: Priority Job Queuing
      • Guide: Configuring Custom Variables for Cluster Job Submission Scripts
      • Guide: SSD Particle Caching in CryoSPARC
      • Guide: Data Management in CryoSPARC (v4.0+)
      • Guide: Data Cleanup (v4.3+)
      • Guide: Reduce Database Size (v4.3+)
      • Guide: Data Management in CryoSPARC (≤v3.3)
      • Guide: CryoSPARC Live Session Data Management
      • Guide: Manipulating .cs Files Created By CryoSPARC
      • Guide: Migrating your CryoSPARC Instance
      • Guide: EMDB-friendly XML file for FSC plots
    • Troubleshooting
  • Application Guide (v4.0+)
    • A Tour of the CryoSPARC Interface
    • Browsing the CryoSPARC Instance
    • Projects, Workspaces and Live Sessions
    • Jobs
    • Job Views: Cards, Tree, and Table
    • Creating and Running Jobs
    • Low Level Results Interface
    • Filters and Sorting
    • View Options
    • Tags
    • Flat vs Hierarchical Navigation
    • File Browser
    • Blueprints
    • Workflows
    • Inspecting Data
    • Managing Jobs
    • Interactive Jobs
    • Upload Local Files
    • Managing Data
    • Downloading and Exporting Data
    • Instance Management
    • Admin Panel
  • Cryo-EM Foundations
    • Image Formation
      • Contrast in Cryo-EM
      • Waves as Vectors
      • Aliasing
  • Expectation Maximization in Cryo-EM
  • Processing Data in cryoSPARC
    • Get Started with CryoSPARC: Introductory Tutorial (v4.0+)
    • Tutorial Videos
    • All Job Types in CryoSPARC
      • Import
        • Job: Import Movies
        • Job: Import Micrographs
        • Job: Import Particle Stack
        • Job: Import 3D Volumes
        • Job: Import Templates
        • Job: Import Result Group
        • Job: Import Beam Shift
      • Motion Correction
        • Job: Patch Motion Correction
        • Job: Full-Frame Motion Correction
        • Job: Local Motion Correction
        • Job: MotionCor2 (Wrapper) (BETA)
        • Job: Reference Based Motion Correction (BETA)
      • CTF Estimation
        • Job: Patch CTF Estimation
        • Job: Patch CTF Extraction
        • Job: CTFFIND4 (Wrapper)
        • Job: Gctf (Wrapper) (Legacy)
      • Exposure Curation
        • Job: Micrograph Denoiser (BETA)
        • Job: Micrograph Junk Detector (BETA)
        • Interactive Job: Manually Curate Exposures
      • Particle Picking
        • Interactive Job: Manual Picker
        • Job: Blob Picker
        • Job: Template Picker
        • Job: Filament Tracer
        • Job: Blob Picker Tuner
        • Interactive Job: Inspect Particle Picks
        • Job: Create Templates
      • Extraction
        • Job: Extract from Micrographs
        • Job: Downsample Particles
        • Job: Restack Particles
      • Deep Picking
        • Guideline for Supervised Particle Picking using Deep Learning Models
        • Deep Network Particle Picker
          • T20S Proteasome: Deep Particle Picking Tutorial
          • Job: Deep Picker Train and Job: Deep Picker Inference
        • Topaz (Bepler, et al)
          • T20S Proteasome: Topaz Particle Picking Tutorial
          • T20S Proteasome: Topaz Micrograph Denoising Tutorial
          • Job: Topaz Train and Job: Topaz Cross Validation
          • Job: Topaz Extract
          • Job: Topaz Denoise
      • Particle Curation
        • Job: 2D Classification
        • Interactive Job: Select 2D Classes
        • Job: Reference Based Auto Select 2D (BETA)
        • Job: Reconstruct 2D Classes
        • Job: Rebalance 2D Classes
        • Job: Class Probability Filter (Legacy)
        • Job: Rebalance Orientations
        • Job: Subset Particles by Statistic
      • 3D Reconstruction
        • Job: Ab-Initio Reconstruction
      • 3D Refinement
        • Job: Homogeneous Refinement
        • Job: Heterogeneous Refinement
        • Job: Non-Uniform Refinement
        • Job: Homogeneous Reconstruction Only
        • Job: Heterogeneous Reconstruction Only
        • Job: Homogeneous Refinement (Legacy)
        • Job: Non-uniform Refinement (Legacy)
      • CTF Refinement
        • Job: Global CTF Refinement
        • Job: Local CTF Refinement
        • Job: Exposure Group Utilities
      • Conformational Variability
        • Job: 3D Variability
        • Job: 3D Variability Display
        • Job: 3D Classification
        • Job: Regroup 3D Classes
        • Job: Reference Based Auto Select 3D (BETA)
        • Job: 3D Flexible Refinement (3DFlex) (BETA)
      • Postprocessing
        • Job: Sharpening Tools
        • Job: DeepEMhancer (Wrapper)
        • Job: Validation (FSC)
        • Job: Local Resolution Estimation
        • Job: Local Filtering
        • Job: ResLog Analysis
        • Job: ThreeDFSC (Wrapper) (Legacy)
      • Local Refinement
        • Job: Local Refinement
        • Job: Particle Subtraction
        • Job: Local Refinement (Legacy)
      • Helical Reconstruction
        • Helical symmetry in CryoSPARC
        • Job: Helical Refinement
        • Job: Symmetry search utility
        • Job: Average Power Spectra
      • Utilities
        • Job: Exposure Sets Tool
        • Job: Exposure Tools
        • Job: Generate Micrograph Thumbnails
        • Job: Cache Particles on SSD
        • Job: Check for Corrupt Particles
        • Job: Particle Sets Tool
        • Job: Reassign Particles to Micrographs
        • Job: Remove Duplicate Particles
        • Job: Symmetry Expansion
        • Job: Volume Tools
        • Job: Volume Alignment Tools
        • Job: Align 3D maps
        • Job: Split Volumes Group
        • Job: Orientation Diagnostics
      • Simulations
        • Job: Simulate Data (GPU)
        • Job: Simulate Data (Legacy)
    • CryoSPARC Tools
    • Data Processing Tutorials
      • Case study: End-to-end processing of a ligand-bound GPCR (EMPIAR-10853)
      • Case Study: DkTx-bound TRPV1 (EMPIAR-10059)
      • Case Study: Pseudosymmetry in TRPV5 and Calmodulin (EMPIAR-10256)
      • Case Study: End-to-end processing of an inactive GPCR (EMPIAR-10668)
      • Case Study: End-to-end processing of encapsulated ferritin (EMPIAR-10716)
      • Case Study: Exploratory data processing by Oliver Clarke
      • Tutorial: Tips for Membrane Protein Structures
      • Tutorial: Common CryoSPARC Plots
      • Tutorial: Negative Stain Data
      • Tutorial: Phase Plate Data
      • Tutorial: EER File Support
      • Tutorial: EPU AFIS Beam Shift Import
      • Tutorial: Patch Motion and Patch CTF
      • Tutorial: Float16 Support
      • Tutorial: Particle Picking Calibration
      • Tutorial: Blob Picker Tuner
      • Tutorial: Helical Processing using EMPIAR-10031 (MAVS)
      • Tutorial: Maximum Box Sizes for Refinement
      • Tutorial: CTF Refinement
      • Tutorial: Ewald Sphere Correction
      • Tutorial: Symmetry Relaxation
      • Tutorial: Orientation Diagnostics
      • Tutorial: BILD files in CryoSPARC v4.4+
      • Tutorial: Mask Creation
      • Case Study: Yeast U4/U6.U5 tri-snRNP
      • Tutorial: 3D Classification
      • Tutorial: 3D Variability Analysis (Part One)
      • Tutorial: 3D Variability Analysis (Part Two)
      • Tutorial: 3D Flexible Refinement
        • Installing 3DFlex Dependencies (v4.1–v4.3)
      • Tutorial: 3D Flex Mesh Preparation
    • Webinar Recordings
  • Real-time processing in cryoSPARC Live
    • About CryoSPARC Live
    • Prerequisites and Compute Resources Setup
    • How to Access cryoSPARC Live
    • UI Overview
    • New Live Session: Start to Finish Guide
    • CryoSPARC Live Tutorial Videos
    • Live Jobs and Session-Level Functions
    • Performance Metrics
    • Managing a CryoSPARC Live Session from the CLI
    • FAQs and Troubleshooting
  • Guides for v3
    • v3 User Interface Guide
      • Dashboard
      • Project and Workspace Management
      • Create and Build Jobs
      • Queue Job, Inspect Job and Other Job Actions
      • View and Download Results
      • Job Relationships
      • Resource Manager
      • User Management
    • Tutorial: Job Builder
    • Get Started with CryoSPARC: Introductory Tutorial (v3)
    • Tutorial: Manually Curate Exposures (v3)
  • Resources
    • Questions and Support
Powered by GitBook
On this page
  • At a Glance
  • Description
  • Inputs
  • Inputs when using volumes groups
  • Inputs when using multiple individual volumes
  • Commonly Adjusted Parameters
  • Update particle alignments
  • Create mask inputs
  • Apply mask to volumes
  • Log rotation matrices, figures, and difference maps
  • Check both chiralities
  • Maximum shift (A)
  • Maximum search angle (degrees)
  • Lowpass filter resolution (A)
  • Outputs
  • Outputs when using volumes groups
  • Outputs when using multiple individual volumes
  • Diagnostic Plots
  • Log messages
  • Difference map
  • FSC
  • References
  1. Processing Data in cryoSPARC
  2. All Job Types in CryoSPARC
  3. Utilities

Job: Align 3D maps

Align two or more 3D maps.

PreviousJob: Volume Alignment ToolsNextJob: Split Volumes Group

Last updated 1 year ago

At a Glance

Align any number of input volumes to a reference volume.

Description

When comparing multiple volumes, it is important to have them in the same register. Align 3D Maps accepts a reference volume and any number of input volumes. It will find, for each input volume, the optimal alignment to the reference volume. Typically, each of the volumes would be distinct maps of the same target as the reference — however, Align 3D Maps performs well as long as the maps are similar.

Because Align 3D Maps can also align particles, it is useful for downstream jobs that require input particles to be in-register. Such downstream jobs include refinements without global pose search (e.g. Local Refinement and 3D Flexible Refinement), 3D Classification, and 3D Variability. If combining particles from multiple classes or from multiple refinement jobs as input to any of these jobs, using Align 3D Maps to place all particles and volumes in-register often improves results.

Note that all maps in the input volume are aligned. For instance, the Volume output of a Homogeneous Refinement typically contains the map, the sharp map, and two half maps. If this Volume is provided to Align 3D Maps, all of those contained maps will be aligned.

Inputs

Reference Map

The input maps will be aligned to this map.

Reference Mask

If this input is provided and Apply mask to volumes is turned on, the reference will be masked before alignment.

Maps to align (volumes group)

Particles (all)

This input is only visible if Update particle alignments is turned on and an input is connected to Maps to align (volumes group)

Particles in this input will have their 3D alignments updated in agreement with their corresponding map. Note that particle images are not used for alignment.

Masks all classes (individual masks)

This input is only visible if Create mask inputs is turned on and an input is connected to Maps to align (volumes group)

This input accepts a number of masks which will be applied to the input volumes group before alignment, if Apply mask to volumes is turned on.

  • If exactly one mask is connected to this input, the mask will be applied to all input volumes before alignment. This may be useful if the input volumes are all aligned to each other, but not to the reference (perhaps aligning the results of a 3D Classification job to another refinement). This will almost certainly produce poor results if the input volumes are not aligned to each other.

  • If more than one mask is connected to this input, then exactly one mask per volume in the volumes group must be connected. For example, if the volumes group contains six volumes, then six individual masks must be added to this input. The masks are applied in order of their addition, i.e., the mask plugged into this input first is applied to the first volume in the group, the mask plugged in second is applied to the second volume in the group, etc.

Inputs when using multiple individual volumes

Reference Map

The input maps will be aligned to this map.

Reference Mask

If this input is provided and Apply mask to volumes is turned on, the reference will be masked before alignment.

Maps to align (individual volumes)

This input accepts one or more individual volumes which will be aligned to the reference.

If this input is connected and a volumes group is subsequently connected to the Maps to align (volumes group) input, the individual volumes will immediately be removed from this input slot.

Particles (map to align, connection N)

These inputs are only visible if Update particle alignments is turned on and inputs are connected to Maps to align (individual volumes)

Particles in this input will have their 3D alignments updated in agreement with their corresponding map. Note that particle images are not used for alignment. A copy of this input is created for each volume connected to Maps to align (individual volumes), with the number N updated to indicate which group the particles will be aligned with.

Note that removing a volume after connecting particles to the inputs does change the other volumes’ numbers but does not change the particle inputs. It is therefore recommended that all volumes are connected before moving on to connect particles.

Mask (map to align, connection N)

These inputs are only visible if Create mask inputs is turned on and if inputs are connected to Maps to align (individual volumes)

The mask plugged into this input will be applied to the indicated volume before alignment, if Apply mask to volumes is turned on. A copy of this input is created for each volume connected to Maps to align (individual volumes), with the number N updated to indicate which group the mask will be applied to and aligned with.

Note that removing a volume after connecting a mask to this input does change the other volumes’ numbers but does not change the mask inputs. It is therefore recommended that all volumes are connected before moving on to connect masks.

Commonly Adjusted Parameters

Update particle alignments

If this parameter is turned on, particle input group(s) will be created as outlined above. Particle poses will be updated to match the new orientation of the volume.

Create mask inputs

If this parameter is on, mask input group(s) will be created as outlined above. If using single volume inputs, masks will be aligned and output along with their corresponding volumes.

Apply mask to volumes

If this parameter is on, masks will be applied to their corresponding volumes before alignment. Note that this controls masking of both the reference and the input volumes — if a mask is connected to the Reference mask input but this parameter is off, the reference will not be masked.

Log rotation matrices, figures, and difference maps

Check both chiralities

If this parameter is on, both chiralities (i.e., both the input version and the “z-flipped” version of the map) of the input maps are checked to find the best alignment in the best hand. If all maps are known to be in the correct hand, this parameter can be turned off to increase the job’s speed.

Maximum shift (A)

Translations only up to this shift are checked. If the maps are significantly out of register, this parameter may need to be increased.

Maximum search angle (degrees)

Rotations only up to this angle are checked. Note that, since angles are checked in all directions, the default value of 180° checks the entire range of possible rotations.

Lowpass filter resolution (A)

Prior to alignment, but after masking, all input maps and the reference map are lowpass filtered to this resolution.

Outputs

Reference Volume

This output contains the unmodified reference volume.

Aligned volumes

This output contains the aligned input volumes. Note that this is a volumes group output.

All particles

This output contains the input particles with poses updated according to their associated volume.

Outputs when using multiple individual volumes

Reference Volume

This output contains the unmodified reference volume.

Aligned volumes

This output contains the aligned input volumes in a Multi Volume Group.

Aligned volume N

This output contains the Nth input volume, aligned to the reference.

Mask aligned N

This output contains the Nth input mask, aligned in the same pose as the Nth volume. This output only exists if Create mask inputs was enabled.

Particles for map N

This output contains the particles belonging to the Nth volume with updated poses.

Diagnostic Plots

Log messages

Each map reports the rotation matrix and 3D translation used to align it to the reference volume. The log also records whether or not the hand of the input map was flipped.

Difference map

Each aligned volume is subtracted from the reference. Slices through this difference volume are plotted. Note that the difference maps are calculated after alignment and lowpass filtering, so their appearance will change depending on the value selected for the lowpass filter.

This plot is useful in assessing the alignment quality, and highlighting domains which may be hampering a successful alignment. Assuming the two volumes are similar, a well-aligned pair of volumes will have most regions of this plot white (for little to no difference between the input map and the reference).

FSC

The Fourier Shell Correlation between each input volume and the reference. Note that this is a between-volumes FSC, not a GSFSC. Thus, the “resolution” of these plots indicates the frequency up to which the two volumes have a correlation of at least 0.143, not necessarily the reliability of either volume at any given resolution.

Well-aligned volumes will have a relatively high FSC up to the applied lowpass filter frequency applied (or the lower of the two volumes’ GSFSC resolutions).

References

  1. Nguyen, T. H. D. et al. Cryo-EM structure of the yeast U4/U6.U5 tri-snRNP at 3.7 Å resolution. Nature 530, 298–302 (2016).

Depending on whether a (new in CryoSPARC v4.5) or several individual volumes are provided as inputs, the form of other input slots change. The input section of this page is therefore divided into two sections, with some shared information in each.

Inputs when using

This input accepts a single containing the volumes to be aligned to the reference. If this input is connected, the job will not accept any inputs to the Maps to align (individual volumes) input.

If this parameter is on, the log will contain the rotation and translation matrices and will produce diagnostic plots (see ).

Depending on whether a (new in CryoSPARC v4.5) or several individual volumes are provided as inputs, the output slots change. The output section of this page is therefore divided into two sections, with some shared information in each.

Outputs when using

volumes group
volumes groups
volumes group
volumes group
volumes groups
Outputs
Maps generated using data from EMPIAR 10073 (Nguyen et al. 2016).