AIPS NRAO AIPS HELP file for XPLOT in 31DEC25



As of Fri Apr 18 23:48:22 2025


XPLOT: Plots image rows on the TV, TEK screen or plot file

INPUTS

INNAME                             Input image name (name)
INCLASS                            Input image name (class)
INSEQ             0.0     9999.0   Input image name (seq. #)
INDISK            0.0        9.0   Input image disk unit #
BLC                                Bottom left corner of input
TRC                                Top right corner of input
YINC              0.0      128.0   Do every YINCth row
ZINC              0.0      128.0   Do every ZINCth plane
FLUX              0.0              Flux cutoff (see HELP)
PIXRANGE                           Min,Max of image intensity
                                     Max <= Min => entire range
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 map pixels
PIXVAL           0.0               Display if peak < PIXVAL
DOTV            -2.0         2.0   -2  => use TEK screen
                                   <= 0 => make plot file
                                   > 0 => use TV
                                   2 => use TV old method
GRCHAN           0.0         7.0   Use this TV graphics channel
                                   0 -> 1
XYRATIO          0.0               Stretch the X axis wrt Y axis

HELP SECTION

XPLOT
Task:  Plots image rows one at a time on the graphics (TEK) or TV
       window or device.  This may be useful to review spectral-line
       data cubes, particularly before using XGAUS on them.  There
       are 4 modes, quick plots on the TV (DOTV=2), slightly slower
       plots of the TV (DOTV=1), plot files (DOTV=0 or -1), and
       quick plots on the Tektronix emulator window (DOTV=-2).
       After each plot in DOTV -2 and 2 modes, the task prompts you
       for permission to continue.  Enter Q or q to quit or just hit
       RETURN to procede.  In DOTV=1 mode, hit TV buttons B or C to
       procede of D to quit.

       If the X axis is FQID, XPLOT will plot the values as FQID
       rather than at the correct frequencies.  Transpose your image
       to put the input X axis as the 3rd axis and use ISPEC to get
       plotting at correct frequencies.
Adverbs:
  INNAME.....Input image name (name).      Standard defaults.
  INCLASS....Input image name (class).     Standard defaults.
  INSEQ......Input image name (seq. #).    0 => highest.
  INDISK.....Disk drive # of input image.  0 => any.
  BLC........Bottom right corner in input image of desired
             subimage.  Default is entire image.
  TRC........Top right corner in input image of desired
             subimage.  Default is entire image.
  YINC.......Do only every YINC'th row (beginning at BLC(2)).
  ZINC.......Do only every ZINC'th plane (beginning at BLC(3)).
  FLUX.......A flux cutoff in the same units as the input image
             (i.e. Jy/beam).  If a row does not have three
             consecutive points above this level, no plot is
             done.  0 means 0 in this case,
  PIXRANGE...Min,Max of Image intensity.  0,0 => min,max of EACH
             row (separately).
  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.
  PIXVAL.....Plot row only if the peak value < PIXVAL.  Limits
             the total number of plots.  0 -> 100000.
  DOTV.......<= -2 => Use the TEK (Tektronix emulator) terminal
             -2 < DOTV <= 0  -> make plot file(s)
             > 0   => Use the TV screen
  GRCHAN.....If using the TV, the graphics channel to use.  0 -> 1.
  XYRATIO....The ratio of the axes X to Y in the plot.  1.0 makes a
             square plot.  0 -> 1.4 (about the usual ratio of X to Y
             on the TV screen or A format paper).

EXPLAIN SECTION


AIPS