AIPS HELP file for PLOTC in 31DEC24
As of Thu Oct 10 7:25:03 2024
PLOTC: Plots colors used by AIPS tasks suitably labeled
INPUTS
PRTASK Task whose colors are plotted
INNAME Input UV file name (name)
INCLASS Input UV file name (class)
INSEQ 0.0 9999.0 Input UV file name (seq. #)
INDISK Input UV file disk unit #
SOURCES Sources to plot, ' '=>all.
STOKES Desired Stokes in plot
BCHAN 0.0 4096.0 1st spectral channel #
ECHAN 0.0 4096.0 Last spectral channel #
NCHAV 0.0 4096.0 # of channels to average
CHINC 0.0 4096.0 Increment in channel #
BIF Low IF number to plot
EIF Highest IF number to plot
DO3COLOR -1.0 2.0 > 0 use 3-color to separate
channels and IFs; see explain
= 2 SNPLT separate sources
= 2 ELFIT separate sources
INEXT SNPLT/SNIFS/ELFIT only:
extension type
INVERS SNPLT/SNIFS/ELFIT only:
extension version
CROWDED -1.0 3.0 VPLOT only: degree of color
use
OPCODE For SNIFS: ALAN, ALTI
For ANBPL: ALIF, ALST, ALSI
REFANT Antenna for SNIFS ALTI
SOLINT Averaging interval for
SNIFS ALTI (seconds)
TIMERANG Time range for BPEDT, PCEDT
DOTV -10.0 10.0 > 0 Do plot on the TV, else
make a plot file
GRCHAN 0.0 8.0 Graphics channel 0 => 1.
XYRATIO 0.0 X/Y ratio 0 -> fit TV or 1 PL
HELP SECTION
PLOTC
Type: Task
Use: Plots an image of the colors used by the task specified with
PRTASK. Certain options for SNPLT, SNIFS, and ELFIT actually
require reading the table specified by INEXT and INVERS. The UV
data file is opened briefly, but not read. The header
parameters affect BIF, EIF, BCHAN, and ECHAN, however. The
source table is used to handle adverb SOURCES for SNIFS
(OPCODE='ALTI'), and SNPLT and ELFIT (DO#COL=2).
The task fills an array in memory and then displas the plot as
an image. The labeling is plotted separately. When making a
plot file, but planning to plot it on the TV with TVPL, set
XYRATIO to some value such as 1.4. This will decrease the Y
number of pixels from 1000 to 1000/1.4 which may be required to
fit on the TV screen. Note that tasks like UVPLT handle this
parameter differently, keeping the Y number of pixels >= 1000
for plot accuracy. That accuracy is not needed with PLOTC.
This task may be used before making the intended plot in order
to help decide the required adverb values to enable you to
decide, for example, what spectral channel on the UVPLT plot is
the bad one. It may require running PLOTC, then UVPLT, then
PLOTC with a narrower range of channels, and finally UVPLT over
again to enable all this. You may wish to have two aips numbers
running with separate TV displays (using tv=local). This will
allow you to view the PLOTC output and also the, e.g. UVPLT
output.
Adverbs:
PRTASK.....Name of task whose colors are to be plotted.
Supported tasks:
ANBPL
BPEDT
EDITA
EDITR
ELINT
ELFIT
PCEDT
SNEDT
SNIFS
SNPLT
UVPLT
VPLOT
Tasks which are not supported here include BPLOT and
PCPLT which should be self explanatory and GCPLT and
TARPL which are not in common use and which have a
complex manner in which the colors are employed.
INNAME.....Input UV file name (name) Standard defaults.
INCLASS....Input UV file name (class) Standard defaults.
INSEQ......Input UV file name (seq. #) 0 => highest.
INDISK.....Disk drive # of input UV file. 0 => any.
SOURCES....SNPLT, SNIFS, ELFIT only:
List of sources to be plotted. ' '=> all; if any starts
with a '-' then all except ANY source named.
BCHAN......Beginning spectral line channel number. 0 => 1.
ECHAN......Ending spectral line channel number. 0 => max.
NCHAV......Number of spectral channels to average before plotting.
0 => 1. NCHAV is only used to set CHINC when needed
and to correct ECHAN.
CHINC......Increment in spectral line channel number. 0 => NCHAV
As used in UVPLT.
BIF........First IF number to plot. 0 => 1
EIF........Last IF number to plot. 0 => highest
DO3COLOR...Any value => use 3-color vectors in the plot symbols to
allow the polarizations, channels and/or IFs to be
distinguished. BIF, BCHAN, pol 1 is full red,
EIF,ECHAN,pol n is full blue. IF is the outer loop,
so if there are 2 IFs, the channels and polarizations
of IF 1 will range from red to green and those of IF2
will range from green to blue. Note that blue vectors
may overlap and obscure red ones. (but not in PLOTC).
For PRTASK = 'SNPLT' and 'ELFIT' only:
DO3COL = 2 tells PLOTC to plot the colors used by these
tasks to represent source. The list of source numbers
actually occurring in the table, time range, source
list, et al. is translated into consecutive integers
(in the same order) and then assigned red through dark
blue. Thus source numbers 1,2,5,10 become red, yellow,
cyan, and blue, resp. no matter what order they appear
in the table.
INEXT......For PRTASK='SNPLT', 'SNIFS', 'ELFIT' - the extension type
being plotted 'SN','TY, 'SY', or 'CL'
INVERS.....For PRTASK='SNPLT', 'SNIFS', 'ELFIT', 'BPEDT', 'PCEDT':
version number for INEXT. 0 -> max
CROWDED....For PRTASK = 'VPLOT' only"
<= 0 => Plot IFs and spectral channels individually
multiple polarizations, if requested, do appear
in the same panel.
= 1 => Plot spectral channels together in one panel but
separate panels for separate IFs
= 2 => Plot IFs together in one panel but separate
panels for each spectral channel
= 3 => Plot spectral channels and IFs together in one
panel (per baseline)
OPCODE.....For ANBPL:
'ALIF' => will plot data for all IFs (BIF through EIF) on
a single plot (antennas and polarizations are
plotted separately).
'ALST' => will plot data for both parallel polarizations
on a single plot (antennas and IFs are plotted
separately).
'ALSI' => will plot data for both parallel polarizations
and all IFs (BIF through EIF) on a single plot
(antennas are plotted separately).
For SNIFS:
'ALAN' => will plot the time average of the table values
over each SOLINT with all antennas appearing in
one plot
'ALTI' => will plot each time point in SOLINT in a single
plot with one plot per antenna. NOTE: PLOTC does
not examine the table data for validity, unlike
SNIFS. It simply counts the number of samples in
the first SOLINT for the specified REFANT. The
number of samples for an antenna will actually
vary for each SOLINT so the plot will only be
approximate.
REFANT.....For SNIFS with OPCODE='ALTI': the antenna for which the
number of samples in the first SOLINT interval is
counted. 0 -> 1
For BPEDT and PCEDT: the antenna for which the times are
found
SOLINT.....For SNIFS with OPCODE='ALTI': the solution interval in
seconds. 0 -> 600
TIMERANG...Time range of the data to be plotted. In order: Start day,
hour, min. sec, end day, hour, min. sec. Days relative to
reference date.
DOTV.......> 0 => plot directly on the TV device, otherwise make a
plot file for later display on one or more devices
(including the TV if desired).
GRCHAN.....Graphics channel (1 - 7) to use for line drawing. 0 => 1.
XYRATIO....Scale the X axis longer than the Y by XYRATIO.
If DOTV > 0, 0 -> fit to the current TV window
If DOTV <= 0, 0 -> 1.
EXPLAIN SECTION