Notes:
The main documentation for e2refinetorelion3d.py can be found here
- This tutorial is designed with the assumption that the user has fully completed an EMAN2 refinement. This program draws from many files in the EMAN2 directory structure and was designed to rely on these files existing.
e2refinetorelion3d Tutorial
Getting Started
The first thing to do after you've run an EMAN2 reconstruction is to open up the Project Manager:
e2projectmanager.py
Once you open up the project manager, select the plus (+) next to the 3D refinement tab and you will see several new options appear. The option we want to select is the "Relion 3D Refinement" option.
This opens up three tabs in the viewing window: GUI, Command, and Help. 'GUI' contains the options for e2refinetorelion3d.py, 'Command' is the command that will be executed when the user launches the program, and 'Help' is the help text associated with e2refinetorelion3d.py. Along the right side, you will see 7 option buttons with various shapes. (More information about the project manager can be found here) The Three buttons that are directly impacted by this program are:
The Wiki Button. This button will open the wiki page for e2refinetorelion3d.py
The Wizard Button. This button will open up a step-by-step wizard for new users. It will lead you through entering the program options one at a time with help information.
The Expert Button. This button opens up more options in the GUI that are optional and for more expert users.
In the 'GUI' window, there are several sections of options. The first set options you will see are the I/O options.
I/O Options
set_name: This is the name of the particle set that will be used as input to Relion. By clicking 'Browse', you will open the EMAN2 browser and be able select the set by browsing to it.
refmap: This is the 3D map that will be used as a reference map by Relion. It should have the same dimensions as your particles. Typically you should use an EMAN2 completed reconstruction as input.
randomizemodel: This is an option that can be used to randomize the phases of the initial model to a particular resolution (In Angstroms)
greyscale: Is the reference map on greyscale?
symmgroup: What symmetry group does the particle belong to? Options are C,D, T, O, and I.
symmnumber: What symmetry number does this particle have?
Once you have these options entered, you can move further down to the CTF options section.
CTF Options
There are three boolean options in this section. Check the ctfcorrect box if you want Relion to perform CTF correction on the particles. The second box, dataphaseflipped, should be checked if your data has been phase flipped already. The final option, ignoretofirstpeak, should be checked if you want CTF-amplitude correction to be performed from the first peak onward.
Optimisation Options
Two important (and required) options are in this section as well as another optional input. lowpass is the value to which Relion will lowpass filter the reference map. If set to 0, Relion will perform no lowpass filtering on the reference map. particle_mask_diameter is the diameter of a soft circular mask that Relion will apply to your particles. If you specify a diameter too large, you will include a lot of noise from outside the particle. If you use a value too small, you run the risk of masking out part of the particle. The final option in this section is the solventmask. If you wish to provide a Spider/mrc map containing a (soft) mask with the same dimensions as the reference(s), and values between 0 and 1, with 1 being 100% protein and 0 being 100% solvent, the reconstructed reference map will be multiplied by this mask.
Sampling Options
In this section there are four options. These options represent the initial values for these parameters and they will be auto-incremented by Relion as the map converges. healpix is the angular sampling value whereas auto_healpix is the local search value from auto-sampling. The offsetrange is the value at which probabilities will be calculated only for translations in a circle with this radius (in pixels). The center of this circle changes at every iteration and is placed at the optimal translation for each image in the previous iteration. Finally, the offsetstep is the value for which translations will be sampled with this step-size (in pixels).
Run Options
There are only two options in this section. The first is the number of threads that you wish Relion to use. The second is the maximum amount of memory (maxmemory) that each thread will use when it is initiated.
Expert Options
This section has options that are only useful in certain circumstances. Sometimes they can be used to improve reconstructions, but only by users that fully understand what they are doing. The amplitudecontrast option allows the user to specify the amplitude contrast of the micrographs. The intensitycorrection option can be checked if you wish to perform intensity-scale correction on image groups. print_symmetry will print all of the symmetry transformation matrices and exit. If you wish to have Relion perform nearest-neighbor instead of linear Fourier-space interpolation, check the box next to nearest_neighbor.