home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d523 / psgraph.lha / PSGraph / PSGraph.doc < prev    next >
Text File  |  1991-08-05  |  5KB  |  164 lines
  1.  
  2.                                PSGRAPH  V 1.0
  3.                     By Rick Golembiewski Wed Jun 12 1991.                  
  4. PSGraph is a program that I wrote because I didn't have any descent graphing 
  5. programs for my amiga.  Note that this is the first release of the software, 
  6. but it is fairly stable, I've been using it for about a year now.  It works 
  7. under 1.3 or 2.0 (tested on a A1000 (2.5MB) and an A3000 (6MB) ).
  8.  
  9. These docs are a bit skimpy, but they will give you enough info to make plots.
  10. Note that I designed the program around curses so that I could run it on UNIX
  11. machines, thus it lacks some of the neat amiga specific interface but it is
  12. very usable after a bit of practice.
  13.  
  14.  
  15. Thanks to Simon John Raybould for providing the amiga with a very solid curses
  16. library, that has made development of this program for the amiga much easier.
  17.  
  18. I'm releasing this program as shareware, if you find it useful then send any
  19. donations, also if you have any bug reports or suggestions for improvement
  20. you can send them to:
  21.  
  22. Rick Golembiewski
  23. 1825 Taper Dr.
  24. Pittsburgh PA 15241.
  25.  
  26. EMail: rg20@andrew.cmu.edu
  27.  
  28. Note that receiving donations will motivate me to put more features and/or fix
  29. any bugs.  Additionally if you donate $15 or more more I will keep you name and
  30. address and send you a copy of any new revisions.
  31.  
  32.  
  33. There are two main sections of the program, the first is the data section,
  34. which shows a number of columns into which you can input data, do calculations,
  35. etc.  The second section is the plotting section, where you define what you 
  36. want a graph to look like and then you can either get a graphic preview or do 
  37. a postscript plot.
  38.  
  39.                              Installation
  40. The program can be run from the CLI by typing
  41. 6.psgraph:> run psg
  42.  
  43. Note that it will look in the default directory for the file called 
  44.  
  45. psg.keys
  46.  
  47.  
  48. This file contains the key bindings, if no file is present the default
  49. key bindings are used.
  50.  
  51.  
  52. In order to create postscript output, the program needs to be able to find
  53. the file containing the postscript functions fun.ps.  This file should be in a 
  54. directory grf:
  55.  
  56.  
  57. ie
  58.  
  59. assign grf:   df0:psgraph
  60.  
  61.  
  62.  
  63.  
  64.                              Data  Section
  65. When in the data section typing a number and then <return> will enter the 
  66. number into the bracketed cell ie <     >, pressing <ESC> instead of <return> 
  67. aborts the change.
  68.  
  69. Note that psg.keys is a file that allows rebinding the commands, the default 
  70. bindings are listed here:
  71.  
  72.  
  73. 'C' linear least squares curve fitting
  74.  
  75. 'D'  Delete data (bank a single cell, delete cell, or entire column)
  76.  
  77. To move the marked cell:
  78.                        'I'  Up
  79.              left 'J'       'K'  right
  80.                       'M'  Down
  81.  
  82. 'E'  insert rows or cols
  83.  
  84. 'F'  Single place functions (ie Sin Cos Tan Log ln exp ...) This also includes
  85.      a few odd functions like Weighted Mean (calculates the mean favoring the
  86.      values with the smallest errors), and difference (takes a column and 
  87.      subtracts the value 0 from value 1 etc.)
  88.  
  89. 'L'  Label a column of data
  90.  
  91. 'N'  Invert a column of data
  92.  
  93. 'O'  re Order columns, exchanges two column positions
  94.  
  95. 'P'  Plot -> select data then go to plotting section.
  96.  
  97. 'Q' Quit
  98.  
  99. 'R' Read file
  100.  
  101. 'S'  Statistics (mean,summation Standard Dev (n & n-1),range 95% confidence)
  102.  
  103. 'T'  Two place functions (ie + - * / power )
  104.  
  105. 'V'  fill a col with a constant number (useful for filling in a common error)
  106.  
  107. 'W' Write file
  108.  
  109. 'Z'  resize columns (default size is 16 chars wide)
  110.  
  111.  
  112.  
  113.  
  114.                                Plotting Section
  115.  
  116. The '>' marks the data slot, pressing 'E' will edit the data (<ESC> instead of
  117.  <return> aborts changes)
  118.  
  119. Title    : Title of graph
  120. XLabel   : X Axis label of graph
  121. YLabel   : Y Axis label of graph
  122. XMin     : Minimum X value (graph coordinates)
  123. XMax     : Maximum X value (graph coordinates)
  124. YMin     : Minimum Y value (graph coordinates)
  125. YMax     : Maximum Y value (graph coordinates)
  126. Marking  : integer 1-7 indicating symbol to mark data with:
  127.   1 = square
  128.   2 = circle
  129.   3 = up pointing triangle
  130.   4 = 'X'
  131.   5 = diamond
  132.   6 = down pointing triangle
  133.   7 = star
  134.  
  135. X Grids  : # of grid lines on X axis
  136. Y Grids  : # of grid lines on Y axis
  137. X Labels : # of labels on X axis
  138. Y Labels : # of labels on Y axis
  139. SXMin    :Min X screen coordinates in inches
  140. SXMax    :Max X screen coordinates in inches
  141. SYMin    :Min Y screen coordinates in inches
  142. SYMax    :Max Y screen coordinates in inches
  143.  
  144. 'F' to select a column of polynomial coefficients to add to plot (ie generated
  145.     by the least squares fit).
  146.  
  147. 'P' plot the data to a file (currently postscript is the only supported output)
  148.  
  149. 'G' Graphic preview (amiga hi-res screen), This function generates a graphic 
  150.     view of the plot, there are some small differences between this output and
  151.     the postscript output, mainly the Y axis label and numbering is written
  152.     vertically in postscript, however since rotating text is not trivial and 
  153.     the font sizes on the amiga are a bit too large the preview has all text 
  154.     horizontal.
  155.  
  156. 'Q' or <ESC> returns to the data section.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.