Name

sxali_vol - align a 3D structure with respect to a 3D reference structure

Usage

Usage in command line:

sxali_vol.py aligned_volume.hdf reference_volume.hdf --ang_scale=3.0 --shift_scale=1.0 --mag_scale=0.01 --r=None

usage in python programming:

ali_vol(aligned_volume, reference_volume, ang_scale=3.0, shift_scale=1.0, radius=None, discrepancy = "ccc")

Both volumes should have 3D transformation preset in respective headers. In particular, they can be set to zero:

Input

aligned_volume.hdf
3D structure to be aligned. The header should contain preset transformation xform.ali3d. The preset values will be used as starting orientation of the structure.
reference_volume.hdf
3D reference structure. The header should contain preset transformation xform.ali3d. The preset values will be used as starting orientation of the structure.
ang_scale
correct angles are expected to be within +/-ang_scale of the values preset in the header of the structure to be aligned (although the program will search further, if necessary).
shift_scale
correct shifts are expected to be within +/-shift_scale of the values preset in the header of the structure to be aligned (although the program will search further, if necessary).
mag_scale
correct magnification is expected to be within +/-mag_scale of the value preset in the header of the structure to be aligned (although the program will search further, if necessary).
r
radius of a spherical mask centered at nx/2, ny/2, nz/2 - the discrepancy is computed only for voxels within this mask (default r=nx/2-2).
  • Note 1 - The program will perform searches only for parameters whose scale values are listed in the command line. For example, to perform search for angles and translations, ang_scale and shift_scale have to be given. To perform search for correct magnification, only mag_scale should be given.

  • Output

    Note chimera will properly read the transformation and orient the volume in the display accordingly.

    In order to apply the transformation, use rot_shift3D.

    Description

    centered region with the radius specified by the user. The program performs local searches using amoeba minimization procedure. It does not guarantee finding globally best orientation, so supplying good initial guess is essential. If no such guess can be provided, it is advisable to start the program using varius initial parameters, particularly the Eulerian angles.

    A template file in python (sparx/templates/search_ali3d.py) allows to start with the best initials orientation of 3D structure to be aligned with sxali_vol and to transform the volume directly with the results.

    Author / Maintainer

    Pawel A. Penczek

    Keywords

    category 1
    APPLICATIONS
    category 2
    SPATIAL

    Files

    applications.py,sxali_vol

    Maturity

    stable
    works for most people, has been tested; test cases/examples available.

    Bugs

    None. It is perfect.

    sxali_vol (last edited 2013-07-24 19:05:08 by penczek)