As of Tue Jun 18 19:24:31 2024

PLCUB: Task to plot intensity vs x panels on grid of y,z pixels


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.


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
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.
  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
  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
              (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.