AIPS HELP file for HF2SV in 31DEC24
As of Fri Apr 19 0:39:16 2024
HF2SV: Convert HF table to Binary Output for Calc/Solve
INPUTS
INNAME Main input file (name).
INCLASS Main input file (class).
INSEQ 0.0 9999.0 Main input file (seq. #).
0 => high
INDISK 0.0 9.0 Disk unit #. 0 => any
INEXT 'HF' only.
INVERS Input file version no.
ANTENNAS Reference antennas 0 => all
BCOUNT 0.0 99999.0 Beginning row to copy
ECOUNT 0.0 99999.0 Last row to copy: 0 => end
OUTFILE Logical name of directory
for output.
HELP SECTION
HF2SV
Type: Task
Use: This task reads the HF files created by CL2HF or written
in by MK3IN. This is simply a bookkeeping program which
converts each HF row into a file directory structure
which can be read in directly by dbedit in the calc
solve package.
Adverbs:
INNAME......Main file name (name). Standard defaults.
INCLASS.....Main file name (class). Standard defaults.
INSEQ.......Main file name (seq. #). 0 => highest
INDISK......Disk drive # of image. 0 => any
INEXT.......Input table type. Must be 'HF'.
INVERS......Input extension file version #.
ANTENNAS....Reference antennas. 0 => all
One reference antennas will do all baselines to
that antenna.
BCOUNT......Beginning row number to be included .
ECOUNT......Last row number included. 0 = highest.
OUTFILE.....The logical name used for the directory in which
the data is put. The directory must already be
created.
EXPLAIN SECTION
PROGRAM: HF2SV
DOCUMENTOR: Ed Fomalont 94.11.15
RELATED PROGRAMS: FRING, MBDLY, BLING, BLAPP, CL2HF, calc/solve
PURPOSE
The program HF2SV reads an HF file created by CL2HF. The HF file
contains the fringe-fit residual rates, delays and phases
determined from FRING and MBDLY (or BLING and BLAPP), and the
apriori rates, delays and phases calculated from the CL table.
Many other parameters associated with the scan are also given in
the HF file. The output file has 6 binary records, each with
256 bytes. Their contents are described in the documentation
for dbedit in the solve software package.
The files written by HF2SV are placed under the directory given
in OUTFILE. The proper definition of OUTFILE is generally
made before AIPS is initiated by the setenv command. The
predefined logical files, like FITS can be used.
For example, before initiating AIPS type in unix
setenv HFTEST /tmp_mnt/AIPS/USERS
mkdir SBAND (if not already existing)
Then, begin AIPS. For OUTFILE='HFTEST:SBAND', the following
files will be made during execution.
/tmp_mnt/AIPS/USERS/SBAND/FRING.LIST
which contains a summary of all of the data files which have
been written. The data files are in:
/tmp_mnt/AIPS/USERS/SBAND/ddd-hhmm/AB.F.MM.abcdef
where:
ddd-hhmm is the day number of the observations
egs. 241-1434.
AB is the baseline, one capital letter per
station. The codes are defined by the
infile parameter in CL2HF.
F is the band designation. egs X or S.
MM is a sequence number, from 01 to 99. It
distinguishes separate fringe results of
the same data.
abcdef is a 6-figure, 26-base time stamp. It
is not used at the present time.
In general the directory /ddd-hhmm contains several files;
one for each baseline fringe fit and one file of the form
wd/ddd-hhhmm/SOURCE. This latter file is optional and not
needed by solve.
The files under OUTFILE can be read directly into solve
using the program dbedit. If the files are to be transported
elsewhere it is more convenient to place them in a tar file.
For example, if the files are located in
tmp_mnt/AIPS/USERS/SBAND/ddd-hhmm/BB.F.N.jbuuca
then execute tar from the tmp_mnt/AIPS/USERS
tar cvf TARSBAND SBAND
to create a file tarfile which contains everthing in the
SBAND directory. This tar file can then be conveniently
transported over ftp or by tape. It can then be put back
into the original directory structure by running
tar xvf TARSBAND
in a desired directory DIR. The data will be put under
directory DIR/SBAND.