Skip to content

Angular_distance

Jump to bottom
Adrian Quintana edited this page Dec 11, 2017 · 1 revision

Angular distance

Purpose

This program computes the angular distance between two angle files. The angular distance is defined as the average angular distance between the 3 vectors of the coordinate system defined by the Euler angles (taking into account any possible symmetry).

If an output[rootname] is provided, the following files are created:

  • [root]_merge.txt This file shows the alignment parameters in both files and their difference. The parameterang_dist is the corresponding average distance between the vectors defining coordinate systems. Format:

; rot1 rot2 diff_rot tilt1 tilt2 diff_tilt psi1 psi2 diff_psi ang_dist X1 X2 diff_X Y1 Y2 diff_Y

  • [root]_rot_diff_hist.txt This file shows the histogram of the difference between rotational angles for the best symmetric alignment between both assignments. Format:

; rot_diff count

  • [root]_tilt_diff_hist.txt This file shows the histogram of the difference between tilting angles for the best symmetric alignment between both assignments. Format:

; tilt_diff count

  • [root]_psi_diff_hist.txt This file shows the histogram of the difference between in-plane rotation angles for the best symmetric alignment between both assignments. Format:

; psi_diff count

  • [root]_vec_diff_hist.txt This file shows the histogram of the difference between coordinate vectors for the best symmetric alignment between both assignments. Format:

; avg_vec_diff count

  • [root]_X_diff_hist.txt This file shows the histogram of the difference between X shifts of both assignments. Format:

; X_diff count

  • [root]_Y_diff_hist.txt This file shows the histogram of the difference between Y shifts of both assignments. Format:

; Y_diff count

All histograms can also be computed through xmipp_docfile_histogram.

Usage


$ angular_distance ...

Parameters

  • `` Document file with the angles the angles set 1. These angles may have been generated by xmipp_project with the name[seed]_movements.txt or by xmipp_angular_predict
  • `` Document file with the angles the angles set 2. These angles may have been generated by xmipp_project with the name[seed]_movements.txt or by xmipp_angular_predict
  • `` Rootname for a number of output files. If this option is not provided, then the output files are not generated
  • `` Symmetry file if the particle is symmetric. The description of this file may be found at xmipp_symmetrize

Examples and Notes

A typical use of this program is


$ xmipp_angular_distance -ang1 assigned_angles_iteration_1.txt -ang2 assigned_angles_iteration_2.txt \
-o angle_comparison_it_1_2

The output of this program is written toangle_comparison_it_1_2_merge.txt in the format previously mentioned. Furthermore, it prints out a message like


$ Global distance = 22.6534

stating the average distance among coordinate axes.

--Main.AlfredoSolano - 29 Jan 2007

Clone this wiki locally