Last update: October 1, 2013.
Before attempting to average subtomograms with EMAN2, make sure to have the latest EMAN2 release. Download the easy-to-install binaries for the "Daily Release" from EMAN2's download page:
http://ncmi.bcm.tmc.edu/ncmi/software/software_details?selected_software=counter_222
(The daily release is close to the middle of the page).
Single Particle Tomography in EMAN2
Unfortunately, SPT is very computationally intensive, both in terms of memory and processing speed. However, illustrative exercises and tutorials can be carried out on a laptop with 2-4GB of RAM. For more realistic SPT on full 3D alignments of large sets (hundreds of particles) comprising large particles (like viruses), 8GB of memory and the use of multiple processing units or GPU technology are advised.
E2SPT USERS' GUIDE
* Single particle tomography USER'S GUIDE (updated summer 2012; under major refactoring due to extensive changes in e2spt capabilities; look for a new and longer version of the tutorial soon).
DATA
Epsilon 15 virus test data, used in the EMAN2 Workshop in 2011.
TRiC chapeornin test data (coming soon).
Note that the EMAN2 Project Manager, launched through e2projectmanager.py, provides a full pipeline for SPT (particle selection, preprocessing, alignment and averaging) via iterative refinement. However, other additional alignment, processing and analysis tools are available from the command line.
COMMANDS (for easy "copy-pasting" into the command line; to see the entire list of parameters for each program, type the program name followed by -h at the command line)
CORE PROGRAMS
SPT BOXER
e2spt_boxer.py <tomogram.rec> --yshort --inmemory --lowpass=100
.
SPT Iterative refinement
Command for alignment with e2spt_classaverage.py (used to be e2classaverage3d.py)
e2spt_classaverage.py --input= --output= --ref= --npeakstorefine=14 -v 0 --mask=mask.sharp:outer_radius= --lowpass=filter.lowpass.gauss:cutoff_freq=.02:apix=4.401 --parallel=thread:2 --highpass=filter.highpass.gauss:cutoff_freq=0.002:apix=4.401 --averager=mean.tomo --aligncmp=ccc.tomo --raligncmp=ccc.tomo --shrink=3 --shrinkrefine=2 --savesteps --saveali --iter=24 --normproc=normalize --keep=0.8 --path= --align=rotate_translate_3d:search=10:delta=8:dphi=8:verbose=0:sym=icos --ralign=refine_3d_grid:delta=3:range=9:search=2
.
SPT "all vs all"
Command for alignment with e2spt_hac.py (used to be e2tomoallvsall.py)
e2spt_hac.py -v 0 --path=AVSA --input= --shrink=3 --shrinkrefine=2 --iter= --mask=mask.sharp:outer_radius= --npeakstorefine= --lowpass=filter.lowpass.gauss:cutoff_freq=.02:apix=4.401 --highpass=filter.highpass.gauss:cutoff_freq=0.002:apix=4.401 --parallel=thread:24 --averager=mean.tomo --aligncmp=ccc.tomo --raligncmp=ccc.tomo --saveali --savesteps --postprocess=filter.lowpass.gauss:cutoff_freq=.02:apix=4.401 --autocenter --plotccc --exclusive_class_min=8 --normproc=normalize --align=rotate_translate_3d:search=4:dphi=12:delta=12 --ralign=refine_3d_grid:delta=3:range=12:search=2
.
OTHER programs (use at your own risk; some parameters in these programs are under experimental development. Tun the program at the command line followed by -h to see current available parameters for each program)
Command for e2spt_resolutionplot.py
e2spt_resolutionplot.py --vol1=half1avg.hdf --vol2=half2avg.hdf --output=whatever3.txt --npeakstorefine=1 --verbose=0 --shrink=3 --shrinkrefine=2 --mask=mask.sharp:outer_radius=36 --lowpass=filter.lowpass.gauss:cutoff_freq=.02:apix=4.401 --align=rotate_translate_3d:search=4:dphi=30:delta=30:sym=icos --parallel=thread:8 --ralign=refine_3d_grid:delta=15:range=30:search=2 --aligncmp=ccc.tomo --raligncmp=ccc.tomo --normproc=normalize --sym=icos
Command for e2spt_rotationalplot.py
e2spt_rotationalplot.py --input=initModel.hdf --output=toAs129avsaAVG.txt --daz=1 --shrink=1 --dalt=180 --mask=mask.sharp:outer_radius=28
Command for e2spt_radialdensityplot.py
e2spt_radialdensityplot.py --vols=volA_aligned.hdf,volB_aligned.hdf --normproc=normalize.edgemean --lowpass=filter.lowpass.gauss:cutoff_freq=0.02:apix=4.401 --singleplot --output=volAali_VS_volBali.png
Command for e2spt_simulation.py (used to be e2tomosim.py)
e2spt_simulation.py --input=groel.pdb --snr=5 --nptcls=8 --tiltstep=5 --tiltrange=60 --transrange=10 --saveprjs --addnoise --simref --path=TESTsimREF --pad=3 --shrink=2 --finalboxsize=96 --negativecontrast
Command for e2spt_tomosimjobs.py
e2spt_tomosimjobs.py --input=groel.pdb --nptcls=8 --saveprjs --addnoise --simref --path=TESTsimREF --pad=3 --shrink=2 --finalboxsize=96 --snrlowerlimit=0 --snrupperlimit=1 --snrchange=1 --tiltsteplowerlimit=0 --tiltstepupperlimit=1 --tiltstepchange=1 --tiltrangelowerlimit=60 --tiltrangeupperlimit=61 --tiltrangechange=1 --negativecontrast --testalignment
Command for e2spt_autoboxer.py
e2spt_autoboxer.py --tomogram=tomo_inv.rec --ptclradius=8 --path=whatever --concentrationfactor=1 --output=subtomostack.hdf --outputboxsize=36 --verbose=10 --goldstack=gold_ptcls_s05_inv.hdf --pruneprj --goldthreshtomo --keepn=150 --lowpass=filter.lowpass.gauss:cutoff_freq=0.02
Command for e2symsearch3d.py
e2symsearch3d.py --input= --output= --mask=
Command for e2spt_refinemulti.py
e2spt_refinemulti.py -v 0 --path=RF --input= --nrefs=2 --refgenmethod=binarytree --shrink=3 --shrinkrefine=2 --iter= --mask=mask.sharp:outer_radius= --npeakstorefine= --lowpass=filter.lowpass.gauss:cutoff_freq=.02:apix=4.401 --highpass=filter.highpass.gauss:cutoff_freq=0.002:apix=4.401 --parallel=thread:24 --averager=mean.tomo --aligncmp=ccc.tomo --raligncmp=ccc.tomo --saveali --savesteps --normproc=normalize --radius=150
Command for e2spt_fftamps.py
e2spt_fftamps.py --input=file.hdf