home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / bus_pers / listplot.lha / Readme < prev    next >
Text File  |  1990-10-27  |  8KB  |  212 lines
  1. ABOUT LISTPLOT
  2.  
  3. ListPlot is a 2D plotting program built around the PLPLOT plotting library.
  4. Although working directly with the PLPLOT library routines is more
  5. flexible, ListPlot is quite powerful.  
  6.  
  7. ListPlot was ported from a UNIX program written by myself and (mainly)
  8. Rick Bartram. It reads from stdin and writes to stdout unless input
  9. and/or output files are specified on the command line. (Reading from
  10. stdin is of dubious value on the Amiga, since the standard shell does
  11. not support pipes.) The program accepts a file of n-tuples. Each tuple
  12. consists of space-separated numbers terminated with a newline. The
  13. first element of each tuple is the independent variable. Each remaining
  14. variable is plotted against the first to produce n-1 curves.
  15.  
  16. Linear-linear, linear-log, log-linear, log-log, and polar graphs are
  17. supported.
  18.  
  19. ListPlot supports several output devices. By default the graph is drawn
  20. in a window on the Amiga's screen. With command line options the graph
  21. can be 
  22.   1) sent to any preferences printer with graphics capability
  23.   2) stored as an IFF file
  24.   3) stored in HPGL format
  25.   4) stored in Aegis Draw format
  26.   5) stored as an Encapsulated Postscript File.
  27.  
  28. A variety of line styles and colors are available.
  29.  
  30. Overlining, underlining, subscripting, superscripting, and greek
  31. characters can be used within labels.
  32.  
  33.  
  34. INSTALLATION
  35.  
  36. Copy ListPlot to a directory in your path. The file plstnd.fnt
  37. contains the fonts that ListPlot uses.  It looks for this file in
  38. plfonts:plstnd.fnt. So you need to store this file in a convenient
  39. directory and make the appropriate assign.
  40.  
  41.   Example:
  42.     makedir sys:plfonts
  43.     copy plstnd.fnt sys:plfonts
  44.     assign plfonts: sys:plfonts
  45.  
  46. You'll probably want to add the "assign" command to your startup sequence.
  47. (plstnd.fnt is the same as that used in the most recent versions
  48. (3.0 or higher) of PLPLOT)
  49.  
  50. ListPlot uses the FFP math libraries supplied by Commodore, so make
  51. sure the mathtrans.library file is in your libs: directory.
  52.  
  53. The PLPLOT library uses the palette program that comes with the
  54. WorkBench 1.3 enhancer package as a color requester. PLPLOT looks for
  55. this program in tools: and, if it's not there, it looks in sys:tools.
  56. You'll probably want to assign" tools: to the directory in which the
  57. palette program resides. (At least until you get the colors set the
  58. way you want them.)
  59.  
  60.  
  61.  
  62. TRYING OUT LISTPLOT
  63.  
  64. Because of the large number of command line options, it usually easiest
  65. to create simple shell scripts to call ListPlot. Some example
  66. scripts are provided in the examples directory. (These are standard 
  67. Amiga shell scripts). To test out ListPlot, try one or all of the 
  68. following
  69.  
  70.    execute lineplot lineinput
  71.    execute logplot loginput
  72.    execute polarplot polarinput
  73.  
  74.  
  75.  
  76. THE DEVICE DRIVERS
  77.  
  78. The device drivers are those provided by PLPLOT.  I've excerpted the
  79. following descriptions from the PLPLOT distribution.
  80.  
  81.  Amiga window
  82.  
  83.    You can resize the window while the program is plotting in the
  84.    window (see the "Redraw Enabled" section below).  
  85.    Use the close gadget to close the window and exit ListPlot.
  86.  
  87.    "Plplot" menu selections:
  88.  
  89.        "Save Configuration"
  90.           - Saves current window configuration (window size, screen type,
  91.             screen depth, colors, resolution, etc.). The configuration
  92.             is saved in s:Plplot.def (only 54 bytes).
  93.  
  94.        "Reset"
  95.           - Resets the window to the configuration in s:Plplot.def
  96.             (or to a default config if this file doesn't exist).
  97.  
  98.        "Maintain Plot Aspect"
  99.           - If this is checked the plot aspect ratio is maintained as the
  100.             window is resized (handy for polar plots, etc.). Default
  101.             is unchecked in which case x and y are stretched
  102.             independently to fit in the window.
  103.  
  104.        "Redraw Enabled"
  105.           - If this is checked, then the graphics commands are buffered
  106.             in t:plplot.dat. This file is used to redraw the plot when
  107.             required. It's status is checked only when a new graph is
  108.             started. The buffer is also used to create the "Full Page"
  109.             prints under the "Print" selection.
  110.  
  111.        "Select Screen Type"
  112.           - A submenu allows the user to select either "Workbench" or
  113.             "Custom".
  114.  
  115.        "Print"
  116.           - There are three submenu options here. The "Bitmap Dump"
  117.             does just that (with full preferences support). The
  118.             output is pretty jagged, but you can play around with
  119.             the preferences stuff (scaling, smoothing, etc.) to
  120.             improve things. The other two submenus are
  121.             "Full Page (Landscape)" and "Full Page (Portrait)". This
  122.             uses the graphics buffer file (see "Redraw Enabled" above)
  123.             to create graphics output similar to the preferences
  124.             driver. However the aspect ratio can not be maintained.
  125.             Same preferences options are used as in preferences driver.
  126.  
  127.        "Save Bitmap as IFF File"
  128.           - Self explanatory. You can use this to save your images and
  129.             then touch them up (do area fills, etc.) with your favorite
  130.             paint program.
  131.  
  132.    "Screen Format" selections: (This menu only appears on the custom screen)
  133.        "Interlaced"
  134.        "High Resolution"
  135.        "Number of Colors"
  136.        "Set Color Palette"
  137.           - I think these are all self-explanatory. You can select either
  138.             2, 4, 8, or 16 colors.
  139.  
  140.  
  141.  
  142.  Preferences
  143.  
  144.    The preferences driver creates a black and white graph on your
  145.    preferences supported printer. It uses the preferences selected
  146.    density and page size limits and ignores most of the other stuff.
  147.    If you have selected "ignore" in the page size limit options
  148.    (see the 1.3 Enhancer manual) then a full page graph is produced.
  149.    The other options operate as described in the Enhancer manual.
  150.    Only "ignore" and "bounded" produce aspect ratio correct plots
  151.    (usually unimportant unless x and y must have the same scaling
  152.    like for pie charts or polar plots). You can get very high quality
  153.    plots with this driver. A full page, high resolution plot
  154.    requires a lot of memory though (An 8"x10" 300 dpi plot requires
  155.    (8*300)*(10*300)/8 = 900000 bytes).  You can use the page limits
  156.    to reduce the memory requirements and still get high quality
  157.    output.
  158.  
  159.  
  160.  iff
  161.  
  162.    The IFF driver will prompt for resolution and page size.
  163.  
  164.  
  165.  hp 
  166.  
  167.    The plt: device is an HP plotter compatible device handler written by
  168.    Jim Miller and Rich Champeaux. It is freely redistributable, but
  169.    it is not included with this package (it's big enough already!).
  170.    It gives high quality output like the preferences driver but with
  171.    full preferences support. Usually requires less memory (for full
  172.    page plots) than the preferences driver, but is slower. Highly
  173.    recommended if you have a color printer or are memory strapped.
  174.    I don't know exactly which model HP plotter this is compatible
  175.    with (the HP7470 I think).
  176.  
  177.  
  178.  aegis
  179.  
  180.    I created this one because I have Draw2000 and it was easy to do.
  181.    This provides a very convenient method for touching up simple
  182.    graphs with paint-like tools.
  183.  
  184.  
  185.  postscript
  186.  
  187.    Encapsulated PostScript File.
  188.  
  189.  
  190.  
  191.  
  192. THINGS YET TO BE DONE
  193.  
  194. There may be a 3D/contour version of ListPlot if there is enough interest.
  195. (PLPLOT does 3D and contour plotting and so the extension to ListPlot should
  196. be fairly simple.)
  197.  
  198.  
  199. REPORT BUGS TO
  200.    
  201.    Tony Richardson
  202.  
  203.    EMAIL   amr@dukee.egr.duke.edu       (Internet address)
  204.  
  205.    USMAIL  Tony Richardson              Tony Richardson
  206.            Dept of Elect Eng            311 S. LaSalle St. #41B
  207.            Duke University              Durham, NC 27705
  208.            Durham, NC 27706
  209.  
  210.            ph 919-660-5262              ph 919-286-7101
  211.  
  212.