FI - File Information - List and retrieve file header value(s) by location

PURPOSE

Lists some header values from a specified file in the results file. Can optionally retrieve particular values from the file header by location and place the values in specified register variables. (If used with register variables then this operation is same as 'FI X').

SEE ALSO

FI H	[File Information - Retrieve file Header values by name]
FI X	[File Information - Retrieve file header value(s) by location]
FI A	[File Information - Multiple files]
FI N	[File Information - Do not halt if file not found]
FS	[Find Statistics]
ST	[Set values in image header]

USAGE

.OPERATION: FI

  <or>
FI [maxi],[average]
[This operation takes a variable number of optional register variables. On completion of the operation, the variable(s) receive the values in header locations specified. Prints out: Minimum, Maximum, Average, Standard deviation, X offset, Y offset, and Z offset header values for the file in the results file.]

.FILE INFO. ON FILE: PIC002
[File name.]

If register variables are present on the operation line then the following question will appear:

.ENTER NUMBER(S) OF HEADER LOCATION(S) TO BE RETRIEVED: 7, 9

[Here, label location No. 7 (which is FMAX) is placed in register variable: [maxi] and No. 9 (which is AV) is placed in register variable: [average]. No parentheses is needed around location list in DO loops.]

NOTES

1. If the statistical variables (i.e. FMIN,FMAX,AV,SIG are not already present in the header of the file then they are not calculated. Only values already in the header are listed. Use: 'FS' to set these values in the header.

2. Some locations from the from the file header that can be retrieved:

   Location	Name	Content
   1	NSLICE	Number of slices (planes) in volume (=1 for an image) In some legacy 2D images this may be -1)
   2	NROW	Number of rows per slice.
   3	IREC	Total number of records (including header records) in each image of a simple image or stacked image file.
   4	UNUSED	Unassigned
   5	IFORM	File type specifier. 1 R 2D image. 3 R 3D volume. -11 FO 2D Fourier, mixed radix odd -12 FE 2D Fourier, mixed radix even -21 FO 3D Fourier, mixed radix odd -22 FE 3D Fourier, mixed radix even
   6	IMAMI	Maximum/minimum flag = 0 when the file is created, and = 1 when the maximum, minimum, average, and standard deviation have been computed and stored into this header record (see following locations).
   7	FMAX	Maximum data value.
   8	FMIN	Minimum data value.
   9	AV	Average data value.
   10	SIG	Standard deviation of data. A value of -1.0 or 0.0 indicates that SIG has not been computed.
   11	UNUSED	Obsolete, no longer used.
   12	NSAM	Number of pixels (samples) per line.
   13	LABREC	Number of records in file header (label).
   14	IANGLE	Flag that following three tilt angles are present.
   15	PHI	Tilt angle: phi (See note #2 below).
   16	THETA	Tilt angle: theta.
   17	GAMMA	Tilt angle: gamma (also called psi).
   18	XOFF	X translation.
   19	YOFF	Y translation.
   20	ZOFF	Z translation.
   21	SCALE	Scale factor.
   22	LABBYT	Total number of bytes in header.
   23	LENBYT	Record length in bytes.
   24	ISTACK/ MAXINDX	Position has a value of 0 in simple 2D or 3D (non-stack) files. In an "image stack" there is one overall stack header followed by a stack of images, in which each image has its own image header. A value of >0 in this position in the overall stack header indicates a stack of images. A value of <0 in this position in the overall stack header indicates an indexed stack of images and gives the maximum image number (MAXINDX) allowed in the index.
   25	UNUSED	Unused now. Prior to release 9.0, a '-1' at this location in an overall stack indicated a valid stack and in the stacked images, a value of 1 indicated that this image was in use (existed).
   26	MAXIM	Position is only used in the overall header for a stacked image file. There, this position contains the number of the highest image currently used in the stack. This number is updated, if necessary, when an image is added or deleted from the stack.
   27	IMGNUM	Position is only used in a stacked image header. There, this position contains the number of the current image or zero if this image is unused.
   28	LASTINDX	Position is only used in overall header of indexed stacks. There, this position is the highest index location currently in use.
   29	UNUSED	Unassigned
   30	UNUSED	Unassigned
   31	KANGLE	Flag that additional rotation angles follow in header. 1 = one additional angle set is present, 2 = two additional angle sets. These rotation angles preceed any rotation stored in positions: 15..18.
   32	PHI1	Angle.
   33	THETA1	Angle.
   34	PSI1	Angle.
   35	PHI2	Angle.
   36	THETA2	Angle.
   37	PSI2	Angle.
   38	PIXSIZ	Pixel size (Angstroms).
   39	EV	Electron voltage used.
   40	PROJ	Project number.
   41	MIC	Micrograph number.
   42	NUM	Image number.
   43-49	UNUSED	Unassigned.
   50-76	-	Used for Xmipp transforms.
   77-100	-	Unassigned.
   101	PSI3	Projection angle: Psi (From 'PJ 3Q').
   102	THETA3	Projection angle: Theta (From 'PJ 3Q').
   103	PHI3	Projection angle: Phi (From 'PJ 3Q').
   104	LANGLE	If = 1 then projection angles: PSI3, THETA3 & PHI3 are present in header.
   105-211	-	Unassigned
   212-214	CDAT	11 Character creation date e.g. 27-MAY-1999
   215-216	CTIM	8 Character creation time e.g. 09:43:19
   217-256	CTIT	160 Character title

SUBROUTINES

FILGEN, FILDAT

CALLER

UTIL1