AIPS HELP file for PLCUB in 31DEC24
As of Wed Apr 24 19:20:11 2024
PLCUB: Task to plot intensity vs x panels on grid of y,z pixels
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. #)
INDISK 0.0 9.0 Disk drive #
BLC 0.0 4096.0 Bottom left corner of image
0=>entire image
TRC 0.0 4096.0 Top right corner of image
0=>entire image
YINC 0.0 256.0 Increment on 2nd axis to plot
ZINC 0.0 256.0 Increment on 3rd axis to plot
PIXRANGE Range of intensities to plot
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
APARM 1: panels/page in x-direction
0=> MIN (TRC(2)-BLC(2+1,5)
2: panels/page in y-direction
0=> final value of APARM(1)
3: LTYPE for panels 0=>LTYPE
< -10 => no panel labeling
4: y-value x-axis: no default
5: x-value y-axis: no default
6: x-axis Hanning smooth
length (odd integer >=3)
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
PLCUB
Type: Task
Use : Task to repeatedly plot the pixel value as a function of
the coordinate along the first axis in different panels.
Each panel is positioned in a larger frame, with the
coordinate along the second axis in the cube as x-axis,
and the coordinate along the third axis in the cube as
y-axis. The first axis may be Hanning smoothed before
plotting.
Example :
Given a spectral line cube, the spectrum per point in the
sky is plotted by first applying TRANS so that frequency
(velocity) is along axis # 1, R.A. along # 2, and Dec.
along # 3. Then use PLCUB on this cube.
Adverbs:
USERID......User ID of owner of image. Ignored
INNAME......Image name(name). blank => any
INCLASS.....Image name(class). blank => any
INSEQ.......Image name(seq. #). 0 => any
INDISK......Disk drive # of image. 0 => any
BLC.........The Bottom Left-hand pixel of the subarray of
the image to be plotted. The value (0,0,...)
means (1,1,1,1,1,1,1).
TRC.........The Top Right-hand pixel of the subarray of
the image to be plotted. The value (0,0,...)
means the top right hand corner of the entire
image.
YINC........Increment between plotted pixels on 2nd axis.
ZINC........Increment between plotted pixels on 3rd axis.
PIXRANGE....Range of pixel values to plot; values below
PIXR(1) are set to PIXR(1), values above PIXR(2)
are set to PIXR(2). PIXR(1) >= PIXR(2) implies
use the full range of pixel values in the image.
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.
APARM.......(1) Number of plots panels/page in x direction.
default = min (TRC(2)-BLC(2)+1, 5)
(2) Number of plots panels/page in y direction.
default = resulting APARM(1)
(3) Labeling type for the individual panels.
Same meaninings as LTYPe and 0 => LTYPE.
If <= -11, then the individual panel labeling is
omitted.
(4) The y-value at which the x-axis intersects
the y-axis within each panel. If intensity
is plotted, 0 is the obvious choice.
(5) The x-value at which the y-axis intersects
the x-axis within each panel. A crazy value
is reset to the left edge of each panel.
There is no other default, however.
(6) The number of points in the Hanning smooth
kernel for the first (x) axis. Must be an odd
integer >= 3.
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.
Notes :
1) The plane is filled in such a way that there are APARM(1)
panels in the x-direction and APARM(2) panels in the
y-direction. If the area specified by APARM is larger than
APARM(1),APARM(2) the plot is spread out over several pages.
2) The position of a panel in the larger frame is defined as
the left hand end of the x axis in each panel.
3) The Hanning smoothing option does not attempt to deal
with blanked pixels. If a blank is encountered in a row,
the unsmoothed row is plotted instead and a vague message
is output to the message terminal.
EXPLAIN SECTION