ST - Set values in data file header

PURPOSE

Alters data file locations for SPIDER and MRC files:
1. Alter any specified location in the file header.
2. Clear the statistical values in header of a file.
3. Put maximum and minimum into header if known a priori.
4. Put image tilt angles into header.
5. Alter data origin and volume handedness in SPIDEER's MRC file header.
  Example.

SEE ALSO

ST H	[Set values in image/volume Header by name]
FI X	[File Information - Retrieve file header value(s) by location]
LI T	[List image values - on terminal]

USAGE

.OPERATION: ST

.INPUT FILE: PIC001
[Enter name of the SPIDER or MRC file to be manipulated.]

.(A)NGLES, (L)OCS, (D)ATA-ORIGIN, (P)COPY, (C)LEAR, OR (F)IX:
[Option A : Angles. Put new angles into header.

Option L : Location. Put new values into specified locations in the header. (For MRC files can only be a location that stores an integer or floating point value!) This option can be used to correct damaged file headers or to change locally defined header locations.

Option D : Data-origin. Put new value for image/volume origin (upper left or lower left) and volume handedness (left or right) into SPIDER defined location 26 in MRC header.

Option P : Copy Header Angles. Copies header angles from the input file to header of the output file. Output file must already exist, it is not created. Input file remains unchanged.

Option C : Clear. Unsets the flag indicating that the statistics MAX and MIN have been stored in the header. This opt;ion is useful to force SPIDER to correct inaccurate MIN & MAX information.

Option F : Fix. Puts MIN, MAX, AVERAGE, & S.D. statistical values into header, if known a priori.

For "A" SPIDER will ask:

.ANGLE SET 1, 2, OR 3: 1
[There are three sets of angles that can be stored in a SPIDER file header and two sets in a MRC file header. Normally set: 1 should be used.]

.PHI, THETA, & PSI: 30.0, 60.0, 90.0
[Enter Euler angles.]

For "L" SPIDER will ask:

.NUMBER(S) OF HEADER LOCATION TO BE CHANGED: 17

.NEW VALUE FOR EACH HEADER LOCATION CHANGED: 75.0

For "D" SPIDER will ask:

.ORIGIN AT UPPER LEFT (UL) or LOWER LEFT(LL): LL
[Put new value for image/volume origin. Usually 'UL' for SPIDER created MRC images.]

.HANDEDNESS (L or R): L
[Put new value for handedness (L or R). Usually 'L' for SPIDER created MRC volumes.]

For "P" SPIDER will ask:

.OUTPUT FILE: PIC002
[Enter the name of the output file.]

For "F" SPIDER will ask:

.IMAGE MAXIMUM: 5.0

.IMAGE MINIMUM: 0.0

.AVERAGE AND STANDARD DEVIATION AVAILABLE (Y/N)': Y
[These values are now required otherwise they may be inconsistent with the min. and max.]

.AVERAGE, STANDARD DEVIATION: 2.0, 1.0

NOTES

1. If a file is write-protected, the file cannot be overwritten by any operation.
   

2. Randomly altering positions in a file header may make the file unreadable .
   

3. SPIDER file header locations that can be set.
   

4. MRC file header locations that can be set.
   

SUBROUTINES

UTIL1, SETVAL, SETLAB

CALLER

UTIL1