Differences between revisions 43 and 44
Revision 43 as of 2008-12-17 15:56:19
Size: 9348
Comment:
Revision 44 as of 2009-01-12 20:07:01
Size: 10266
Comment:
Deletions are marked like this. Additions are marked like this.
Line 65: Line 65:
|| str(class number) || list of integers || The indexes of particles that went into each class. Generated by e2classaverage if correct command line arguments are passed. Used automatically be e2refine and accessed by e2eulerxplor || || str (class number) || list of integers || The indexes of particles that went into each class. Generated by e2classaverage if correct command line arguments are passed. Used automatically be e2refine and accessed by e2eulerxplor ||

==== e2refine.args ====

This database is read and written by e2workflow.py for the purpose of supervising the execution of e2refine.py, and recalling previously used parameters for the user's convenience.

|| classalign || string || The aligner used for alignment during iterative class averaging ||
|| classaligncmp|| string || Comparator used by the main aligner during iterative class averaging ||
|| classcmp || string || The main comparator used to quality and exclude bad particles in iterative class averaging ||
|| classiter || int || The number of class averaging iterations ||
|| classkeep|| float || The keep threshold used for excluding bad particles in iterative class averaging ||
|| classnormproc|| string:args || The normalization processors used in class averaging ||
|| || || ||
|| || || ||
|| || || ||
|| || || ||
|| || || ||
|| || || ||
|| || || ||
|| || || ||
|| || || ||

Parameters/Metadata for applications stored in the project

These are metadata parameters associated with a 'Project', like a single particle reconstruction, and may be application specific or global. If an application wishes to make parameters available for other applications to see, it should put them in 'bdb:project' in the local directory and name them as described below. Documentation for application specific parameters not really intended for use by other applications appears here as well. This does NOT document parameters stored in the header of individual images, though we strive to use the same names whereever possible.

These parameters can be found in bdb:project

Parameters starting with 'global.' are those which could be used equally by any application, other applications wishing to publish parameters for use by others should prefix them with 'appname.'

global.apix

float

Default A/pix value for a project

global.microscope_voltage

float

Default microscope voltage in kV for a project

global.microscope_cs

float

Default microscope Cs in mm for a project

global.micrograph_ccd_filenames

list of strings

All micrograph and/or CCD data file names that are associated with a project

global.num_cpus

int

Number of cpus available to this project

global.memory_available

int

Maximum memory usage for this project

workflow.process_ids

list of ints

A list of process ids that is managed by the workflow system

These parameters are application specific and subject to change

Dictionary names should begin with the application name, the contents of each dictionary can be freely defined by the application.

e2ctf.parms

filename

EMAN2Ctf object

An EMAN2Ctf object associated with each filename (without extension)

e2ctf.misc

envelope

list of (x,y) tuples

Computed Envelope*StrucFact curve from CTF maxima from all sets processed during one run

working_ac

float

Amplitude contrast constant used to launch e2ctf from within the project/workflow setting

working_oversamp

float

Oversample factor used to launch e2ctf from within the project/workflow setting

e2boxer.project

working_boxsize

int

The box size that is used to launch e2boxer from within the project/workflow setting

output_boxsize

int

The last box size that was used for generating output using e2boxer. Currently only set from within the workflow setting.

e2boxer.cache

This is the cache associated with e2boxer.py.

filename_DD

Python dictionary

Image Database Dictionary

filename_DD.auto_boxer_state_TS

string

Greenwich Mean time stamp of the associated Autoboxer when it was last used to autobox this image. This information can be used to force reboxing if the associated autoboxer has been updated

filename_DD.auto_boxer_unique_id

string

stores the unique ID of an associated Autoboxer instance which is also stored in the boxer_cache database

filename_DD.auto_boxes

boxertools.TrimBox list

stores the current set of automatically selected boxes by the associated Autoboxer instance

filename_DD.coarse_flat_image

EMData

stores the image generated by the boxertools.CoarsenedFlattenedImage object that is associated with this image

filename_DD.frozen_state

boolean

indicates whether or not the image is frozen. If the image is frozen then no changes can be made to the currently associated boxes

filename_DD.image_tag

string

Stores the original name of the image

filename_DD.manual_boxes

boxertools.TrimBox list

stores boxes that have been manually placed in this image

filename_DD.moved_boxes

Python list of 2D coordinates

effectively a memorization of all the box movements enforced by the user. Can be used to perform collision detection and automatically correct the results of automatic boxing

filename_DD.quality

integer [0-4]

in the special case of the quality being equal to zero this means the image is excluded from boxing and that no boxes should ever be generated for it. Otherwise this is just metadata that may be acted upon autonomously by the user

filename_DD.reference_boxes

boxertools.TrimBox list

stores the reference boxes located in this image that are also being used by the associated Autoboxer instance

filename_DD.template_ts

string

Greenwich Mean time stamp that records when the associated template (that was used to generate the correlation image, which is potentially stored in the database also) was created

autoboxer_ts

Python dictionary

the key here is literally the string "autobxer_" followed the a unique time stamp as a string. This dictionary object stores the essential parameters of a an Autoboxer instance

autoboxer_ts.autoboxer

boxertools.AutoBoxer or boxertools.TrimAutoBoxer

the Autoboxer instance itself (or similar)

autoboxer_ts.autoboxer_type

string

this is the unique associated with the Autoboxer type, for example "Swarm" or "Gauss"

autoboxer_ts.convenience_name

string

the user may optionally supply a convenience name for this autoboxer in the e2boxer interface, otherwise the name is generated automatically

current_autoboxer

boxertools.AutoBoxer or boxertools.TrimAutoBoxer

the most recently use Autoboxer instance

current_autoboxer_type

string

the type of the most recently used Autoboxer instance. This should become deprecated.

e2classaverage.indices

str (class number)

list of integers

The indexes of particles that went into each class. Generated by e2classaverage if correct command line arguments are passed. Used automatically be e2refine and accessed by e2eulerxplor

e2refine.args

This database is read and written by e2workflow.py for the purpose of supervising the execution of e2refine.py, and recalling previously used parameters for the user's convenience.

classalign

string

The aligner used for alignment during iterative class averaging

classaligncmp

string

Comparator used by the main aligner during iterative class averaging

classcmp

string

The main comparator used to quality and exclude bad particles in iterative class averaging

classiter

int

The number of class averaging iterations

classkeep

float

The keep threshold used for excluding bad particles in iterative class averaging

classnormproc

string:args

The normalization processors used in class averaging

These parameters can be found in bdb:raw_data#

The raw_directory is used by e2workflow.py for storing imported micrograph/CCD data. The image file tag (e.g. the file tag of /home/somewhere/something.mrc is "something") may be used to access the image, for example

   1 a = EMData("bdb:raw_data#something",0)
   2 b = EMData()
   3 b.read_image("bdb:raw_data#something",0)

These parameters can be found in bdb:particles#

The short story is e2boxer stores particles in this directory, it uses a naming convention where "_ptcls" is appended to the end of the input image names.

e2ctf stores particles in this directory and appends "_ctf_flip" or "_ctf_wiener", depending whether the output data are phase flipped or Wiener filtered.

The longer story is - The particles directory is used by e2ctf, e2boxer and e2workflow for storing boxed particle data that has optionally been filtered. In general e2boxer will be the first program that stores data here, and it can be done in a number of ways. People can save directly to the particles directory from e2boxer using the 'write box particle images' button (name may be different) and by making sure the output format is 'bdb'. e2boxer can also be used from the command line for writing output (output format is a command line argument). This is precisely what occurs from the context of e2workflow, which spawns output writing processes using e2boxer.

Note that a naming convention is employed by e2boxer - if the input image names is something.mrc or "bdb:raw_data#something" then the output particles will be written using the filename "something_ptcls". You can access these images from Python using any of these approaches:

   1 a = EMData.read_images("bdb:raw_data#something_ptcls",[])
   2 n = EMUtil.get_image_count("bdb:raw_data#something_ptcls")
   3 images = []
   4 for i in range(n):
   5     images.append(EMData("bdb:raw_data#something_ptcls",i))

e2ctf will also store filtered particle images in the this directory, and these will be either phase flipped or Wiener filtered. Note that the Wiener filtered data are also phase flipped. These particles are stored in the database with "_ctf_flip" and "_ctf_wiener" appended to the input file names, respectively.

These parameters can be found in bdb:e2boxercache#

The e2boxercache directory has many dedicated particle stacks in it. The currently existing stacks are listed in this table

exclusion_image

A binary exclusion image, in shrunken image coordinates

image_thumb

A thumbnail of the image

subsampled_image

A subsampled version of the image generated by the Gauss mode - Sparx group please add details

coarse_flat_image

A coarsened version of the image that has its background flattened

coarse_sigma_image

A specialized image that stores the inverse of the local pixel standard deviation - should probably called inverse_sigma_image - this image is in shrunken image coordinates and is used to normalize the correlation image (Roseman). Note that pixels representing 0 standard deviation are left unchanged

flcf_image

Locally normalized correlation image (Roseman, Ultramicroscopy)

see also the e2boxer.cache database.

Eman2AppMetadata (last edited 2013-08-11 18:07:28 by SteveLudtke)