; PLOTR
;---------------------------------------------------------------
;! Basic task to generate a plot file from text input
;# TASK PLOT
;-----------------------------------------------------------------------
;;  Copyright (C) 1999, 2001, 2003-2005, 2008
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
PLOTR     LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
PLOTR:  Task to generate a plot file from text file
USERID     -32000.0     32000.0    User ID. 0 => current user
                                     32000 => any user.
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 value range
                                   f(7) [(5)*X + (6)] on x axis
                                   f(10)[(8)*Y + (9)] on x axis
                                   See help
BPARM                              (1-10) Symbol types (0->24)
CPARM                              (1-10) Line types (0->..)
FACTOR                             Scale symbol sizes
DOCOLOR                            > 0 => color column contains
                                   values to use
LTYPE         -10.0        10.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.
----------------------------------------------------------------
PLOTR
Type: Task
Use:  PLOTR will write commands to a plot file for the execution
      of a ????? plot for an arbitrary data file.  Up to 10 types of
      data may be in the input text file, each of which may be plotted
      with a selected plot symbol (or omitted).
Adverbs:
  USERID......The ID of the owner of the image.  0 => current
              user.  32000 => any user.
  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 plot strings and plot data (see
              EXPLAIN).
  APARM.......(1,2) X plot range.  If APARM(2) <= APARM(1), self scale.
              (3,4) Y plot range.  If APARM(2) <= APARM(1), self scale.
                 These are after any scaling, functions in APARM
              Scale and apply function to X and Y values:
              On x axis plot function in APARM(7) of the value
                 APARM(5)*X+APARM(6)
              On y axis plot function in APARM(10) of the value
                 APARM(8)*Y+APARM(9)
              APARM(5)=0 => 1; APARM(8)=0 => 1
              Function types:
                 0  none (linear)
                 1  log
                 2  log10
                 3  exp
                 4  ** 2
                 5  ** 3
                 6  ** 0.5
                 7  ** 0.333
                 8  ** (-1)
                 9  ** (-0.5)
  BPARM.......(1-10) Plot symbol number for data of type 1-10, resp.
              You may have both a symbol and a line for each type
              0: No symbol plotted for this type
              1: Plus sign             12: Five pointed star
              2: Cross (X)             13: Star of David
              3: Circle                14: Seven-pointed star
              4: Box                   15: Eight-pointed star
              5: Triangle              16: Nine-pointed star
              6: Diamond               17: Ten-pointed star
              7: Pentagon              18: 11-pointed star
              8: Hexagon               19: 12-pointed star
              9: Septagon              20: 13-pointed star
              10: Octagon              21: 14-pointed star
              11: Nine-gon             22: Plus with gap
                                       23: Vertical line
                                       24: Cross (X) with gap
  CPARM.......(1-10) Line type number for data of type 1-10, resp.
              You may have both a symbol and a line for each type
              0: No line plotted for this type
              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 (CPARM(I)-2 breaks between points)
  FACTOR......Symbol size multiplier; 0 -> 1.
  DOCOLOR.....> 0 => each symbol will be drawn with a color from blue
              to red as the color column value ranges from 0 to 1 or
              as line "types" 1,2,3,4 as the color column contains
              values 2,3,4,5 (resp).  Note that, by default, line type
              1 is used for labeling, line type 2 is used for
              connected lines, line type 3 for connected step lines,
              and line type 4 for symbols.
  LTYPE.......Labelling type: 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.
  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.
----------------------------------------------------------------
PLOTR: Task to create a ?????-plot extension file
DOCUMENTOR: ??? Put your name here ???
RELATED PROGRAMS: PCNTR,PRTPL,TKPL,TVPL,TVWIN

                           PURPOSE

     PLOTR generates a plot extension file containing an ???? plot,
its border, and labels.  The plot itself may be displayed on a
printer, TEK screen, or TV graphics channel by the tasks PRTPL, TKPL,
or TVPL respectively.

                          COMMENTS

The INTEXT text file begins with 15 lines of text containing

   Line        Contents
     1      Plot title (at top of plot)
     2      Bottom line #1
     3      Bottom line #2
     4      X-axis label (<= 20 chars)
     5      Y-axis label (<= 20 chars)
     6      Symbol label, data type -1
     7      Symbol label, data type -2
     8      Symbol label, data type -3
     9      Symbol label, data type -4
    10      Symbol label, data type -5
    11      Symbol label, data type -6
    12      Symbol label, data type -7
    13      Symbol label, data type -8
    14      Symbol label, data type -9
    15      Symbol label, data type -10

Then 1 line per data point for up to a total of 16384 points for 10
types giving X(i) Y(i) Type(i), where Type is an integer from 1
through 10.  Type 0 (or blank) -> type 1.  Negative types use the same
symbol as their positives but also plot the string given at the
beginning of the file.  Thus they are normally used for annotation is
some otherwise blank part of the plot.

At any point in the input file you may insert comment lines.  Any line
starting with $ or # is taken as a comment and ignored.

Example input file


#                               Example input file for noise tests
Frequency switch noise tests
Gaussian widths 25, 25, 50, 257 channels
Peak = 100, noise = 3 degrees
#                               axis units follow
Total throw (chans)
Non-signal soln rms
#                               symbol labels follow
1024-channel, 4 Gaussian
512-channel, 3 Gaussian
512-channel, 4 Gaussian (incl wide)







$                               data points follow
  8  11.59  2
  8  11.81  3
  8  18.52
 10  10.88  3
 10  14.99
 16   9.21  2
 16  10.47  3
 16  11.61
 20   7.97  3
 20  10.60
 20  10.93
 24   7.36  3
 24   7.50  2
 24   9.44
 30   6.99  3
 30   9.00
 32   6.08  2
 32   6.22  3
 32   8.10
 40   5.37  2
 40   5.49  3
 40   5.91  3
 40   7.22
 40   7.52
 48   4.98  2
 48   5.00  3
 48   7.06
 50   5.15  3
 50   6.68
 56   4.32  3
 56   4.58  2
 56   6.49
 60   4.70  3
 60   6.14
 60   6.23
 64   4.28  2
 64   4.45  3
 64   6.05
 70   4.18  3
 70   5.63
 72   3.90  2
 72   4.20  3
 72   5.65
 80   3.67  2
 80   3.91  3
 80   4.29  3
 80   5.31
 80   5.41
 88   3.44  3
 88   3.62  2
 88   5.16
 90   3.84  3
 90   4.94
 96   3.45  2
 96   4.10  3
 96   4.81
100   3.58  3
100   4.79
100   4.95
100  22.50  -3
100  23.50  -2
100  24.50  -1
104   3.34  2
104   3.89  3
104   4.79
110   3.55  3
112   3.20  2
112   3.82  3
112   4.47
120   3.13  2
120   3.43  3
120   3.82  3
120   4.49
128   2.91  2
128   3.00  3
128   4.26
130   2.97  3
136   2.91  2
136   3.42  3
136   4.07
140   3.20  3
140   4.08
144   2.83  2
144   3.74  3
144   3.95
150   3.70  3
152   2.82  2
152   3.82  3
152   3.89
160   3.46  3
170   2.89  3
180   2.61  3
180   3.52
190   2.97  3
200   3.59  3
210   4.92  3
220   3.23
220   3.84  3
230   3.11  3
240   2.99  3
250   2.51  3
260   2.24  3
260   2.98
270   2.35  3
280   2.35  3
290   2.06  3
300   2.07  3
300   2.75
310   2.13  3
320   2.25  3
330   2.20  3
340   2.62
340  26.27  3
350  19.17  3
360  14.17  3
370  14.67  3
380   2.40
380   9.75  3
390   6.36  3
400   5.59  3




