Table of contents

NAME

<PLOT79> - FORTRAN graphics and software development/maintenance package

DESCRIPTION

<PLOT79> is a collection of FORTRAN programs for for producing scientific line graphics based upon the SIGGRAPH core standard and for creating and maintaining portable FORTRAN code (by means of the structured preprocessor language SFTRAN3).

In addition to (rather sketchy) UNIX manual pages, there is on-line documentation for many of these programs which may be accessed with the rdinfo program. NOTE: as originally distributed, much of this information is specific to the home site of <PLOT79> at the University of Utah.

The main <PLOT79> directory contains a number of useful executable files, the names of which may vary slightly according to the device library to which they are linked (if any). Brief descriptions appear at the end of this manual entry under "A WALKING TOUR".

FILES

/usr/local/plot79
<PLOT79> directory
/usr/local/plot79/host/sun
Sun-specific versions of <PLOT79> files
/usr/local/plot79/define
various environment definitions, an appropriate subset of which should be placed in the user's .cshrc or .profile file

SEE ALSO

document (1L), drawit(1L), grapht(1L), graph3t(1L), lptops(1L), pfort(1L), piechtt(1L), plot79(1L), pluto(1L), pretty(1L), rdinfo(1L), sf3(1L), slides(1L), tekalw(1L), tkvecs(1L), tmacro(1L), world(1L)

There is extensive separate documentation, authored by N. H. F. Beebe unless otherwise noted:

Installing <PLOT79> on the Sun Workstation. R. P. C. Rodgers. CALM/MedIX Technical Report 86-2, Dept. of Laboratory Medicine, UCSF School of Medicine, San Francisco, 1986.

A User's Guide to <PLOT79>.

<PLOT79> Demonstration Manual (2 volumes).

Installation Guide for <PLOT79>.

<PLOT79> Distribution Tape Character Set.

Writing a Device Interface for <PLOT79>.

SFTRAN/3 Installation Guide.

SFTRAN3 Programmer's Reference Manual (Jet Propulsion Laboratory Document no. 1846-98, Dec. 1, 1978).

A User's Guide to PLUTO. A Program for Plotting Molecular and Crystal Structures. Sam Motherwell, Joel Sussman, Zappora Shakked, David Barnett, and Nelson Beebe. Depts. of Physics and Chemistry, University of Utah.

PRETTY. A portable FORTRAN Program Prettyprinter.

DOCUMENT. A Portable Text Formatting Program.

TMACRO. A General Text Macro Processor.

The <PLOT79> Unix tar tape (Release 2.3a).

The author also supplies periodic newsletters and correction sets for licensees of <PLOT79>.

AUTHOR

The graphics components of the <PLOT79> package grew out of the work of Dr. Harold V. McIntosh. It has been extensively rewritten and expanded by:

Nelson H. F. Beebe, Ph.D.

Center for Scientific Computing

South Physics Building

University of Utah

Salt Lake City, UT 84112

Tel: (801) 581-5254

who is also responsible for gathering together the other software tools included in this package, and to whom questions regarding availability should be directed.

(Manual page by R. P. C. Rodgers, Computer Applications in Laboratory Medicine Project, UCSF, San Francisco, CA 94143).

A WALKING TOUR

There follows a brief description of some of the executable files which exist in the top-level <PLOT79> directory of a typical full Sun installation. Many of the files are not necessary, being related to maintenance of <PLOT79> on non-UNIX systems:
REINCLUDE:
a script which runs reincl (see below)
adm:
filter which adds padding null characters when transmitting Tektronix graphics output to an ADM-3 terminal.
bldmake:
script which creates a preliminary makefile for the directory it is in
bold[a,c,m,p,s]:
prints emboldened code for Ada, C, Modula, Pascal, and SFTRAN3
chkbin:
takes wildcard-containing file list and looks for files which may contain binary code
deincl:
finds include statements in FORTRAN code and substitutes contents of the indicated files (see reincl)
document:
a portable document formatting program (see document(1L))
dodiff:
runs diff on files in two different directories
dodiffall:
runs dodoff to compare VMS and UNIX versions of <PLOT79> files
dovmsall:
runs vms00 to tell difference between VMS and UNIX versions
echoall:
enhanced echo command; knows about escape and cursor characters
fixfflags:
script finds f77 lines in all makefiles and substitutes option flags
fixmake:
VMS maintenance related
fixmake00:
VMS maintenance related
grapht:
2-D graphics program (output for Tektronix 4014 on default Sun installation)
graph3t:
3-D graphics program (output for Tektronix 4014 on default Sun installation)
indent:
filter indents files left and downward on standard output
lptops:
program for converting ascii text files into P\s-2OST\s+2S\s-2CRIPT\s+2 files.
makedd:
makes UNIX command file to extract files from standard ASCII distribution tape
maknls:
builds tables required for namelist simulation
makxxx:
splits tape files from standard ASCII distribution tape into discrete disc files
metafile1:
converts graphics metafile to Tektronix 401X format
mfdump:
produces human readable dump of metafile (prints all contents but vectors)
mkdif:
VMS maintenance related
mltcol:
utility to produce multi-column output
oki:
script for controlling Okidata Pacemark 2410 printer
okibs:
filter processes nroff underscore-backspace sequences for the Okidata Pacemark 2410
pfort:
a FORTRAN code portability verifier (see pfort(1L))
piechtt:
a pie chart generation program (output for Tektronix 4014 on default Sun installation)
plot:
script allows display of Tektronix output on Intecolor VHR-19 or ADM-3+ terminals or Imagen laser printer
pluto4:
PLUTO molecular graphics for the Tektronix 4014 device (see pluto(1L))
pretty:
a prettyprinter program for FORTRAN programs (see pretty(1L))
rdinfo:
on-line documentation system for the <PLOT79> graphics & software development package
reincl:
replaces INCLUDE statements in place of the INCLUDE file contents in FORTRAN source code (see deincl)
sf3:
script which accesses a preprocessor for the structured FORTRAN language SFTRAN3
slides4:
the slides graphic command language interpreter for the Tektronix 4014 device.
tek:
filter adds padding null characters to plot file being sent to Tektronix graphics device
tounix:
changes .for file extensions to .f, deletes object files
trim72:
trims everything after column 72
unctl:
turns control characters into carat folllowed by capital letter, useful for viewing binary files
updunix:
script uses diff3 to move changes from VMS into UNIX versions of <PLOT79> files
vhr:
menu-driven program for displaying Intecolor or Tektronix files on Intecolor VHR-19 color terminal
vms00:
VMS maintenance related
watchp79:
script which records use of disc space during <PLOT79> installation
world4:
program for creating world maps on the Tektronix 4014 device.
xref[a,ac,o,oc]:
left over crud, can be deleted