AIPS HELP file for TARPL in 31DEC25
As of Wed Dec 11 9:00:30 2024
TARPL: Generate plots of input and output text files for TARS
INPUTS
USERID -32000.0 32000.0 User ID - ignored
INNAME Image name(name).
INCLASS Image name(class).
INSEQ 0.0 9999.0 Image name(seq. #). 0=>high
INDISK 0.0 9.0 Disk drive #. 0=>any
INTEXT
Text file with plot info
APARM Controls over plot
(1,2) X value range
(3,4) Y amp/real value range
(5,6) Y ph/imag value range
(7) > 0 -> real,imag plot
also see HELP
(8) > 0 lambda^2 not freq.
RPARM (1-30) Symbol types (0->24)
VPARM (1-30) Line types (0->..)
FACTOR Scale symbol sizes
DO3COLOR -1.0 2.0 > 0 use multi-color plots
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
XYRATIO 0.0 XYratio scale plot
DOTV -1.0 1.0 > 0 Do plot on the TV, else
make a plot file
GRCHAN 0.0 8.0 Graphics channel 0 => 1.
HELP SECTION
TARPL
Type: Task
Use: TARPL will write commands to a plot file or the TV to display
a TARS output file. Up to 30 RM spectra may be in the input
text file, each of which may be plotted with a selected plot
symbol (or omitted). They may be connected by lines as well.
TARPL will also plot the Q/U spectrum from a text file that is
an input file to TARPL. Note that there can only be one data
set in such files. TARS has no requirement that the data in
the text file be in any specific order. If the data are not
in strict frequency order, leave VPARM 0 to avoid strange
connecting lines.
Adverbs:
USERID......The ID of the owner of the image. Ignored
INNAME......Image name (name). Standard defaults. The plot file
is attached to this AIPS file which is otherwise ignored.
INCLASS.....Image name (class). Standard defaults.
INSEQ.......Image name (seq. #). 0 => highest.
INDISK......Disk unit #. 0 => any.
INTEXT......Text file containing data to be input to or written by
TARS (see explain for details). The first line must
be a comment with columns labeled K and RM is it is
to be interpreted as an output file.
APARM.......Self-scale examines only those spectra selected by RPARM
and/or VPARM.
(1,2) X plot range. If APARM(2) <= APARM(1), self scale.
(3,4) Y plot range for amplitude/real. If APARM(4) <=
APARM(3), self scale,
(5,6) Y plot range for phase/imaginary. If APARM(6) <=
APARM(5), self scale.
(7) = 1 => Plot real and imaginary
= 2 => Plot real
= 3 => Plot imaginary
= -1 => Plot amplitude and phase
= -2 => Plot amplitude
= -3 => Plot phase
= 0 -> -1
(8) > 0 -> Use lanbda^2 rather than frequency to plot
input files to TARS.
RPARM.......(1-30) Plot symbol number for data of group 1-30, resp.
You may have both a symbol and a line for each group
0: No symbol plotted for this type
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
If RPARM(i) is < 0, use abs (RPARM(i)) for phase only.
If all RPARM and VPARM are zero, RPARM is set to 1 for
all 30 values.
VPARM.......(1-30) Line type number for data of group 1-30, resp.
You may have both a symbol and a line for each group
0: No line plotted for this group
1: connected solid step line
2: connected solid line
3: dashed line, 1 break between points
4: dashed line, 2 breaks between points
5: and so on (VPARM(I)-2 breaks between points)
If VPARM(i) is < 0, use abs (VPARM(i)) for all plots
except phase.
FACTOR......Symbol size multiplier; 0 -> 1.
DO3COLOR....> 0 plot with colors (up to 4 groups use graphics planes
4, 3, 2, 1, > 4 groups use true grey-scale colors)
= 2 plot with true grey-scale colors even with <= 4
groups
<=0 plot without colors
When plotting true colors, the first plotted group is
plotted in red, the last in blue. Thus if there are 4
groups plotted in true color, they are assigned red,
yellow, cyan, and blue, resp.
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).
GRCHAN......Graphics channel (1 - 7) to use for line drawing.
0 => 1.
EXPLAIN SECTION
TARPL: Task to create a TARPL-plot extension file
DOCUMENTOR:
RELATED PROGRAMS: TKPL, TVPL, LWPLA, PLOTR
PURPOSE
TARPL generates a plot extension file containing a TARPL plot,
its border, and labels. The plot itself may be displayed on a
printer, TEK screen, or TV graphics channel by the tasks LWPLA, TKPL,
or TVPL respectively.
COMMENTS
Each data group begins with a line starting with '; K' with the next
line giving a value of K equal 1. The beginning line also gives
scaling and type information. The task reads the data for the first
group until the end of file or another group start card is found.
then it reads the data for group 2 and so forth. Which groups are
plotted is determined by RPARM and VPARM.
There may be 30 groups each of <= 2000 values.
The text file can contain other comment cards starting with an
character not blank or a number so long as they do not start with
semi-colon, 3 blanks, and the letter K ('; K').
An example file (with ... being large numbers of skipped lines):
1 -2400.0 18044.50 111.00
2 -2390.0 19425.98 101.09
3 -2380.0 19881.87 86.20
4 -2370.0 18669.91 73.99
5 -2360.0 18466.89 66.94
6 -2350.0 19887.04 56.34
...
476 2350.0 20757.54 55.94
477 2360.0 19309.42 43.72
478 2370.0 18931.11 36.74
479 2380.0 20227.05 26.16
480 2390.0 20286.32 11.16
481 2400.0 18806.63 -0.35
============================================
1 -2400.0 9577.88 100.81
2 -2390.0 10277.84 91.69
3 -2380.0 10651.21 76.99
4 -2370.0 10047.17 64.06
5 -2360.0 9808.13 56.79
6 -2350.0 10542.97 46.88
...
476 2350.0 11758.80 46.39
477 2360.0 11008.49 33.45
478 2370.0 10645.12 26.11
479 2380.0 11326.65 16.28
480 2390.0 11490.52 1.47
481 2400.0 10687.82 -10.73
1 -2400.0 3059.55 100.78
2 -2390.0 3280.26 91.73
3 -2380.0 3405.67 77.16
4 -2370.0 3229.52 64.22
5 -2360.0 3162.23 56.55
6 -2350.0 3382.37 46.33
...
476 2350.0 3720.13 46.79
477 2360.0 3497.08 33.65
478 2370.0 3379.61 26.01
479 2380.0 3578.18 16.07
480 2390.0 3615.54 1.41
481 2400.0 3361.39 -10.51
1 -2400.0 -322.27 1699.33
2 -2390.0 -57.49 1852.45
3 -2380.0 422.54 1881.74
4 -2370.0 795.59 1657.96
5 -2360.0 1002.64 1502.52
6 -2350.0 1342.41 1376.20
...
476 2350.0 1417.02 1525.49
477 2360.0 1634.68 1091.80
478 2370.0 1709.40 824.63
479 2380.0 1924.21 541.16
480 2390.0 2010.37 42.11
481 2400.0 1836.94 -337.48