AIPS HELP file for SETAN in 31DEC24
As of Sun Nov 3 21:56:05 2024
SETAN: Task to read antenna file info from a text file
INPUTS
INTEXT Input file name (Non-AIPS)
OUTNAME Output file name (name)
OUTCLASS Output file name (class)
OUTSEQ -1.0 9999.0 Output file name (seq. #)
OUTVER -1.0 9999.0 Output AN table version.
OUTDISK 0.0 9.0 Output file disk unit #.
HELP SECTION
SETAN
Task: Task to read an Antenna file info from a text file.
SETAN will either create a new AN table or replace values
in an extant table.
Adverbs:
INTEXT.....A file external to the AIPS system from which the
antenna info can be read. Use of INTEXT depends on
the host operating system.
OUTNAME....Output UVfile name (name). Standard behavior
with. File must exist.
OUTCLASS...Output file name (class). Standard defaults.
OUTSEQ.....Output file name (seq. #). 0 => highest unique.
OUTVER.....Output AN table version number.
OUTDISK....Disk drive # of output file.
EXPLAIN SECTION
SETAN: Task reads an external, formatted file containing
Antenna, subarray and time info.
DOCUMENTOR: W. D. Cotton, NRAO.
RELATED PROGRAMS: AIPS, All AIPS uv tasks.
PURPOSE
SETAN reads and external text file and writes the
information to an antenna (AN) table. If the specified AN table
does not exist then it is created; if it does exist then the
values read from the text file will replace the previous values
in the table.
COMMENTS
INTEXT:
The user must supply a text file containing the antenna
information. The file contains two parts both in free field
format; a header section giving AN table header info and the
table section. The header section of the input file contains a
series of keyword-value pairs describing the array or giving
timing information. Following this is the antenna information
given one antenna per line. The input file can be specified as
follows shown in the following examples:
INTEXT='disk$res:[username]antenna.dat' (VMS)
INTEXT='myarea:antenna.dat' (Unix)
where MYAREA is an environment variable set before
starting AIPS e.g.:
percentsetenv MYAREA /mnt/username
Note also: in UNIX all files whose names are passed
to AIPS should have names containing only upper case
characters.
The header portion of the antenna file contains a number of
keyword-value pairs in free format and in arbitrary order
terminating with a '/' character. Keywords which are recognized
are:
ARRNAM = 'array name' (array name)
ARRAYX = xxx.xxd0 (X coordinate of array center)
ARRAYY = xxx.xxd0 (Y coordinate of array center)
ARRAYZ = xxx.xxd0 (Z coordinate of array center)
GSTIAT = xxx.xxxd0 (GST at IAT=0 in Deg.)
DEGPDY = xxx.xxxd0 (Earth rotation rate deg/IAT day
FREQ = xxx.xxxd0 (Subarray reference frequency Hz)
RDATE = 'dd/mm/yy' (Subarray reference date)
RDATE = 'yyyymmdd' (Subarray reference date preferred)
POLARX = xxx.xxx (X component of polar position arcsec)
POLARY = xxx.xxx (Y component of polar position arcsec)
UT1UTC = xxx.xxx ( UT1 - UTC correction in sec.)
IATUTC = xxx.xxx (IAT - UTC correction in sec.)
XYZHAN = 'handedness' (Antenna frame handedness 'RIGHT')
TFRAME = 'frame' (Terrestrial frame for antennas,
e.g.'ITRF')
The header section is terminated by a '/'. Comments may be
included preceded by a '!'. None of the keyword value pairs is
required but tasks using the AN table may use some of this
information, especially the time and frequency items.
Following this, is the antenna data one antenna at a time in
order: antenna number, X offset from center (m), Y offset, Z
offset and antenna name (in single quotes). Comments are not
supported in this section of the file.
Example:
! Reset antenna coordinates
ARRNAM = 'MYARRAY'
! earth centered coordinates
ARRAYX = 0.0
ARRAYY = 0.0
ARRAYZ = 0.0
GSTIAT = 1.23
FREQ = 1000.0D6
RDATE = '19990101'
/
1 1.0 2.0 3.0 'ANT1'
2 4.0 5.0 6.0 'ANT2'
3 7.0 8.0 9.0 'ANT3'