AIPS HELP file for SPLOT in 31DEC26
As of Tue Aug 11 2:43:05 2026
SPLOT: Plots selected contents of an SN, SY, TY, PC, or CL file
INPUTS
INNAME UV data (name).
INCLASS UV data (class).
INSEQ 0.0 9999.0 UV data (seq. #). 0 => high
INDISK 0.0 9.0 Disk unit #. 0 => any
INEXT Input 'SN','SY','TY','PC',
or 'CL'
INVERS Input table file version no.
SOURCES Source list
QUAL -10.0 Source qualifier -1=>all
TIMERANG Time range to plot
STOKES Stokes type to plot: R, L,
RR, LL, RRLL, DIFF, RATO
V, H, VV, HH, VVHH
SELBAND Bandwidth to plot (kHz)
SELFREQ Frequency to plot (MHz)
FREQID Freq. ID to plot, -1=>all
SUBARRAY -1.0 Limit to subarray; 0 -> 1
-1 -> all
BIF 0.0 100.0 First IF to plot, 0=>1.
EIF 0.0 100.0 Last IF to plot 0 -> highest
ANTENNAS Include these antennas only
0 => all; < 0 exclude list
order matters
PIXRANGE Range to plot: 0 => self
scale each antenna separately
XINC 0.0 5000.0 Plot every XINC'th point
OPTYPE Data to be plotted:
'PHAS','AMP ','DELA','RATE',
'TSYS','DOPL','SNR ','MDEL',
'TANT','ATM ','GEO ','CCAL',
'DDLY','REAL','IMAG','IFR ',
'PDIF','PSUM','PGN ','PON ',
'POFF','PSYS','PDGN','PSGN',
'POWR','PODB' ' '=phase
OPCODE Type of plot:
'ANT' all antennas
'IF' all IFs
'DIFA' all ants difference
'DIFI' all IFs difference
'ADIF' all ants difference
'IDIF' all IFs difference
DO3COLOR -1.0 3.0 3-color lines: 0 no, 1 yes
to separate antenna or IF,
2 to distinguish intensity
3 to distinguish source
BCOUNT If INEXT ='PC' and OPTYPE =
'AMP' or 'PHAS, BCOUNT
specifies the phase cal tone
number to be plotted. 0->1.
XAXIS 0.0 4.0 Variable data is to be
plotted against, 0=>time.
2, 3, 4 time with gaps
differ in X axis labeling
DETIME Time interval (minutes) to
treat as a "gap"
DOWEDGE -1.0 > 0 plot color to right when
DO3COLOR is 2.
SYMBOL 0.0 24.0 Plot symbol number: 1 - 24
FACTOR -10.0 10.0 Scale plot symbols by FACTOR
<0 => connect points too
DOSCALE 0.0 5.0 Scale vertical axis 0 -> 1
CUTOFF Table weights <= CUTOFF will
not be plotted, flagged data
are not plotted.
DOSCAN -1.0 2.0 = 1 -> plot full boundaries
= 2 -> plot ticks at scans
LTYPE -410.0 410.0 Type of labeling: 1 border,
2 no ticks, 3 standard, 4 rel
to center, 5 rel to subim cen
6 pixels, 7-10 as 3-6 with
only tick labels
<0 -> no date/time
DOTV -1.0 2.0 > 0 Do plot on the TV, else
make a plot file
= 2 Init full TV
GRCHAN 0.0 88.0 Main graphics channel
+ 10 * label graphics chan
XYRATIO 0.0 X/Y ratio 0 -> fit TV or 1 PL
BADDISK Disks to avoid for scratch
HELP SECTION
SPLOT
Type: Task
Use: Plots selected calibration data versus time from a specified SN,
TY, PC or CL table. Unlike SNPLT, this task makes multiple plots
showing all included antennas or IFs are done. They will be a
set of profiles separated on the vertical axis by an increment
in antenna number or IF (depending on the OPCODE selected). You
may plot the selected parameter or the diffence of the selected
parameter from the average. The vertical tick marks show
antenna or IF and are placed at value 0 when the range fo values
includes 0. Otherwise, they are placed at the mid point of the
value range.
To examine SN or CL tables with a new reference antenna, run
SNREF with DOKEEP=1 and then use SPLOT or SNPLT. Axis labeling
here is LTYPE=3.
NOTE: FILLM and FITLD used to fill VLA and VLBA (resp) data
with CL tables having weight 0. These "data" (actually just
(1,0) for (real,imag) gain) are "flagged" and that may be the
reason for a failure to find any data to plot. Of course, you
are wasting time looking at (1,0)'s. CL tables with
interesting values in them will not be flagged in this way.
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.
INEXT......'SN','TY, 'PC', 'SY', or 'CL' table to be plotted
INVERS.....Version number of table to plot, 0=>highest no.
SOURCES....Source list. '*' = all; a "-" before a source name means
all except ANY source named.
QUAL.......Only sources with a source qualifier number in the SU table
matching QUAL will be used if QUAL is not -1.
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. If a start and stop time are given and
then all plots will be from the given start time to the
given stop time.
STOKES.....The desired Stokes type of the displayed data:
'R' = RCP, 'L' = LCP, 'RL' or 'RRLL' both RCP and LCP
'V' = VLP, 'H' = HLP, 'VH' or 'VVHH' both VLP and HLP
SELBAND....Bandwidth of data to be selected. If more than one IF is
present SELBAND is the width of the first IF required.
Units = kHz.
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.
FREQID.....Frequency identifier to select (you may determine which is
applicable from the OPTYPE='SCAN' listing produced by
LISTR). 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. -1 => all, 0 => first
SUBARRAY...Limit display to specific subarray. -1 -> all, 0 -> 1.
BIF........First IF IF to plot
EIF........Last IF to plot.
ANTENNAS...A list of antennas to be included. all 0 => include all
If any in the list is negative, then include all antennas
except and that appear (in absolute value) in the list.
Thus ANTEN = 3,-5,7 inlcudes all antennas except 3, 5,
and 7. The plots are ordered in the order given in
ANTENNAS when all are positive. When antennas are
excluded, the plot shows antennas in numerical order
except the excluded ones.
PIXRANGE...If PIXR(1) < PIXR(2), all plots will be from PIXR(1) to
PIXR(2). Otherwise each plot will be self-scaling.
XINC.......Plot every XINC'th point, 0 => 1.
OPTYPE.....Data to be plotted:
1. 'PHAS' = phase,
2. 'AMP ' = amplitude,
3. 'DELA' = singleband delay (SN & CL)
4. 'RATE' = rate (SN, CL & PC)
5. 'TSYS' = sys. temp. (TY) (for VLA is nominal
sensitivity)
6. 'DOPL' = doppler offset (CL)
7. 'SNR' = signal/noise (SN & CL weights)
8. 'MDEL' = multiband delay (SN & CL)
9. 'TANT' = ant. temp. (TY) (for VLA either back- or
front-end system temperature)
10. 'ATM' = atm. delay (CL)
11. 'GEO' = geometric delay (CL)
12. 'CCAL' = cable cal (PC)
13. 'DDLY' = dispersive delay (SN & CL)
14. 'REAL' = real part
15. 'IMAG' = imag part
16. 'IFR ' = Ionospheric Faraday rotation (affects pol
cal) (SN & CL)
17. 'PDIF' = EVLA Gb * (Pon - Poff) (SY)
18. 'PSUM' = EVLA Gb * (Pon + Poff) (SY)
19. 'PGN ' = EVLA post sync-detector gain = Gb (SY)
20. 'PON ' = EVLA Pon (noise tube on) (SY)
21. 'POFF' = EVLA Poff (noise tube off) (SY)
Note that PON and POFF give numbers smaller
than PDIF and PSUM by the factor Gb which
is, by default, 512 and usually ranges in
the 400's when it has been set.
22. 'PSYS' = EVLA PSUM/PDIF/2 * Tcal (=Tsys) (SY)
uses values from the CD table
23 'PDGN' = EVLA Pdif / (4096 * Pgain * Pgain)
24 'PSGN' = EVLA Psum / (4096 * Pgain * Pgain)
25. 'POWR' = (1/Gain amp)^2
26. 'PODB' = Log10 (1/Gain amp)^2
' ' => 'AMP'
OPCODE.....Type of plot:
'ANT ' => all antennas on one page with IFs in separate
pages
'IF ' => all IFs on one page with antennas in separate
pages
'DIFA' => all antennas on one page with IFs on separate
pages. Plot the difference between the value
for the antenna and the average over all
antennas. Complex data show the vector
difference.
'DIFI' => all IFs on one page with antennas on separate
pages. Plot the difference between the value
for the IF and the average over all IFs.
Complex data show the vector difference.
'ADIF' => all antennas on one page with IFs on separate
pages. Plot the difference between the value
for the antenna and the average over all
antennas. Complex data show the scalar
difference.
'IDIF' => all IFs on one page with antennas on separate
pages. Plot the difference between the value
for the IF and the average over all IFs.
Complex data show the scalar difference.
other => 'ANT'
'DIFA' and 'ADIF' are the same except for AMP and PHAS
'DIFI' and 'IDIF' are the same except for AMP and PHAS
DO3COLOR...<= 0 => use a single line drawing color (TYPE 2).
=1 => the various bandpasses drawn are in a range of
colors from blue for the first bandpass plotted (at
the bottom) to red for the last bandpass plotted (at
the top). Color distinguishes baseline when SORT='TA'
and distinguishes times otherwise.
=2 => use color as an additional separator of intensity.
The intensity range is assigned colors from blue at
the lowest value to red at the highest. Each point on
the plot gets the color appropriate to its intensity.
-3 => use color to distinguish sources.
These color options allow the drawings to be more crowded
and still somewhat distinguishable.
BCOUNT.....If INEXT ='PC', and OPTYPE = 'AMP' or 'PHAS' then BCOUNT
specifies the phase cal tone number to be plotted. 0 -> 1.
XAXIS......Variable data is to be plotted against. 0=> 1
(1) = Data label time
(2) = Time with gaps surpressed, not label tics in gaps
(3) = Time with gaps surpressed, label first and last
tics in gaps
(4) = Time with gaps surpressed, label all tic marks
DETIME.....Time interval between data > DETIME minutes causes a "gap"
to be put in the X axis to compress that axis on XAXIS=2,
3, 4 only. 0 -> 3
DOWEDGE....If DO3COLOR=2 and DOWEDGE > 0. plot a vertical wedge to
the right of the main plot area showing the full range of
colors from data value minimum to maximum.
SYMBOL.....Choices are:
1: Plus sign 13: Star of David
2: Cross (X) 14: Seven-pointed star
3: Circle 15: Eight-pointed star
4: Box 16: Nine-pointed star
5: Triangle 17: Ten-pointed star
6: Diamond 18: 11-pointed star
7: Pentagon 19: 12-pointed star
8: Hexagon 20: 13-pointed star
9: Septagon 21: 14-pointed star
10: Octagon 22: Plus (+) with gap
11: Nine-gon 23: Cross (X) with gap
12: Five pointed star 24: Vertical line
FACTOR.....Scale plot symbols by FACTOR 0 -> 1.
If FACTOR < 0, draw lines between the points and use
abs(FACTOR) to scale the points plotted.
DOSCALE....The plot is broken along the vertical axis into parts
of equal size. To then scale the plots by an additional
factor, set DOSCALE. 0 -> 1
CUTOFF.....If >= 0, the task will examine the weight column of the
table and if the weight <= CUTOFF, the task will not plot
that sample. If = 0, will plot all good points; flagged
data are not plotted. CUTOFF is ignored for TY and PC
tables and OPTYPEs MDEL, ATM, GEO, and CCAL.
DOSCAN.....> 0 => plot scan boundaries when there is an NX table and
the X axis is time. The boundary is a tick mark when
DOSCAN=2 and a full line when DOSCAN=1.
<= 0 -> do not plot boundaries.
LTYPE......Labelling type, see HELP LTYPE for details:
1 = border, 2 = no ticks, 3 or 7 = standard, 4 or 8 =
relative to ref. pixel, 5 or 9 = relative to subimage
(BLC, TRC) center, 6 or 10 = pixels. 7-10 all labels
other than tick numbers and axis type are omitted.
Less than 0 is the same except that the plot file
version number and create time are omitted.
Add n * 100 to alter the metric scaling.
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).
>= 1.5 => initialize all of the TV, not just the
grey-scale and graphics planes used
GRCHAN.....Graphics channel (1 - 7) to use for line drawing.
A value of 0 causes more than one graphics channel to be
used. To specify a channel to be used for plot labels
add 10 * that graphics channel number. If the label
channel is zero, it is set to GRCHAN. See HELP GRCHAN
for additional discussion.
XYRATIO....Scale the X axis longer than the Y by XYRATIO.
If DOTV > 0, 0 -> fit to the TV window
If DOTV <= 0, 0 -> 1.
BADDISK....Disk number(s) to avoid for scratch files used during any
table sort.
EXPLAIN SECTION
1. 'PHAS' = phase,
CL columns 17 18 28 29
SN columns 12 13 21 22
PC columns 10 11 15 16
2. 'AMP ' = amplitude,
CL columns 17 18 28 29
SN columns 12 13 21 22
PC columns 10 11 15 16
3. 'DELA' = singleband delay
CL columns 20 31
SN columns 14 23
4. 'RATE' = rate
CL columns 19 30
SN columns 15 24
PC columns 12 17
5. 'TSYS' = sys. temp. (for VLA is nominal sensitivity)
TY columns 7 9
6. 'DOPL' = doppler offset
CL columns 9
7. 'SNR' = signal/noise (weight columns)
CL columns 21 32
SN columns 16 25
8. 'MDEL' = multiband delay (SN & CL)
CL columns 12 23
SN columns 9 18
9. 'TANT' = ant. temp. (for VLA either back- or front-end system
temperature)
TY columns 8 10
10. 'ATM' = atm. delay
CL columns 10
11. 'GEO' = geometric delay (CL)
CL columns 8
12. 'CCAL' = cable cal (PC)
PC columns 7
13. 'DDLY' = dispersive delay
CL columns 15 26
SN columns 10 19
14. 'REAL' = real part
CL columns 17 28
SN columns 12 21
PC columns 10 15
15. 'IMAG' = imag part
CL columns 18 29
SN columns 13 22
PC columns 11 16
16. 'IFR ' = Ionospheric Faraday rotation (affects pol cal)
CL columns 7
SN columns 7
17. 'PDIF' = EVLA Gb * (Pon - Poff)
SY columns 8 11
18. 'PSUM' = EVLA Gb * (Pon + Poff)
SY columns 9 12
19. 'PGN ' = EVLA post sync-detector gain = Gb
SY columns 10 13
20. 'PON ' = EVLA Pon (noise tube on)
SY columns 8 9 10 11 12 13
21. 'POFF' = EVLA Poff (noise tube off)
SY columns 8 9 10 11 12 13
Note that PON and POFF give numbers smaller than PDIF
and PSUM by the factor Gb which is, by default, 512 and
usually ranges in the 400's when it has been set.
22. 'PSYS' = EVLA PSUM/PDIF/2 * Tcal (=Tsys)
SY columns 8 9 11 12
uses values from the CD table
23 'PDGN' = EVLA Pdif / (4096 * Pgain * Pgain)
SY columns 8 10 11 13
24 'PSGN' = EVLA Psum / (4096 * Pgain * Pgain)
SY columns 9 10 12 13
25. 'POWR' = (1/Gain amp)^2
CL columns 17 18 28 29
SN columns 12 13 21 22
26. 'PODB' = Log10 (1/Gain amp)^2
CL columns 17 18 28 29
SN columns 12 13 21 22