Daverage

From Dynamo
Revision as of 13:10, 13 October 2017 by Daniel Castaño (talk | contribs)
Jump to navigation Jump to search

daverage is the basic command line option for averaging particles in a data folder using alignment parameters expresed inside a table.


Syntax

The basic syntax of the command is:

 output = daverage('myData','t','myTable.tbl');

where output is an structure recording several items (including of course the density map). If you want to use a linux-like notation, you can produce a left-hand-side output wuth the flag ws (short for workspace), i.e.


 daverage myData -t myTable.tbl -ws output

Input

Data folder

The location of the particles can be passed through:

Table

A regular Dynamo table, than can be passed as file or numeric matrix.

Options

Output

The output structure has several fields.

  • .average_raw:
    without compensation for overweighting of fourier pixels
  • .average:
    with compensation for the fourier overweighting
  • .fweight:
    map of overrrepresentation of fourier components in the output property .average_raw
  • .fmask:
    binary mask denoting available fourier coefficients
  • .variance:
    variance map
  • .fsc:
    fsc values
  • .fsc_labels:
    useful information to annotate fsc plots
  • .tags:
    list of tags that did actually contribute to the averaging procedure. This is useful to control which is the final result of confronting which data is available, which tags are marked in the table, and also which particles where excluded.
  • .nanContributions
    map with the number of particles that contributed a NaN value for each pixel.


Averaging procedure

Rotation and shift

Particles and shifted, then rotated, following the alignment parameters in the table. By convention, positions 4:6 and 7:9 in a the i-th row in a table denote respectively the shifts and rotation parameters that are performed on the template to match the particle in that i-th position (first rotation, then shifting). The shifts and angles that bring the particle to match the template are the ones that parametrize the inverse transform:

shiftsParticle =-myTable(i,4:6);
 eulersParticle =-myTable(i,:7:9);

and the operation can be written as :

rotatadParticle = dynamo_shift_rot(particle, shiftsParticle, eulersParticle);

Corner effects

Rotation causes

Normalization

Particles will be normalized only in the flag for normalization is active. The function internally used to run this normalization is dynamo_normalize_roi.

By default, when daverage is invoked inside a project, a normalization will be performed, using the average and standard deviation on the intensities of the aligned particle inside the alignment mask

NaN compensation

Rotation and shiftings bring into the rotated volume a set of undefined values.

Missing wedge compensation

Missing wedge compensation will be activated whenever the flag fc or fourier_compansate is used.