Assign_angles

Assign angles

Purpose

This program allows you to set up to three triplets of Euler angles in the image header(s). The angles can be given from the command line (in the case of a single image) or a document file (in the case of a set of images). The order of the angles in the document file (for each triplet) may be anyone you like and the angles can be changed in sign without changing the document file.

In case of using document and selection files, the first set of angles of the document file is assigned to the first active image in the selection file, the second set of angles to the second active image. The first three angles of the line are stored as the first Euler angles triplet the second three as the second and so on.

Usage

$ assign_angles ...

Parameter

• ``

• `` Selection mode. the angles from a document file are applied to the selection file

• `` Image mode. the angles given in the command line are applied to the provided image

• ``

• ``

• ``

• -order [ang_descr1"+rot"] [ang_descr2="+tilt"] [ang_descr3="+psi"] =

The angles either in the document file or in the command line are numbered asang1,ang2 andang3, [=ang1'=,ang2',ang3',ang1'',ang2'',ang3''], and is the order parameter which gives sense to each angle, ie, ifang_descr1 is+rot, it means that ang1 is the rotational angle, ifang_descr2 is+psi it means thatang2 is thepsi angle, and so on.

As it is common to have to reverse the angles, the angle description also allows you to specify these sign changes. This is done with the prefixes- and+. Ifang_descr1 is+rot, it means that ifang1100=, then the rotational angle is100; and if theang_descr1-rot= then the rotational angle is-100. The default order for the angles is+rot,b=+tilt= and+psi. The rest of valid angle descriptions are-rot,-tilt and-psi.

Examples and notes

• Selection and document files with different sizes If the selection file is larger than the document file then an error is produced but the images for which it has been possible to assign the new angles keep these new angles. The reverse case, the angle file is larger than the number of images, no error is produced and you are not warned of this situation

Here you have several examples of use:

$ assign_angles -img g0ta00001.xmp -ang 10 20 30
$ assign_angles -img g0ta00001.xmp -ang 10 20 30 -ang1 33 44 55

Change the angles ofg1ta00001.xmp torot10=,tilt20= andpsi30=.

$ assign_angles -img g0ta00001.xmp -ang 10 20 30 -order +psi +tilt +rot

Change the angles ofg1ta00001.xmp torot30=,tilt20= andpsi10=.

$ assign_angles -img g0ta00001.xmp -ang 10 20 30 -order +psi -tilt +rot

Change the angles ofg1ta00001.xmp torot30=,tilt-20= andpsi10=.

$ assign_angles -sel g0t.sel -ang angles.doc

Change the angles of all images according toangles.doc. The first column is taken as the rotational angle, the second one as the tilting one, and the third column ispsi.

$ assign_angles -sel g0t.sel -ang angles.doc -order +psi -tilt +rot

Change the angles of all images according toangles.doc. The first column is taken aspsi, the second one as the tilting one changed of sign, and the third column is the rotational angle.

--Main.AlfredoSolano - 31 Jan 2007