AIPS HELP file for DATAIN in 31DEC25
As of Wed Dec 11 8:53:21 2024
HELP SECTION
DATAIN
Type: Adverb (String*48)
Use: To specify the name of a disk file outside the usual AIPS
catalog system to be used as input for an AIPS verb or task.
The file is a FITS- or other binary-format file representing
either image or UV data in binary form.
Format: The name is usually given by specifying a logical device plus
directory, followed by a colon, followed by the actual file
name. In Unix, logicals are environment variables. The
logical name must be set up before entering the AIPS program
and is usually in upper case. Thus, for example:
percent setenv MYAREA ~joeuser
for the C shell, and
$ myarea=$HOME; export MYAREA
for bourne, korn, and bash shells. Then in AIPS,
DATAIN = 'MYAREA:FITS.DAT'
Note that the Unix-standard $ ahead of the logical is omitted.
AIPS-standard logicals like FITS (often AIPS/FITS) are available
also. Other forms are now acceptable as well:
DATAIN = 'FITS.DAT
will find the file in the $FITS directory (when reading or
writing FITS disk files) or in the directory local when you
started AIPS. A full path name may also be given
DATAIN = '/home/primate2/egreisen/AIPS/N6503.fits
if it fits in 48 characters. Note that the trailing quote mark
is left off and this is the last command on the input line so
that the case is preserved.
Under UNIX, it is now possible to read and write tape files with
other, cooperating computers. If the other computer is running
the AIPS "deamon" task TPMON, then DATAIN may also take the form
:::
where is the name of the other computer, and is
a name known to TPMON on that computer. This limitation
probably requires you to use the $FITS or $RUNFIL or other
widely known AIPS areas. (For real tape, the node name is given
in the MOUNT command instead.) This option only applies to tapes
(i.e. FITTP).
Null value: ' '
Taken to mean no subsidiary file. This can be an error.
For tapes, it means use a real tape drive given by INTAPE
(which must already be MOUNTed).
Tasks:
ATLOD........Reads ATCA data in RPFITS Format into AIPS.
DATAIN is the RPFITS disk file.
CALRD........Reads calibrator source model-image FITS file.
DATAIN is used to select the web site of Perley's
models.
CANDY........User-definable (paraform) task to create an AIPS
image; DATAIN contains the image in the user's format
FETCH........Reads an image from an external text file; DATAIN
contains a description of the image followed by the
data of the image
FILLM........Reads VLA on-line/archive format uv data tapes;
DATAIN is the VLA archive disk file (base name)
FIT2A........Reads the fits input file and records it to the
output ASCII file; DATAIN is the input FITS image
disk file
FITLD........Reads tape to load FITS images or FITS UV files to
disk; DATAIN is the input FITS disk file
GSCAT........Reads Fits Guide star catalog file; DATAIN is the
name of the FITS disk file containing a REGIONS table
IMLOD........Reads tape to load images to disk; DATAIN is the
input FITS file on disk
OTFBS........Translates on-the-fly continuum SDD format to AIPS UV
file; DATAIN is the input sdd-format single-dish
continuum data file
OTFIN........Lists on-the-fly single-dish SDD format data files;
DATAIN is the input data file
OTFUV........Translates on-the-fly single-dish SDD format to AIPS
UV file; DATAIN is the input spectral-line
single-dish sdd format file
PRTTP........Prints contents of tapes, all supported formats;
DATAIN is the input disk file in FITS or VLA archive
format
TCOPY........Tape to tape copy with some disk FITS support; DATAIN
is the input disk file
UVLOD........Read export or FITS data from a tape or disk; DATAIN
is the input disk file
Verbs:
CALDIR.......Lists calibrator source models available as AIPS FITS
files. DATAIN is used to select models from Rick
Perley's web sites.
TPHEAD.......Verb to list image header from FITS or IBM-CV tape;
DATAIN is the input disk file
Procedures:
READISK......Writes images / uv data w extensions to tape in FITS
format. DATAIN specifies the directory name from
which to read the files.
VLBAARCH.....Procedure to archive VLBA correlator data; DATAIN is
the input disk file name or the logical or directory
name for the input correlator jobs
VLBAIT.......Procedure to read and process VLBA data; DATAIN is
the input disk file name as FITLD
VLBALOAD.....Loads VLBA data; DATAIN is the input disk file name
as FITLD
VLBAMPHC.....Applies VLBARUN calibration to additional phase
stopping centers. DATAIN specifies the file which
may be read if the data are not already loaded.
VLBARFI......Calibrates VLBA autocorrelations, writes out
statistics. . DATAIN specifies the file which
may be read if the data are not already loaded.
VLBARUN......Applies amplitude and phase calibration procs to
VLBA data. DATAIN specifies the file which
may be read if the data are not already loaded.
EXPLAIN SECTION