AIPS HELP file for LISUN in 31DEC25
As of Tue Dec 10 3:26:31 2024
LISUN: Task to print UV data scan list with Sun angles
INPUTS
INNAME UV data (name).
INCLASS UV data (class).
INSEQ 0.0 9999.0 UV data (seq. #). 0 => high
INDISK Disk unit #. 0 => any
SOURCES Source list
CALCODE Calibrator code ' '=>all
TIMERANG Time range to list
SELBAND Bandwidth to select (kHz)
SELFREQ Frequency to select (MHz)
FREQID Freq. ID to select.
None selected => 1.
DOCRT -3.0 132.0 > 0 -> use the terminal,
else use the line printer
> 72 => terminal width
OUTPRINT
Printer disk file to save
BADDISK Disk to avoid for scratch.
HELP SECTION
LISUN
Type: Task
Use: Prints a list of scans with the current angle to the Sun.
Basically LISTR OPTYPE='SCAN' with the added information.
Adverbs:
INNAME.....UV file name (name). Standard defaults.
INCLASS....UV file name (class). Standard defaults.
INSEQ......UV file name (seq. #). 0 => highest.
INDISK.....Disk unit #. 0 => any.
SOURCES....List of sources to be listed. ' '=> all; if any
starts with a '-' then all except ANY source named.
For OPTYPE='GAIN' this controls the sources in the
SN, CL or TY table to be listed.
CALCODE....Calibrators may be selected on the basis of the
calibrator code given in the SU table.
' ' => any calibrator code selected
'* ' => any non blank code (cal. only)
'-CAL' => blank codes only (no calibrators)
anything else = calibrator code to select.
NB: The CALCODE test is applied in addition to the
other selection tests
TIMERANG...Time range of the data to be listed. In order:
Start day, hour, min. sec,
end day, hour, min. sec. Days relative to ref.
date.
SELBAND....Bandwidth of data to be selected. If more than one IF is
present SELBAND is the width of the IF required. Units =
kHz, 0=> all
SELFREQ....Frequency of data to be selected. If more than one IF is
present SELFREQ is the frequency of the first IF
required. Units = MHz, 0=> all
FREQID.....Frequency identifier to select: you may determine which
is applicable from the OPTYPE='SCAN' listing produced by
LISUN. If either SELBAND or SELFREQ are set, their values
overide that of FREQID. However, setting SELBAND and
SELFREQ may result in an ambiguity. In that case the
task will request that you use FREQID. If neither
SELBAND, SELFREQ nor FREQID are specified then the first
FQ id in the FQ table (usually 1) will be used. FREQID
applies to GAIN listings, but if all 3 freq-id adverbs
are <= 0, then all freq-ids are listed.
DOCRT......False (<= 0) use the line printer if OUTPRINT = ' '
else write named OUTPRINT file only.
When OUTPRINT is not blank, DOCRT=-2 suppresses the
page-feed character on page headers and DOCRT=-3
suppresses page headers and most other header
information. When OUTPRINT is blank, the line
printer will be used. LISUN now counts the lines
to be printed before printing any and asks for
permission to continue if the count > 500.
True (> 0) use the terminal interactively. The task will
use the actual terminal width as a display limit
unless 72 < DOCRT < width. In that case, the display
limit will be DOCRT characters.
OUTPRINT...Disk file name in which to save the line printer output.
' ' => use scratch and print immediately for interactive
jobs - batch jobs use OUTPRINT = 'PRTFIL:BATCHjjj.nnn'
(jjj= job #, nnn = user #). When OUTPRINT is not blank,
multiple outputs are concatenated, and the file is not
actually printed.
BADDISK....Disk numbers to avoid for scratch files. Scratch
files may be created by the sorting routines if
calibration or flagging is applied.
EXPLAIN SECTION