packages icon


   This is the AthenaTools Plotter Widget Set Version 6.0 patchlevel 7


What's new in V6.0 patchlevel 7:

At.h     ->     XtPointer is typedef'ed in X11R4 and X11R5. No define needed.
		Include patchlevel.h for some version macros AtVERSION,
		AtREVISION, AtPATCHLEVEL, and AtVersion.

XYAxis.c ->     Bug in setting tic_interval in Initialize() fixed.
		Calculate number of subtics in respect to the length
		in pixels between the tics.

... and some other minor changes.

------------------------------------------------------------------------------

The initial version of the AthenaTools Plotter Widget Set, known as V4, as far
as I know, was written by David Flanagan, Chris Craig, and Kambiz Soroushian
at M.I.T.  in 1990. In 1991 Gregory Bond re-wrote important parts of this code
and called his version V5-beta. His version works fine for more business-like
graphs, but unfortunately, there was dropped out a lot of stuff needed for
scientific graphs.

This version V6.0 is based on Gregory Bond's version V5-beta. I added some
stuff for scientific graphs, i.e. log axes, free scalable axes, XY-lineplots
and some more, and re-added plotter callbacks from V4, e.g. to request the
current pointer position, or to cut off a rectangle from the plotting area for
zooming-in. Version V6.0 has a log of bugs fixed and a log of improvements
against V6-beta. Additionally I did some other changes/extensions, besides

    -   Origin and frame lines for axes.
    -   Subgrid lines on subtic positions.
    -   Line plots in different line types (lines, points, lines+points,
	impulses, lines+impulses, steps, bars), line styles (solid, dotted,
	dashed, dot-dashed) and marker types for data points.
    -   Legend at the right or left hand side of the plot.
    -   Optional drawing to a pixmap instead of a window.
    -   Layout callback for aligning axis positions when using
	multiple plotters in one application.
    -   ... and much more ...

I called this version V6.0 because I plan and I have to add some other
features to the plotter widgets in the future (i.e. polar axes, a new
plotter form widget, ...).

Some ideas, hints and algorithms I got from gnuplot V3.0 written by
Colin Kelley and Thomas Williams.

The plotter widgets need X11R4 or X11R5 to get compiled. I couldn't compile
on AIX 3.1 and X11R3.

You can ftp the plotter widgets from the Paderborner FTP-Server:

	ftp.uni-paderborn.de (131.234.2.32)
	Login:     ftp
	Passwd:    e-mail-address
	Directory: /unix/tools or /unix/graphics

	Files:  plotter-6.0pl5.tar.Z (contains all the sources including manual
				  pages, demo programs and some documentation.
				  You need groff and the me-macros to
				  format the documentation!)
		plotter.doc.tar.Z (PostScript files from all manual pages
				  and the reference document  'Using The
				  AthenaTools Plotter Widget Set')
		plotter.afm.tar.Z (contains font metric files which are needed
				  for the plotters PostScript output.
				  Many TeX distributions contain these files)

The subdirectories and their contents are:

    At      contains the source of the plotter widget set and
	    the include files

    man     contains the manual pages of the plotter widgets

    motif   contains a motif demo of the plotter. The file Plot.c
	    contains all interesting code for programming and
	    using the plotter widget set

    athena  contains demos using the athena widget set. All
	    files contain interesting code for programming and
	    using the plotter widget set

    doc     contains some documentation from version V5
	    and this version V6-beta.

Installation:

    -   Edit and change At/Imakefile and create the library libAt.a
    -   Edit and change motif/Imakefile and/or athena/Imakefile
	to create the test programs or check and edit the files
	Makefile.simple if you are missing imake

    -   Install the include files and the library from the At subdirectory
    -   Install the postscript metric fonts from the afm subdirectory
    -   Install the manual pages from subdirectory man

Bugs and misfits:

    -   Many features are not yet well tested at this point in time!
    -   Known bugs are i.e. in the linear XY axis code!

What's to do:

    o   A plotter form widget for aligning multiple plotters
	(axis positions, legends, titles, PS output, ...)
    o   Polar axes
    o   Color PostScript output
    o   More and better Motif support or Motif wrappers (???)

Extensions, bug reports, patches, hints and so on are *very* welcome.

Paderborn, Fri Feb 12 09:01:02 1993

Peter Klingebiel
Universitaet-Gesamthochschule Paderborn
FB10 - Automatisierungstechnik
Paderborn GERMANY
klin@iat.uni-paderborn.de