EMAN2 Concepts and Conventions

• Projects, e2desktop.py and the database

• Particle box-size and refinement speed, what size to use

• 3D and 2D Transformations (rotation, translation, etc.)

• Symmetry in EMAN2, and generating projections in an asymmetric unit

• File Formats, Data storage conventions, and the internal database (what is BDB: ?)

• Using EMAN2 in environments with NFS or other network-shared directories

• CTF model used in EMAN2

• More information regarding the aligners

• Parameters/Metadata appearing in EMData attributes (and stored on disk with the image), accessed with get_attr and set_attr

• Parameters/Metadata for applications, not associated with a specific image, stored in bdb:project

Modular functions in EMAN2

Many aspects of EMAN2 are modular, meaning new functions can be easily added for a variety of tasks. These categories are used in the GUI and from the command-line, and are not just useful for programmers. For example, the '--process' option in e2proc2d.py and e2proc3d.py uses 'processors' as defined below.

• Processors - Filters, masks and other basic image processing operations

• Comparators (cmp) - Similarity metrics (cmp) for comparing two images/volumes

• Aligners - Algorithms for aligning one image/volume to another

• Averagers - Methods for averaging many images/volumes together

• Projectors - Generate 2-D projections of 3-D volumes (or 1-D projections of 2-D images)

• Reconstructors - Generate 3-D volumetric reconstructions from sets of 2-D images and orientation paramters

• Analyzers - Perform various analyses on sets of images/volumes

• Symmetries - Permissible symmetries to use in EMAN2

• Orientation Generators (orientgen) - Methods for generating sets of orientations filling an asymmetric unit

Information on specific files used in 3-D single particle refinement

This section documents the contents of all of the files produced by running e2refine.py in one of the refine_xx directories.

• Map projection files (projections_xx, proj_stg1_xx)

• Similarity matrix image files (simmx_xx, simmx_stg1_xx, proj_simmx_xx)

• Classification matrix image files (classify_xx)

• Class-Averaging Results matrix image files (cls_result_xx)

• Class-averages (classes_xx)

• 3-D reconstructions (threed_xx, threed_filt_xx, threed_mask_xx)

Information on specific files used in 2-D reference-free class-averaging

You may also wish to look at /EMAN2/programs/e2refine2d

• input_fp
• input_fp_basis
• input_fp_basis_proj
• classmx_00
• classes_init
• allrefs_XX
• basis_XX
• aliref_XX
• simmx_XX
• input_XX_proj
• classmx_XX
• classes_XX