home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / grafik / coregraf / graph.doc < prev    next >
Encoding:
Text File  |  1986-01-06  |  4.7 KB  |  113 lines
  1. NAME
  2.     graph - plot a tabulated function
  3.  
  4. SYNOPSIS
  5.     graph [file] [options]
  6.  
  7. DESCRIPTION
  8.     Graph with no options takes pairs of points (two numbers per line) from
  9.     the given file (or standard input) as x- and y- values and plots them
  10.     on the screen, connected by straight lines.  A string surrounded by
  11.     quotes "..." may follow a pair of points, and will be displayed
  12.     starting at that point.  If an input file is specified, the program
  13.     waits for a keypress, then resets the screen parameters and clears the
  14.     screen before exiting.  If the data comes from the standard input, the
  15.     program exits without clearing the screen or resetting it.
  16.  
  17.     On the Z-100, both 225*640 and 400*640 modes are supported.  The mode
  18.     is specified by setting the environment variable GRAPHICS before
  19.     running graph:
  20.  
  21.         SET GRAPHICS=1         ; 225*640 mode (the default)
  22.         SET GRAPHICS=2         ; 400*640 mode
  23.  
  24.     Similarly, the following modes are supported on the IBM PC:
  25.  
  26.         SET GRAPHICS=4        ; 200*320 color mode
  27.         SET GRAPHICS=5        ; 200*320 grey scale mode
  28.         SET GRAPHICS=6         ; 200*640 monochrome mode (the default)
  29.  
  30.     The terminology above is IBM's, but note that a color monitor
  31.     connected to the 15 pin connector on the IBM color graphics adaptor
  32.     will display color if the graphics mode is set to either 4 or 5.  A
  33.     color monitor connected to the RCA jack will display only a grey
  34.     scale in mode 5.
  35.  
  36. OPTIONS
  37.  
  38. -a  [<step> [<start>]]  Automatically generate abscissas.  The first argument,
  39.         if present, is the step between values (default 1).  The second
  40.         argument, if present, is the starting value (default 0, or
  41.         first argument from -x switch).
  42.  
  43. -b break (disconnect) the plot after each label.  (See switch -m to make the
  44.         line segments different.  To break the plot without printing
  45.         labels, use empty labels: "".)
  46.  
  47. -c <text>    argument is default label for data points
  48.  
  49. -g <style> argument is grid style: 0 for no grid, 1 for frame with tic marks
  50.         (default), 2 for full grid.
  51.  
  52. -l <text>    next argument is label for graph (printed at top)
  53.  
  54. -m <n1> <n2> <n3>...  numeric arguments are linestyles for successive line
  55.         segments (see switch -b).  If an argument is zero, the data
  56.         points are plotted as dots not connected by lines.  Otherwise,
  57.         each positive argument is a number of up to three digits WCS,
  58.         where W is the linewidth (0-9, with 0 giving width 1), C is the
  59.         color (with 0 being brightest), and S is linestyle (1-5, 1 for
  60.         solid, 2 for dashed, 3 for dotted, etc.) Similarly, negative
  61.         arguments generate markers of different colors and/or styles
  62.         (box, cross, triangle, etc.).
  63.  
  64. -n        Omit numeric labels on axes (uses more of the screen for the
  65.         graph, therefore effectively increases resolution slightly).
  66.  
  67. -t        Transpose x and y values before plotting (-x now refers to
  68.         vertical axis).
  69.  
  70. -x[l] [min [max [junk]]] If l is present, x axis is logrithmic. First argument,
  71.         if present, is lower x limit.  Second argument, if present, is
  72.         upper x limit.  A third numeric argument may be present but
  73.         will be ignored.  By default, these values will be determined
  74.         automatically.
  75.  
  76. -y[l] [min [max [junk]]]  Similarly for y axis
  77.  
  78. -h  <n>        argument is the fraction of the vertical space to be used for
  79.         the graph.
  80.  
  81. -u  <n>        argument is the fraction of the vertical space to move up
  82.         before plotting.
  83.  
  84. -w  <n>        argument is the fraction of the horizontal space to be used
  85.         for the graph (useful if screen dump routine doesn't dump the
  86.         entire width of the screen).
  87.  
  88. -r  <n>        argument is the fraction of the horizontal space to move right
  89.         before plotting.
  90.  
  91. NOTES
  92.     Graph is largely equivalent to the program of the same name on Unix,
  93.     with the following exceptions: Data may come from a file rather than
  94.     the standard input.  Line segments that go out of bounds are windowed
  95.     rather than being dropped.  Graph may adjust the specified lower or
  96.     upper limits (outwards) to give convenient axis labels.  Steps along
  97.     axes may not be specified.  The screen is always cleared before
  98.     plotting.  The default grid type is frame with tics rather than full
  99.     grid.  Axes may not be reversed by specifying a lower limit greater
  100.     than the upper limit.
  101.  
  102. BUGS
  103.     Clearing the screen is mandatory before each plot.
  104.  
  105.     If the data comes from the standard input, the screen parameters are
  106.     not reset after plotting.  On the Z-100, the keyboard is left with key
  107.     expansion disabled.  (These conditions can be corrected by running
  108.     graph again and specifying a file).
  109.  
  110. AUTHOR
  111.     Copyright (c) 1985 by James R.  Van Zandt (jrv@mitre-bedford) 27
  112.     Spencer Dr., Nashua NH 03062, 603-888-2272.  Resale forbidden, copying
  113.     for personal use encouraged.  Constructive comments welcome.