FUNCTION
Script to link names according the 'wfotfits' convention
to the SDC-SAC convention.
USAGE
w_vaxlink -obsper number -prefix string [-datdir directory-name]
DESCRIPTION
When data is read from tape by invoking the 'dd' utility the
resulting files are of the form 'PREFIX__####.POSTFIX' where
standard POSTFIX is '.fot' and #### denotes the sequence number
on the FOT as they also appear in the TAPE DIRECTORY (first file
FOT.
In order to enable the use of data retrieved by internet from
SDC-SAC a conversion of the names is needed. By this convention
file names are of the form 'FILETYPE_#####_##_@.DAT' where #####
are sequentially incremented numbers and @ is either mode
'I', 'N' or 'F'
Below a sample (WFC1 only) of the FOT of OP 1234 in the order
as they would have appeared on a FOT on tape medium
tapedirtape_000000_00_0.dat
ephemeris_000000_00_0.dat
attitude_000000_00_0.dat
obt_utc_000000_00_0.dat
ithkd000_000000_00_0.dat
tchkd000_000000_00_0.dat
w1instdirtape_000000_00_0.dat
w1obsdirtape_000000_01_i.dat
w1exconf_01233_01_i.dat <--- 1233 = number of previous OP
w1hkd000_01233_01_i.dat
w1eng000_01233_01_i.dat
w1dir001_01233_01_i.dat
w1obsdirtape_000000_01_n.dat
w1exconf_01234_01_n.dat <--- 1234 = number of this OP
w1hkd000_01234_01_n.dat
w1eng000_01234_01_n.dat
w1dir001_01234_01_n.dat
w1obsdirtape_000000_02_n.dat
w1exconf_01234_02_n.dat
w1hkd000_01234_02_n.dat
w1eng000_01234_02_n.dat
w1dir001_01234_02_n.dat
w1obsdirtape_000000_01_f.dat
w1exconf_01235_01_f.dat <--- 1235 = number of following OP
w1hkd000_01235_01_f.dat
w1eng000_01235_01_f.dat
w1dir001_01235_01_f.dat
OPTION SPECIFIERS
-obsper [integer]
Specifies the Observation Period of the Fot data
If omitted the user is prompted to enter it
-prefix [string]
Specifies the string prefixed to the resulting linknames
If omitted the user is prompted to enter it. If entered
a '^' it will become the OP number prefeixed by 'OP'
-datdir [string]
Specifies the directory weher the Fot datais located.
If omitted the current directory is taken as default.
-ext [string]
Specifies the extension of the linknames.
Default '.fot' [NOT NORMALLY CHANGED]
-test
Only echo the link commands but do not perform
EXAMPLE:
Make linkfiles in current directory pointing to files in the data
directory /FOTDIR of Obspervation Period 999
> w_vaxlink -obsper 999 -prefix OP999 -datdir /FOTDIR
NOTES
- By default the links are made in the current directory
- the tape filenames must be either upper- or lowercase, but not mixed.
- names of the DAT files are renamed with removed revision extensions ';*'
- The Observation Period ID must be numeric and pertain to the
Normal observing period (so NOT of Initial/Final Obs. Per.)
- For reference see Document TPZ/GO.SDC-100/FOT-TN/SAX chapt 2.3 + 2.4
SEE ALSO
w_proc, w_stageI