home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsp / pgplot / ReadMe < prev   
Text File  |  1994-10-21  |  5KB  |  120 lines
  1.            PGPLOT Version 4.9H for the Archimedes (version 4.9H-1)
  2.                         October 1994
  3.  
  4.   Distributed by 'Fortran Friends' P.O. Box 64, Didcot, Oxon OX11 0TH, UK.
  5.  
  6.   Email:  KMC@ISISE.RL.AC.UK
  7.  
  8.  PGPLOT is a portable Public Domain Fortran subroutine package for drawing
  9. simple scientific graphs. It runs on most mainframes on various graphics
  10. display devices and printers including inkjet and PostScript ones. It was
  11. originally developed for use with astronomical data reduction programs in
  12. the Caltech Astronomy department.  
  13.  
  14.  More information, copies of the Fortran of the most recent version, and
  15. implementations for other computer systems may be obtained from:
  16. *     Dr. T. J. Pearson
  17. *     105-24 California Institute of Technology,
  18. *     Pasadena, California 91125, USA
  19. *
  20. *     tjp@deimos.caltech.edu
  21.  
  22. If you do not have access to electronic mail, and want a copy of the 
  23. complete portable Fortran source of version 4.9H of PGPlot, and the text of
  24. the current manual (dated 1989) written in TeX input format, send  a blank,
  25. E format, 800K 3.5" floppy disk with a reply paid envelope to 'Fortran
  26. Friends' (address above) The data on that disc are compressed with !Squash,
  27. so you will need RISC-OS 3 to decompress them.
  28.  
  29. A contribution of £1.00 (or U.S.$2.00) towards administration costs would be
  30. appreciated, or if your address is outside Europe £2.00 (or U.S.$5.00).
  31. Double these prices if you want us to supply the disc and packaging. 
  32.  
  33.  The PGPlot library supplied on this disc has been compiled with Fortran
  34. Release 2 for the Archimedes. It must be installed on your Archimedes before
  35. you can compile the example programs supplied and run this package.
  36.  
  37.  Fortran Release 2 for Acorn computers is available for £99 (ex VAT) from:
  38.  
  39. * Intelligent Interfaces Ltd,     Tel.  (0703) 261514 
  40. * P.O.Box 80,                     Fax.  (0703) 267904
  41. * Eastleigh, 
  42. * Hants SO5 5YX, UK.
  43.              
  44. Distribution disc contents:
  45.  
  46. 1) The application !PGPlot:
  47.    contains the !Boot, !Run and !Sprites needed to set up the environment
  48.    for running PGPlot, together with the font file 'GRFont' and colour
  49.    information in 'RGBTxt'. The HelpPGPlot text file has helpful information
  50.    on the PGPlot functions in a format useable by !SrcEdit for on-line help.
  51.  
  52. 2) The Copyright notice for PGPlot. 
  53.  
  54. 3) 'Examples' directory with the Fortran of the 9 demo programs and an
  55.    explanation in the ReadMe.
  56.  
  57. 4) 'lib' directory with the PGPlot library, and two auxiliary libraries which
  58.    are PD utilities for primitive graphics and communication with the
  59.    operating system. 
  60.  
  61. 5) 'SYS_ARC' directory contains all the Archimedes specific code and
  62.    instructions on how to create a library for new versions of PGPlot
  63.    transferred electronically from the address above.
  64.  
  65. Installing this version:
  66.  
  67. 1) Copy the !PGPlot application to your working disc.
  68.  
  69. 2) Copy the library files in the 'lib' directory to the directory where you
  70.    keep Fortran libraries. Everyone should copy 'PGPlot'. If you have the
  71.    !Fortran77 front-end from Intelligent Interfaces, or the Shareware 44 PD
  72.    disc from Norwich Computer Services you will already have the other
  73.    files 'Graphics' and 'Utils', so may not need to copy them. 
  74.  
  75.    In the Shareware !Fortran77 front-end you must include the name of this
  76.    library in the 'LibList' file BEFORE the Graphics and Utils entries.
  77.  
  78. 3) Copy the Examples directory to your working disc. 
  79.  
  80. 4) If you have !SrcEdit and want to use the on-line help, append the lines:
  81.  
  82.         PGplot
  83.         none
  84.         <PGPLOT_DIR>.HelpPGPlot
  85.  
  86.    to the file 'choices.languages' within the !SrcEdit application.
  87.  
  88.    Then install !SrcEdit on the icon bar, click menu over its icon, and 
  89.    change the options, language, to tick PGPlot.
  90.  
  91.    If you have !DeskEdit you can replace one of the 3 help files in the
  92.    !DeskEdit.data directory with 'HelpPGPlot'.
  93.  
  94. 5) Edit the !Run file if you want to change any of the global variables
  95.    which set the default device type, screen colours etc.
  96.  
  97. Testing the installation:
  98.  
  99. 1) Before running any PGPLOT program, click on !PGPlot to set up the 
  100.    environment variables so that PGPLOT can find the fonts and colours.
  101.  
  102. 2) Select the screen mode for your plots by setting the MODE from the
  103.    RISC OS Desktop. This implementation of PGPlot is RISC OS compatible.
  104.    It finds the Desktop screen mode before exiting the Desktop, runs your
  105.    PGPlot program and returns to the Desktop on exit from your program.
  106.  
  107. 3) Now try to compile, link and run the test demo programs. 
  108.    Remember the 'PGPlot' library should be linked before the 'Graphics' and 
  109.   'Utils' because it references routines in them.
  110.  
  111.    Warning: Most of the demos run quickly, but PGDemo3 takes some time, 
  112.    over 20 minutes on an A4000 with an ARM250 chip, and longer on an A3000.
  113.  
  114.  
  115. Invitation:
  116.  
  117.  If you feel inspired to improve this Archimedes version, look in the
  118. 'AAReadme' in the SYS_ARC directory for advice, and please send any
  119. enhancements to 'Fortran Friends' for distribution to others to enjoy. 
  120.