next up previous contents index
Next: MASTER Routine Index Up: No Title Previous: INTEGER FUNCTION LNDSEA

MASTER Subroutines

By popular request, a set of the most commonly used general-purpose subroutines for complete function plots, charts, etc., were included in the LONGLIB graphics library. These subroutines are called "MASTER" Subroutines. Each of these subroutines is self contained. When called, it will initialize the plotting package, plot the desired data, and close the plotting package. Normally, only one  MASTER subroutine is called in a program. However, options are available for multiple calls to MASTER subroutines. When the LONGLIB is initialized by a MASTER subroutine (which calls FRAME) a metafile using Fortran file unit 3 is always created.

Programming examples using MASTER routines are given in the chapter on programming examples.

To call a MASTER subroutine more than once in a program the option flag must be set negative for all calls but the last one which should be positive. (See also the PLOTTESTS program.) To use more than one MASTER subroutine in a program:

  1. On first MASTER subroutine call set the option flag negative--this does not close plot package.
  2. on all additional calls to MASTER subroutines set the option negative and greater than 10000--this prevents re-opening plot package and does not close it.
  3. On the last call to a MASTER subroutine set option flag positive but greater than zero--this closes plot package.

In summary, when LONGLIB is already open set the magnitude of the option flag to greater than 10000. To prevent closing the plot package set option flag negative. When the plot package is closed in a MASTER subroutine CTERM(-2) is used to ask if a termina lscreen clear (terminal plotting only) should be done. MASTER subroutines always return the terminal to the text mode after call. When color options are enabled, the color marked "(return)" is the color in current use after call.  

Most MASTER subroutines have  common blocks with the same name prefixed with the letter "C" which contain the scaling information used to plot the data line. This can be useful for plotting additional annotations, etc.

The following pages document the currently defined MASTER Subroutines. Additional subroutines may be added as suggested by the users.





next up previous contents index
Next: MASTER Routine Index Up: No Title Previous: INTEGER FUNCTION LNDSEA



David Long
Wed Jun 12 10:34:11 MDT 1996