Job: Import Micrographs
Last updated
Last updated
Import one or more micrographs into CryoSPARC for processing.
The Import Micrographs job imports single-frame micrographs into CryoSPARC for downstream processing. Typically, these micrographs will have been pre-processed through motion correction tools outside of CryoSPARC, or come from a camera that does was imaging single frames rather than movies.
Importantly, the micrograph files that are imported by this job are not copied — they are merely linked (via a symbolic link) into the CryoSPARC project directory where this job is running. It is thus critical that the micrograph files are not deleted or moved while they are being processed in CryoSPARC.
The Import Micrographs job accepts an optional input of movies (e.g., from an Import Movies job). This links the micrographs (and therefore, particles extracted from the micrographs) to their source movies, which allows for workflows that require movies such as Reference Based Motion Correction. Thus, although this input is optional, we recommend connecting the movies if they are available.
Imported movies from an Import Movies job. If jobs which require movies (such as ) will be used later, this input should be connected so that resulting particles are properly linked to their movies. See the for more information.
The absolute path to the micrographs to import (in MRC format). Wildcards can be used to select multiple micrographs.
Raw pixel size and Total exposure dose are typically selected during data collection, while Accelerating voltage and Spherical aberration are properties of the microscope. It is best to specify these properties if they are known. Note that the pixel size of the micrographs may not be the physical detector pixel size if the original movies were downsampled during motion correction or if they were collected in a super-resolution mode.
If Negative Stain Data is on, this indicates that there are light particles on dark background (-1). If it's off, this indicates the micrographs have dark particles on light background (cryo-em data, +1).
Turned on by default in v4.2+, off by default in prior versions.
When Skip header check is turned off, each micrograph file's header is read by the job to ensure that all micrographs are of the same size in pixels and physical extent. The header check helps to detect corrupt files which otherwise may cause errors in downstream jobs, but also can take a long time due to the number of file system operations needed to read the headers.
When this parameter is turned off (i.e., when the header check is used), set the Number of CPUs to parallelize during header check parameter to parallelize reading of exposure headers.
The imported micrographs are ready for further processing.
If Skip Header Check is off, micrographs with an inconsistent size are output here and are typically not used in downstream processing.
In the scenario where you want to link your micrographs to a movie dataset that is already in CryoSPARC, you can connect the movies to the inputs of this job.
Since CryoSPARC does not know how the micrograph names correspond to movie names, you will have to help the job connect the correct movie and micrograph. Most motion correction packages add characters to the beginning and/or end of a filename, but leave some identifying region in the middle of the filename unchanged. The Import Micrographs job thus provides four parameters, each of which accepts a number telling the job how many characters to trim from the beginning and end of the micrograph and movie filenames to be left with this identifying region.
Consider the following case:
In these lines from the Import Micrographs job log, we see that the movies have a unique ID (twenty-one numbers) added to the front, and they end in .tif. The micrographs also have a (different) twenty-one character ID, but end in _background.mrc. We therefore need to cut twenty-one characters off the front of both the movies and the micrographs, four characters off the end of the movies, and fifteen characters off the end of the movies.
The parameters for the job should therefore be:
Now the imported micrographs will be linked to the movies in CryoSPARC, allowing you to come back to preprocessing steps easily.
These parameters are used to properly link micrographs to their input movies. See the section for help setting these parameters.
Imported micrographs are typically taken into a job to estimate their contrast transfer function parameters.
