ARM Club 3/TheARMClub_PDCD3.iso/hensa/maths/pgplot_1/ReadMe

Text File | 1997-06-17 | 6KB | 137 lines

           PGPLOT Version 5.20 for the Archimedes
                        Nov 1996

  Distributed by 'Fortran Friends' P.O. Box 64, Didcot, Oxon OX11 0TH, UK.

  Email:  [e-mail]

 PGPLOT is a portable Fortran subroutine package for drawing
simple scientific graphs. It runs on most mainframes on various graphics
display devices and printers including inkjet and PostScript ones. It was
originally developed for use with astronomical data reduction programs in
the Caltech Astronomy department. It is not Public Domain. However, it is
Freely available for non-Commercial use. It is copyrighted by the California
Institute of Technology. The software is provided "as is" with no warranty.

 This is an upgrade from the previous 'Fortran Friends' version 5.11.  It
has several bug fixes to the graphics system and a few new functions in the
library with new "Demos" to match.

 Archimedes version upgrade to the graphics driver: this now allows making
the ouput directly into a sprite with driver type \ARCF, as opposed to
direct to the screen with driver type \ARCV. It also works with RISC-OS up
to version 3.6 although it can only make 16 or 256 colour sprites directly.

 More information, copies of the Fortran of the most recent version, and
implementations for other computer systems may be obtained from:
*     Dr. T. J. Pearson
*     105-24 California Institute of Technology,
*     Pasadena, California 91125, USA
*
*     [e-mail]
*     WWW:  http://astro.caltech.edu/~tjp/pgplot/
*     anonymous ftp: astro.coltech.edu

If you do not have access to electronic mail, and want a copy of the text of
the current manual (dated 1989) written in TeX input format, send  a blank,
E format, 800K 3.5" floppy disk with a reply paid envelope to 'Fortran
Friends' (address above). Tim Pearson is in the process
of rewriting the manual; it is mostly available through the WWW.

A contribution of £1.00 (or U.S.$2.00) towards administration costs would be
appreciated, or if your address is outside Europe £2.00 (or U.S.$5.00).
Double these prices if you want us to supply the disc and packaging.

 The PGPlot library supplied on this disc has been compiled with Fortran
Release 2 for the Archimedes which must be installed on your Archimedes
before you can compile the example programs supplied and run this package.

 Fortran Release 2 for Acorn computers is available for £99 (ex VAT) from:

* Intelligent Interfaces Ltd,     Tel.  [phone]
* P.O.Box 80,                     Fax.  [phone]
* Eastleigh,
* Hants SO5 5YX, UK.

Distribution disc contents:

1) The application !PGPlot:
   contains the !Boot, !Run and !Sprites needed to set up the environment
   for running PGPlot, together with the font file 'GRFont' and colour
   information in 'RGBTxt'. The HelpPGPlot text file has helpful information
   on the PGPlot functions in a format useable by !SrcEdit for on-line help.

2) The Copyright notice for PGPlot.

3) 'Examples' directory with the Fortran of the 14 demo programs and an
   explanation in the ReadMe.

4) 'f77' directory with the complete Fortran source of PGPlot 5.20

5) HelpPGPlot file for use with !SrcEdit or !DeskEdit

6) 'lib' directory with the PGPlot library, and three auxiliary libraries
   which are PD utilities for primitive graphics and communication with the
   operating system and making 'hardcopy' output (sprites).

7) ReadMe (this file)

8) 'SYS_ARC' directory of Archimedes specific code

Installing this version:

1) Copy the !PGPlot application to your working disc.

2) Copy the library files in the 'lib' directory to the directory where you
   keep Fortran libraries. Everyone should copy 'PGPlot'. If you have the
   !Fortran77 front-end from Intelligent Interfaces, or the Fortran Friends
   libraries from HENSA you will already have the other files 'Graphics',
   'SpriteOp' and 'Utils', so may not need to copy them. To run on StrongARM
   the Utils library must be more recent than 23 August 1996.

   In the Shareware !Fortran77 front-end you must include the name of this
   library in the 'LibList' file BEFORE the Graphics and Utils entries.

3) Copy the Examples directory to your working disc.

4) If you have !SrcEdit and want to use the on-line help, append the lines:

        PGplot
        none
        <PGPLOT_DIR>.HelpPGPlot

   to the file 'choices.languages' within the !SrcEdit application.

   Then install !SrcEdit on the icon bar, click menu over its icon, and
   change the options, language, to tick PGPlot.

   If you have !DeskEdit you can replace one of the 3 help files in the
   !DeskEdit.data directory with 'HelpPGPlot'.

5) Edit the !Run file if you want to change any of the global variables
   which set the default device type, screen colours etc.

Testing the installation:

1) Before running any PGPLOT program, click on !PGPlot to set up the
   environment variables so that PGPLOT can find the fonts and colours.

2) Select the screen mode for your plots by setting the MODE from the
   RISC OS Desktop. This implementation of PGPlot is RISC OS compatible.
   It finds the Desktop screen mode before exiting the Desktop, runs your
   PGPlot program and returns to the Desktop on exit from your program.

3) Now try to compile, link and run the test demo programs.
   Remember the 'PGPlot' library should be linked before the 'Graphics' and
  'Utils' because it references routines in them.

   Warning: Most of the demos run quickly, but PGDemo3 takes some time,
   over 20 minutes on an A4000 with an ARM250 chip, and longer on an A3000.


Invitation:

 If you feel inspired to improve this Archimedes version, look in the
'AAReadme' in the SYS_ARC directory for advice, and please send any
enhancements to 'Fortran Friends' for distribution to others to enjoy.