AIPS NRAO AIPS HELP file for GCPLT in 31DEC25



As of Mon Dec 9 12:20:55 2024


GCPLT: Task to plot selected contents of gain curve files

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
BAND                               Q,A,K,U,X,...
CALIN
                                   Antenna gains file
ANTENNAS                           Antennas to plot 0=>all
PIXRANGE                           Range to plot: 0 => self
                                   scale each antenna separately
NPLOTS            0.0      28.0    Number of plots per page
DO3COLOR           -1.0        1.0   > 0 use 3-color symbols to
                                   separate frequencies within
                                   selected band
LTYPE        -410.0       410.0    Type of labeling: 1 border,
                                   2 no ticks, 3 - 6 standard,
                                   7 - 10 only tick labels
                                   <0 -> no date/time
DOTV           -1.0         1.0    > 0 Do plot on the TV, else
                                   make a plot file
GRCHAN          0.0         8.0    Graphics channel

HELP SECTION

GCPLT
Type:  Task
Use:   Plots selected values from gain curve text file

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.
  BAND.......Desired band:'4','P','L','S','C','X','U','K','A', or 'Q'.
  CALIN......The name of a file to provide the antenna gains used to
             populate the initial CL table.  If CALIN is left blank,
             it defaults to a system file located at:
                    'AIPSIONS:VLA.GAINS'   (old VLA) or
                    'AIPSIONS:EVLA.GAINS'  (EVLA)
             The file is in free format with fields: a 1-character
             band code, antenna number, begin date in form YYYYMMDD,
             end date YYYYMMDD, and 4 gain curve coefficients.  The
             EVLA file adds a column between band and antenna for the
             frequency in MHz.
  ANTENNAS...A list of the antennas to be plotted. All 0 => all.  If any
             number is negative then all antennas listed are NOT to be
             plotted and all others are.
  PIXRANGE...If PIXR(1) < PIXR(2), all plots will be from PIXR(1) to
             PIXR(2).  Otherwise each plot will be self-scaling.
  NPLOTS.....Number of antennas to plot per page (try 5).
  DO3COLOR...> 0 => use 3-color plotting to separate frequencies:
                 If there are more than 3 frequencies, then the colors
                 used start with red and go through green to blue for
                 the last frequency read in the text file.
                 If there are 3 or fewer, then line types 2 through 4
                 are used.  If plotted on the TV, these are grean,
                 pink, and cyan, 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.
             A value of 0 causes more than one graphics channel to be
             used.

EXPLAIN SECTION


AIPS