AIPS HELP file for UVFIL in 31DEC24
As of Wed Oct 9 3:45:01 2024
UVFIL: Task which creates uv data with a user's subroutine.
INPUTS
Input data file name (name):
INFILE
Aux. file name:
IN2FILE
OUTNAME Output UV file name (name)
OUTCLASS Output UV file name (class)
OUTSEQ -1.0 9999.0 Output UV file name (seq. #)
OUTDISK 0.0 9.0 Output UV file disk unit #.
APARM User supplied array
BPARM User supplied array
HELP SECTION
UVFIL
Task: This task will create an AIPS uv data file and fill it by
fetching visibility points one at a time from a user
supplied routine. For more details see the comments in
the source version of the task which should be in the
NOT STANDARD area. Also see HELP NEWTASK.
Adverbs:
INFILE.....Name of the user file to get data from.
IN2FILE....Aux. file name. Can be used for any purpose.
OUTNAME....Output UV file name (name). Standard behavior
with default 'UV DATA FILE'.
OUTCLASS...Output UV file name (class). Standard defaults.
OUTSEQ.....Output UV file name (seq. #). 0 => highest unique.
OUTDISK....Disk drive # of output UV file. 0 => highest disk
with space for the file.
APARM......User specified array.
BPARM......User specified array.
EXPLAIN SECTION
UVFIL: Task which creates and fills an AIPS uv data set using
user supplied information.
DOCUMENTOR: W. D. Cotton, NRAO.
RELATED PROGRAMS: All AIPS uv programs
PURPOSE
UVFIL is the skeleton of a task to create a catalogued
AIPS uv data base and fill it from user supplied information.
The necessary information can be passed to the program via
either APARM and BPARM for control information and from data
read from disk or tape from file specified in INFILE and
IN2FILE by user supplied FORTRAN instructions.
AIPS uv data files are structured similar to the FITS
random group tape format; records are fixed length and consist
of all information from a single interferometer baseline during
a single integration. Each record consists of an arbitrary
number of "random" parameters (eg. u, v, w, time, baseline)
followed by a regular array containing the correlator data.
The number of, order of and names of the first seven of the
random parameters are kept in the catalogue block. The number
of regular axes, the order, dimension, reference value, pixel,
increment etc. of the regular axes are defined in the catalogue
header. All values in a visibility record are stored as REAL*4
words. For more details see the AIPS manual vol. 2.
The uniform axes, with the exception of the frequency axis
are not what one ordinarily thinks of as sequences. For
instance the axis which must be first, the COMPLEX axis
consists of the Real part of a visibility, the Imaginary part
and the weight which have reference values of 1, 2, 3. The
STOKES axis is similar in that I, Q, U, and V Stokes'
parameters have axis coordinates of 1, 2, 3, 4. (The more
common, correlator values of RR, LL, RL and LR have values of
-1,-2,-3 and -4.) A visibility record can be thought of as a
FORTRAN REAL*4 array having dimension:
VIS(n1,n2,n3,n4,n5,n6,n7) where the n1... correspond to the
COMPLEX... axes. The usual order in AIPS is n1=COMPLEX
(required), n2=STOKES, n3=FREQ, n4=RA, n5=Dec. Except for the
COMPLEX axis the order is not fixed. The RA and DEC axes are
usually dimensioned 1 and are there solely as a place to store
the position in the catalogue header.
To use UVFIL the user needs to add FORTRAN code to the
subroutines NEWHED and GETUV which obtains the necessary
information to describe the data base and to fill it.
To source version of UVFIL contains sample code which can
be used as an example. The sample was for a VAX 11/780 and
read ASCII disk files using FORTRAN I/O.