Content-type: text/html Manpage of prepareFairRef

prepareFairRef

Section: Misc. Reference Manual Pages ((experimental))
Updated: 1
Index Return to Main Contents
 

NAME

preparFairRef - prepare a initial multi-particle reference  

SYNOPSIS

prepareFairRef file.prm
prepareFairRef file.prm nLevels
prepareFairRef file.prm nLevels level group  

DESCRIPTION

prepareFairRef is an alternative to prepareRef which generates an initial multi-particle reference for the alignment search, using 2^nLevels randomly chosen particles aligned using a binary tree with nLevels. The size of the reference is chosen to allow rotation to match volumes with arbitrary orientations. The parameter file, file.prm, is a MATLAB readable text file that specifies the parameter values in MATLAB syntax. See the PEET man page for a description of the parameter file options and syntax.

Execution of prepareFairRef proceeds in levels 1..nLevels. At level 1, 2^(nLevels - 1) pairs of randomly chosen individual particles (groups) are aligned and combined. At level 2, these pairs are aligned and combined into 2^(nlevels - 2) groups, and and so on, until, at the final level, the last 2 groups are combined yielding a multiparticle reference in which each of the selcted particles is weighted equally.

Alignment searches performed by prepareFairRef follow the same multi-iteration strategy used for the subsequent main alignment search and defined either in the eTomo gui's Iteration Table or (equivalently) in the correspond parameter file values. Because prepareFairRef can be time consuming, parallel execution is highly recommended. Each group can be processed in a separate thread/chunk, with multiple groups executing simultaneously. For parallel execution, include the optional "level" and "group" parameters in each invocation of prepareFairRef. All of the groups [1 .. 2^(nLevels - level)] at a given level should be allowed to complete before invoking any groups from the subsequent level. The eTomo gui handles these details, using parallel processing automatically when multiple cpus are available

PrepareFairRef should result in less initial reference bias and better final averages than when using a single particle reference. We have not yet found datasets on which it yields a significant improvement, however, and the program is considered experimental as a result. If you find cases where it helps significantly, or where it should help but does not (especially if the reason for the lack of improvement is apparent), please contact the developers immediately!  

FILES

Sample parameter files are available in $PARTICLE_DIR/templates.  

AUTHOR

John M. Heumann  

SEE ALSO

PEET(1), prepareRef(1), prmParser(1), prepareEM(1), mergeEM(1), alignSubset(1), averageAll(1), removeDuplicates(1), calcFSC(1), and calcSSNR(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
FILES
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:10:05 GMT, March 20, 2017