CENT PH - Center image/volume using phase approximation

(3/29/12)

PURPOSE

Shifts image/volume to center. Center is determined by phase approximation.   Example.

SEE ALSO

CG PH [Center of Gravity - Phase approximation ||]
CG [Center of Gravity]

USAGE

.OPERATION: CENT PH [XOFF],[YOFF],[ZOFF]
[When used with single image/volume, this operation can return up to three optional register variables:

Variable Example Receives
First [xoff] Sub-pixel X shift used in centering
Second [yoff] Sub-pixel Y shift used in centering
Third (For volumes) [zoff] Sub-pixel Z shift used in centering

.INPUT FILE NAME OR TEMPLATE (E.G. STK@****): instack03@
[Enter the name of the file to be shifted. This name can be for a single file, a whole stack (ending in @), or a template for a set of images (e.g stack3@****** or fil***). Templates containing asterisks will have the astericks substituted with a number for the file.]

If the input file is a single image SPIDER asks:


.OUTPUT FILE: IMG048
[Enter the name of the file where the centered image is to be placed.]

Otherwise if the input file name contains astericks for a set of images SPIDER asks::


.FILE NUMBERS OR SELECTION DOC. FILE NAME: select_03
[Enter the file numbers to be substituted into the file name template or name of a selection document file that contains the file numbers in the first register column.]

.OUTPUT FILE TEMPLATE: STACK03@****
[Enter the name of the file(s) where the rotated and shifted images are to be placed.]

.OUTPUT ALIGNMENT DOCUMENT FILE: shaligndoc
[Enter the name for a document file where the rotation and shift parameters will be placed. Enter '*' if you do not want this file.]

Otherwise if the input file is a whole stack SPIDER asks:


.OUTPUT STACK FILE: STACK03@
[Enter the name of the file where the centerd images are to be placed. This output file will be a whole stack. Image numbers within the stack will correspond to the input stack]

.OUTPUT ALIGNMENT DOCUMENT FILE: shaligndoc
[Enter the name for a document file where the rotation and shift parameters will be placed. Enter '*' if you do not want such this file.]

Different prompt variations occur for other possible combinations of input and output file stacks.

NOTES

  1. Fourier shift is used (except when all shifts are integers), see: 'SH F'.

SUBROUTINES

CENT_PH, CENT_3PH, SHIFTS

CALLER

UTIL_1011