/COMMENTS

GRAFSYS Help File Version 2.01

Copyright (C) 1991 by Francis J. Deck.  All rights reserved.

NOTICE:  This file is not intended to be user-modifyable, even though it
is in plain English.  GRAFSYS expects file to be in a certain format,
and if that is violated, operation may be unpredictable.  Do not
distribute GRAFSYS with modified GRAFSYS.DOC.

/HELP
{GRAFSYS MENU SYSTEM}

Use the following keys to browse the GRAFSYS menu system:

    Key        Action
    ---        ------
             Move highlight bar up and down.
    ÄÙ        Select highlighted menu item.
    F1         Display help screen on highlighted item.
    Esc        Exit current menu.

You can also select a menu item by typing its number, followed by
Return.

{Mouse Support:}

GRAFSYS requires that the mouse driver MOUSE.COM or MSMOUSE.COM be
loaded in your system in order to support the mouse.  You can use your
mouse to move the highlight bar up and down, and to select a menu item.
The left button is the same as Return, and the right button is the same
as Esc.

/MAINCONFIRM

{EXIT TO DOS... CONFIRMATION}

If you respond "{Y}", GRAFSYS wil terminate and return to DOS.  If you
give any other response, including a carriage return, you will be
returned to the Main menu.

/MAINQUIT
{QUIT}

Causes GRAFSYS to return control to DOS.  You will be prompted with:

     Are you sure?_

If you respond with a carriage return, control will resume at the Main
menu.

/MAINREAD
{READ DATA GROUP FROM FILE}

Enters Read menu.

This menu takes you through the steps for reading a "group" of data
points into GRAFSYS.  A group is a set of points which share the same
attributes, such as plot symbol or line pattern.  You can read in
multiple groups, by entering the Read or Create menus several times, and
you can choose the same or different attributes each time.

The steps for reading a file are:

  1. Entering a valid file name.

  2. Selecting a column format.  If the file has more than two
     numeric columns, you can have GRAFSYS interpret the extra
     columns as "error bars," within certain restrictions.

  3. Read the file from disk.

  4. Choose the attributes, such as plot symbol, for the group.

/EXIT
{EXIT}

Returns control to the Main menu.

/READFILE
{FILE}

This is the name of the file containing a "group" of data points.

You may type a valid filename, or a wildcard, e.g. *.* or *.DAT.  If you
type a wildcard or the name of a nonexistent file, a pop-up menu window
will be shown, and you can select a file in the window.  All files
satisfying the wildcard will be shown, as well as all subdirectories and
the root directory (..), identified by a "d" to the left of the
directory name.

Move the cursor to the desired file or directory using the {up and down}
{arrow keys}, and press {Return}.  If you selected a directory, you will
be moved into that directory and shown the files there.

/READFMT
{COLUMN FORMAT}
    
Selects the column format for the file.  GRAFSYS recognizes the
following column formats:

  X    Y
  X    Y    ëY
  X    Y    ëY-  ëY+
  X    Y    ëX
  X    Y    ëX   ëY
  X    Y    ëX   ëY1- ëY+
  X    Y    ëX-  ëX+
  X    Y    ëX-  ëX+  ëY
  X    Y    ëX-  ëX+  ëY-  ëY+

Each value of ë is for an error bar, and is the distance of the end of
the bar from the (x,y) point.  The ë- and ë+ values are for asymmetrical
error bars.  If your data file has more columns than needed for the
format you choose, the extra ones will be ignored.

/READREAD
{START READING FILE}

After you have selected a column format for the file, you can initiate
the read process by selecting this item.  Or, you can "back out" by
selecting {Exit}.

/MAINEDIT
{CREATE/EDIT NEW DATA GROUP}

Enters the Create/edit menu.  This menu allows you to enter a new group
of data points manually, using the built-in point editor.

/CREATEFMT
{COLUMN FORMAT}

Selects the column format for the group.  GRAFSYS recognizes the
following column formats:

  X    Y
  X    Y    ëY
  X    Y    ëY-  ëY+
  X    Y    ëX
  X    Y    ëX   ëY
  X    Y    ëX   ëY1- ëY+
  X    Y    ëX-  ëX+
  X    Y    ëX-  ëX+  ëY
  X    Y    ëX-  ëX+  ëY-  ëY+

Each value of ë is for an error bar, and is the distance of the end of
the bar from the (x,y) point.  The ë- and ë+ values are for asymmetrical
error bars.  If your data file has more columns than needed for the
format you choose, the extra ones will be ignored.

/CREATECRE

{CREATE GROUP}

Once you have chosen a column format, a group with the required number
of columns will be created.  Then, you will be placed in a menu where
you can select attributes for the group, such as plot symbol, and enter
the data point editor.

/MAINLABELS
{TITLE, AXIS LABELS, PLOT TEXT}

This menu allows you to add, delete, and edit the text of the plot title
and axis labels.  You can also add "plot text" which is text placed
anywhere on the plot.  Other attributes of these labels, including
character size and color can be set in the Text Attributes menu.

A special character font including all Greek and special math symbols is
available.  The documentation file and quick reference card list the
special characters.  In general, they are typed as a word surrounded by
backslashes, for example:

\alpha\         lowercase Greek letter "alpha"
\upi\           uppercase Greek letter "pi"

\sup\           Superscript--shift up 1/2 character height
\sub\           Subscript--shift down 1/2 character height

/LABELTITLE
{TITLE OF PLOT}

The title is printed at top center of the plot.  You can change
character size and color in the Text Attributes menu.  If you want no
title, just press <return> here.

A special character font including all Greek and special math symbols is
available.  The documentation file and quick reference card list the
special characters.  In general, they are typed as a word surrounded by
backslashes, for example:

\alpha\         lowercase Greek letter "alpha"
\upi\           uppercase Greek letter "pi"

\sup\           Superscript--shift up 1/2 character height
\sub\           Subscript--shift down 1/2 character height

/LABELXLABL
{X-AXIS LABEL}

The X-axis label is printed at the bottom center of the plot. You can
change character size and color in the Text Attributes menu.  If you
want no X-axis label, just press <return> here.

A special character font including all Greek and special math symbols is
available.  The documentation file and quick reference card list the
special characters.  In general, they are typed as a word surrounded by
backslashes, for example:

\alpha\         lowercase Greek letter "alpha"
\upi\           uppercase Greek letter "pi"

\sup\           Superscript--shift up 1/2 character height
\sub\           Subscript--shift down 1/2 character height

/LABELYLABL
{Y-AXIS LABEL}

The Y-axis label is printed sideways and centered vertically, at the
left edge of the plot.  You can change character size and color in the
Text Attributes menu.  If you want no Y-axis label, just press <return>
here.

A special character font including all Greek and special math symbols is
available.  The documentation file and quick reference card list the
special characters.  In general, they are typed as a word surrounded by
backslashes, for example:

\alpha\         lowercase Greek letter "alpha"
\upi\           uppercase Greek letter "pi"

\sup\           Superscript--shift up 1/2 character height
\sub\           Subscript--shift down 1/2 character height

/LABELXUNIT
{X UNITS}

Ths unit string is used to generate labels which conform to Physical
Review and other journals, in conjunction with the Exponential ruler
format found in the Grid menu.  The unit string will be surrounded by
parentheses, and will follow the axis label.  If GRAFSYS places an
exponent multiplier in the axis label, it will be placed inside the
parentheses, just before the units.

/LABELYUNIT
{Y UNITS}

Ths unit string is used to generate labels which conform to Physical
Review and other journals, in conjunction with the Exponential ruler
format found in the Grid menu.  The unit string will be surrounded by
parentheses, and will follow the axis label.  If GRAFSYS places an
exponent multiplier in the axis label, it will be placed inside the
parentheses, just before the units.

/LABELFONT
{SPECIAL CHARACTER FONT}

Each character should be inserted between backslashes, e.g. \kappa\.

nc            theta         bullet        uparr
              vartheta      neqiv         leftarr       clubsuit
UGamma        iota          cents         downerr       shamrock
UDelta        kappa         owns          rad           Quebec
UTheta        lambda        nabla         int           backslash
ULambda       mu            partial       oint
Uxi           nu            ell           dagger        diamond
UPi           xi            emptyset      ddagger       star
USigma        pi            circ          exists        square
UUpsilon      rho           times         odot          triangle
UPhi          sigma         parallel      bra           circle
              tau           perp          ket           ground
alpha         upsilon       angle         pm
beta          phi           therefore     mp            greekcross
gamma         varphi        infinity      div
delta         chi           ne            cdot          crescent
epsilon       psi           equiv                       starofdavid
varepsilon    omega         leq           hbar
zeta                        geq           spadesuit
eta           approx        propto        heartsuit     sup
              cong          rightarr      diamondsuit   sub

/LABELPTEXT
{PLOT TEXT}

Enters the Plot Text menu.  Plot text is continuously scaleable and
rotatable text which can be placed anywhere on the screen.  You can
enter new plot text items or edit old ones in this menu.

/EPSITEM
{SELECTED ITEM}

Allows you to choose the plot text item which will be edited if you
select {Edit selected item}.

/EPOKEDIT
{EDIT SELECTED ITEM}

Enters a menu which allows you to alter the characteristics of an
individual plot text item.
 
/EPOKDEL
{DELETE SELECTED ITEM}

You can't actually delete a plot text item (in this version), but you
can edit it and make its string blank.  This will be improved in the
next version.

/EPOKCREAT
{CREATE NEW TEXT ITEM}

Creates a new item of plot text, and allows you to enter its
characteristics.

/EPTSTR
{STRING}

This is the string which will be displayed.  You can use the same
special GRAFSYS character codes as are used for title and axis labels.

/EPTX
{X}

X position of the lower left-hand corner of the text piece.

/EPTY
{Y}

Y position of the lower left-hand corner of the text piece.

/EPTPLOT
{UNITS OF (X,Y)}

The position of the text item can be measured in one of two unit
systems:

        {Same as data points}

                The axis rulers will measure the location of the text
                piece.  This is useful if you want to label a data point
                or peak, or if you want the placement of plot text to be
                independent of the size of the printed plot.

        {Inches from lower left-hand corner of plot}

                This is useful if you want absolute control over the
                placement of the text piece, independent of the ruler
                units.

/EPTHT
{CHARACTER HEIGHT}

Controls the height, in inches, of the characters used to render the
text piece.

/EPTCOLR
{COLOR}

The color of the text piece in "user" units, defined by the COLORMAP
commands in the file INITOPT.CMD.  If you have not modified INITOPT.CMD,
then you should stick with colors 0 through 4 here.

/EPTANGL
{ANGLE}

Rotation angle for the text piece, in degrees counterclockwise from
horizontal.  The text piece pivots around its lower left-hand corner.

/MAINPLOT
{PREVIEW/PRINT PLOT}

Enters the Plot menu.  Plotting to the screen or a hardcopy device is
achieved from this menu.

Before plotting, you are expected to have read in some data using the
Read menu.

/PLOTDEVICE
{DEVICE}

Selects the target output device from the following list:

     Screen
     Dot-matrix printer
     Postscript device
     HP-GL plotter device

If you select anything but the screen, you will be prompted for the
physical size of the finished plot.  You will also be able to change the
destination file or device for the plot at this point, before plotting.

{HP LaserJet users:}  To obtain graphics output, choose HP-GL output.  The
PrintGL utility is supplied with GRAFSYS, and converts HP-GL to LaserJet
output.  Refer to the GRAFSYS documentation for details.

/PLOTWIDTH
{WIDTH}

Width of hardcopy plot in inches.  This variable is not shown for screen
plot.

/PLOTHEIGHT
{HEIGHT}

Height of hardcopy plot in inches.  This variable is not shown for
screen plot.

/PLOTDEST
{DESTINATION}

Destination of graphics output.  You may give a disk path name or
logical device name here.  If you select a serial device, it must be
properly configured with the MODE command prior to entering GRAFSYS.

/PLOTSTART
{START PLOTTING}

Causes the plot to be executed on the selected device.  If you plot to
the screen, you must press a key after the plot comes up to return to
the menu system.

/PLOTSPEED
{PEN SPEED IN CM/S}

You can choose how fast the plotter's little pens move, to adjust for
different kinds of paper.  Typically, the "harder" the surface of the
paper, the faster the pens can move, since it takes less time for the
ink to soak in.  We recommend the following speeds:

        0.5 cm/s        Film, glossy paper.
        1 cm/s          Plain paper.

/PLOTRESOL
{RESOLUTION}

You can print to the dot matrix printer in two resolutions:

        Low:    60 X 72 dpi
        High:   120 X 72 dpi

If you need higher resolutions, you should produce a plot file by
selecting the HP Plotter Device, and use the PrintGL utility to generate
high-quality output on your printer.

/PLOTPIC
{DESIGNER PIC}

Support for the Micrografx Designer .PIC graphics file format is no
longer a part of the main GRAFSYS program.  The documentation file
UPDATE.DOC explains the reasons for this.

A program called HPGL2PIC is in UTILITIY.ZIP, which converts HP-GL plot
files produced by GRAFSYS into the PIC format.  To use it, select HP-GL
as the output device inside GRAFSYS, and plot to a file, say OUT.PLT.
Now exit GRAFSYS and type:

        HPGL2PIC OUT.PLT OUT.PIC

A .PIC file will be created which can be read by Designer.  Notice that
other software programs, such as Lotus 123 also use the .PIC file
extension, but are not compatible with HPGL2PIC.

/PLOTOTHER
{OTHER DEVICES}

Devices other than those listed in the Plot Menu are supported by the
PrintGL system.  If you did not unpack the PRINTGL.ZIP, you should do so
now.  The following printers are supported:

        HP LaserJet, DeskJet, and compatible printers.
        Epson 9- and 24-pin printers in a variety of resolutions.
        Many others.

To print to these devices, select "HP-GL" as the output device, and the
name of a file, say "OUT.PLT" as the destination.  Then, select the size
of plot you want, and select "Start Plotting."  Now exit GRAFSYS, and
run the GRAFSYS off-line print utility GPRINT.EXE.  GPRINT is
menu-driven and quite self-explanatory.

The PrintGL system is a Shareware package by Cary Ravitz.  By Mr.
Ravitz's permission, PrintGL is distributed on the GRAFSYS distribution
disk.  Updated versions of GRAFSYS will always have the latest version
of PrintGL.  You are encouraged to read the PrintGL documentation, and
to send in the registration fee if you become a user.

/MAINSCALE
{SCALE/RANGE OPTIONS}

Enters the Scale/Range menu.

/SCALEXRANG
{X RANGING}

Switches between automatic and manual ranging.  In manual ranging, you
must provide upper and lower bounds for the axis.

{Note:}  If manual ranging is selected, the actual range chosen will
still be different, in order to force ticks to lie at the ends of the
axis ruler.  If you want the ruler to conform strictly to your chosen
range, you must turn off "Force labels at ruler ends."

/SCALEXMIN
{MINIMUM X VALUE}

The minimum value along the x-axis in manual ranging.  Data points with
x less than this value will not be rendered.

/SCALEXMAX
MAXIMUM X VALUE

The maximum value along the x-axis in manual ranging.  Data points with
x greater than this value will not be rendered.

/SCALEYRANG
{Y RANGING}

Switches between automatic and manual ranging.  In manual ranging, you
must provide upper and lower bounds for the axis.

{Note:}  If manual ranging is selected, the actual range chosen will
still be different, in order to force ticks to lie at the ends of the
axis ruler.  If you want the ruler to conform strictly to your chosen
range, you must turn off "Force labels at ruler ends."

/SCALEYMIN
{MINIMUM Y VALUE}

The minimum value along the y-axis in manual ranging.  Data points with
y less than this value will not be rendered.

/SCALEYMAX
{MAXIMUM Y VALUE}

The maximum value along the y-axis in manual ranging.  Data points with
y greater than this value will not be rendered.

/SCALEXSCALE
{X SCALING}

Selects the scaling for the plot.  Options are:

        Linear
        Log
        dB = 10 log X
        dB = 20 log X

If your data file contains zero or negative X values intentionally, you
should select an X Log Floor in this menu.  All X values below the floor
will be converted to the floor value prior to log or dB conversion.
This is useful for nuclear spectra, where log scaling is used, but some
channels have no counts.

/SCALEXFLOOR
{X LOG FLOOR}

Sometimes, your data have zero or negative X values, but you want log
scaling anyway.  For instance, nuclear spectra are commonly plotted on a
log scale, but some channels have zero counts.  In this case, zero or
negative values should not cause an error, but should be plotted at some
"floor" value.

For nuclear spectra, we recommend a Y log floor of 0.5, since the
smallest nonzero number is 1 count.  This will give the plot a nice
bottom margin.

If an X value is encountered below the floor, it will be set to the
floor value before log or dB conversion.  If the floor is set to a
nonpositive value, then nonpositive X values will cause an error message
during plotting.

/SCALEYSCALE
{Y SCALING}

Selects the scaling for the plot.  Options are:

        Linear
        Log
        dB = 10 log Y
        dB = 20 log Y

If your data file contains zero or negative Y values intentionally, you
should select an Y Log Floor in this menu.  All Y values below the floor
will be converted to the floor value prior to log or dB conversion.
This is useful for nuclear spectra, where log scaling is used, but some
channels have no counts.

/SCALEYFLOOR
{Y LOG FLOOR}

Sometimes, your data have zero or negative Y values, but you want log
scaling anyway.  For instance, nuclear spectra are commonly plotted on a
log scale, but some channels have zero counts.  In this case, zero or
negative values should not cause an error, but should be plotted at some
"floor" value.

For nuclear spectra, we recommend a Y log floor of 0.5, since the
smallest nonzero number is 1 count.  This will give the plot a nice
bottom margin.

If an Y value is encountered below the floor, it will be set to the
floor value before log or dB conversion.  If the floor is set to a
nonpositive value, then nonpositive Y values will cause an error message
during plotting.

/SCALEXREV
{REVERSE THE X-AXIS}

Switches between normal and reversed axis.  Reversal may be useful if,
say, the axis is in "inverse" units.

/SCALEYREV
{REVERSE THE Y-AXIS}

Switches between normal and reversed axis.  Reversal may be
useful if, say, the axis is in "inverse" units.

/SCALEXFORC
{FORCE LABELS AT ENDS OF X-AXIS}

Allows you to decide whether the plot bounds will be chosen to guarantee
a ruler label at each end of the axis.  If forcing is turned off, a
label may still appear at the ruler end.  This will happen if "nice"
numbers are chosen for manual ranges, for example.

/SCALEYFORC
{FORCE LABELS AT ENDS OF Y-AXIS}

Allows you to decide whether the plot bounds will be chosen to guarantee
a ruler label at each end of the axis.  If forcing is turned off, a
label may still appear at the ruler end.  This will happen if "nice"
numbers are chosen for manual ranges, for example.

/MAINGRID
{GRID OPTIONS}

Enters the Grid Options menu, where you can change aesthetic
aspects of how the plot is laid out.

/DISPCONFIRM
{DELETING GROUP... CONFIRMATION}

If you respond with "{Y}" here, the selected group will be deleted, and
memory will be freed for other data.  This is irreversible.  If you give
any other response, including carriage return, the delete operation will
be cancelled, and you will return to the {Edit existing groups} menu.

/GRIDXMINTICK
{NUMBER OF X MINOR TICK DIVISIONS}

The number of divisions between each main ruler tick mark for minor tick
marks.  Selecting zero here will turn minor ticks off.

Hint:  It is useful to use minor ticks to identify linear or logarithmic
axes.

/GRIDYMINTICK
{NUMBER OF Y MINOR TICK DIVISIONS}

The number of divisions between each main ruler tick mark for minor tick
marks.  Selecting zero here will turn minor ticks off.

Hint:  It is useful to use minor ticks to identify linear or logarithmic
axes.

/GRIDXDISP
{X TICK MARK DISPLACEMENT}

This is a real number from 0 to 1 which determines what percentage of
the ruler "tick" mark will lie outside the plot box.  A value of 0 means
that the tick mark will start on the axis and lie fully inside the box.
A value of 1 means that the tick mark will be fully outside.

/GRIDYDISP
{Y TICK MARK DISPLACEMENT}

This is a real number from 0 to 1 which determines what percentage of
the ruler "tick" mark will lie outside the plot box.  A value of 0 means
that the tick mark will start on the axis and lie fully inside the box.
A value of 1 means that the tick mark will be fully outside.

/GRIDVERTGRID
{VERTICAL GRID LINES}

Draws vertical "grid" lines above each x-axis ruler major tick mark.
Line width, pattern, and color may be adjusted in the Line Attributes
menu.

/GRIDHORGRID
{HORIZONTAL GRID LINES}

Draws horizontal "grid" lines across from each y-axis major tick mark.
Line width, pattern, and color may be adjusted in the Line Attributes
menu.

/GRIDBOX
{BOX AROUND DATA POINTS}

Selects "full" or "half" bounding box.  In "half" mode, two rulers are
drawn at the left and bottom of the bounding box, with corresponding
numbers.  In the "full" mode, an additional two lines are drawn with
tick marks but no numbers at the top and left of the box.

/GRIDUBTICKS
{TICK MARKS ON UPPER BOX}

Selects whether the upper and right axis rulers of the "full" bounding
box will have tick marks on them.

/GRIDXNLAB
{NUMBER OF X NUMERIC LABELS}

This is the "first guess" GRAFSYS uses to calculate the best number of
ruler labels for the plot.  Typically the actual number used will be a
bit higher, in the name of finding "nice" numbers for the rulers.

/GRIDYNLAB
{NUMBER OF Y NUMERIC LABELS}

This is the "first guess" GRAFSYS uses to calculate the best number of
ruler labels for the plot.  Typically the actual number used will be a
bit higher, in the name of finding "nice" numbers for the rulers.

/GRIDXFMT
{X-AXIS NUMERIC LABELS FORMAT}

Chooses "normal" or "exponential" format for ruler numbers.  In the
normal mode, the entire number is shown on the ruler, with "E" notation
if necessary.  In the exponential mode, only the significand is shown on
the ruler--the exponent is appended to the axis label.

/GRIDYFMT
{Y-AXIS NUMERIC LABELS FORMAT}

Chooses "normal" or "exponential" format for ruler numbers.  In the
normal mode, the entire number is shown on the ruler, with "E" notation
if necessary.  In the exponential mode, only the significand is shown on
the ruler--the exponent is appended to the axis label.

/GRIDEBARSTYL
{ERROR BAR STYLE}

Selects how the error bars will be displayed.  Options are:

        Bar and end caps
        Bar only
        End caps only.

If you want to suppress error bars entirely for a point group, you can
do this in the {Edit existing groups} menu.

/GRIDXRULSTYL
{X-AXIS RULER STYLE}

Selects how the x-axis ruler will be displayed.  Options are:

        Numbers and tick marks.
        Tick marks only.
        Tick marks, space for numbers
        Space for numbers only.
        None

{Hint:}  It is sometimes useful to turn the ruler numbers off,
especially if an axis is in "arbitrary" units.

/GRIDYRULSTYL
{X-AXIS RULER STYLE}

Selects how the x-axis ruler will be displayed.  Options are:

        Numbers and tick marks.
        Tick marks only.
        Tick marks, space for numbers
        Space for numbers only.
        None

{Hint:}  It is sometimes useful to turn the ruler numbers off,
especially if an axis is in "arbitrary" units.

/GRIDY0AXIS
{Y = 0 AXIS}

Chooses whether or not to display a vertical "axis" line corresponding
to the equation Y = 0. Attributes of this line can be changed in the
Line Attributes Menu.

/GRIDX0AXIS
{X = 0 AXIS}

Chooses whether or not to display a horizontal "axis" line corresponding
to the equation X = 0. Attributes of this line can be changed in the
Line Atributes Menu.

/GRIDBORD
{PLOT BORDER}

Chooses whether to enclose the entire plot inside a rectangular border
line.

/MAINOTHER
{OTHER OPTIONS}

Enters the Device Options menu.  This menu contains all the options
which couldn't otherwise be classified.

/OTHERTICKSIZ
{RULER TICK MARK SIZE}

The length of the tick mark on the axis rulers.  Note that the minor
tick mark is always half as long as the major mark.

/OTHERFINSP
{FINE SPACING INCREMENT}

The small amount of space GRAFSYS sticks between things so that they
don't touch, on the final plot.

{Hint:}  The default value for this option is best for laser
printer output, but is too small for dot matrix printers.  You
may want to adjust this upward for raster devices.

/OTHERSYMBSIZ
{PLOT SYMBOL SIZE}

This is the default value of the plot symbol size upon entry to the Read
Menu.  If you want to change the symbol size for a group which has
already been read in, use the {Edit existing groups} menu.

/OTHERORIENT
{ORIENTATION}

Selects "portrait" or "landscape" orientation for the plot.  At present,
only portrait is available for HP plotters.

/OTHERXORIG
{X ORIGIN}

Determines the point which is chosen for the bottom of the plot, or the
top in the case of the DMP devices.

/OTHERYORIG
{Y ORIGIN}

Determines the point which is chosen for the left edge of the plot.

/OTHERSCRNWID
{SCREEN WIDTH}

This should be set to the size of your screen's active graphics area, so
GRAFSYS can correctly scale fonts.

/OTHERSCRNHT
{SCREEN HEIGHT}

This should be set to the size of your screen's active graphics area, so
GRAFSYS can correctly scale fonts.

/OTHERNEEDLE
{NEEDLE PLOT SYMBOL BASELINE Y =}

This is the line which is used as the "baseline" for "needle" plot
symbols.  A needle plot symbol is drawn as a straight line from the
point to the baseline.  If log scaling is used for the Y axis, the
baseline automatically becomes the bottom ruler.  Also, if the baseline
is outside the plot box, the top or bottom ruler is used as the
baseline.

/MAINTEXT
{TEXT ATTRIBUTES}

Enters the Text Attributes Menu, where size and color of all text can be
adjusted.

/TEXTTITLHT
{TITLE CHARACTER HEIGHT}

The character height of the plot title, in inches.

/TEXTTITLCOLR
{TITLE COLOR}

The color of the title, in user units from 0 to 15.

In order to use colors 2 through 15, you must define your own color map.
See the documentation.

/TEXTAXISHT
{AXIS LABEL HEIGHT}

The character height of the axis label, in inches.

/TEXTAXISCOLR
{AXIS LABEL COLOR}

The color of the axis labels, in user units from 0 to 15.

In order to use colors 2 through 15, you must define your own color map.
See the documentation.

/TEXTRULRHT
{RULER NUMERIC LABEL CHARACTER HEIGHT}

The character height of the ruler numbers, in inches.

/TEXTRULRCOLR
{RULER LABEL COLOR}

The color of the ruler numbers, in user units from 0 to 15.

In order to use colors 2 through 15, you must define your own color map.
See the documentation.

/LINEFONTLEAD
{FONT LEADING}

This is a positive real number which specifies the ratio of the distance
between successive characters in a string to the character height.  For
instance, if the font height were 0.5 and the font leading were 0.3 then
there would be 0.5*0.3 = 0.15 inches between successive characters.

If you are preparing a plot which will be photoreduced, then you should
specify a larger font leading, say 0.5, so that the reduced lettering
will still be readable.

/MAINLINE
{LINE ATTRIBUTES}

Enters the Line Attributes menu.  In this menu, you can change the
characteristics of all lines drawn by GRAFSYS during plotting.

/LINEBORDWID
{BORDER WIDTH}

Pen width for drawing plot border, in inches.

/LINEBORDCOLR
{BORDER COLOR}

Color of plot border, in user units from 0 to 15.

In order to use colors 2 through 15, you must define your own color map.
See the documentation.

/LINEAXISWID
{AXIS WIDTH}

Pen width for drawing axes, in inches.

/LINEAXISCOLR
{AXIS COLOR}

Color of axes, in user units from 0 to 15.

In order to use colors 2 through 15, you must define your own color map.
See the documentation.

/LINEAXISPATT
{AXIS PATTERN}

Line pattern for drawing axis rulers.

/LINESYMBWID
{PLOT SYMBOL LINE WIDTH}

Default pen width for drawing plot symbols, in inches, upon entering
Read menu.  If you want to change the pen width for a group which has
been read in, go to the {Edit existing groups} menu.

/LINESYMBCOLR
{PLOT SYMBOL COLOR}

Default color of plot symbols, in user units, upon entering the Read
menu.  If you want to change the color for a group which has been read
in, go to the {Edit existing groups} menu.

In order to use colors 2 through 15, you must define your own color map.

/LINELINEWID
{LINE PLOT WIDTH}

Default pen width for line plot in inches, upon entering the Read menu.
If you want to change this value for a group which has already been read
in, go to the {Edit existing groups} menu.

/LINELINECOLR
{LINE PLOT COLOR}

Default color for line plot in user units from 0 to 15.  If you want to
change this value for a group which has already been read in, go to the
{Edit existing groups} menu.

If you want to use colors 2 through 15, you must define your own color
map.

/LINETICKWID
{TICK MARK WIDTH}

Pen width for ruler tick mark, in inches.

/LINETICKCOLR
{TICK MARK COLOR}

Color of ruler tick marks, in user units from 0 to 15.

If you want to use colors 2 through 15, you must define your own color
map.

/LINEGRIDWID
{GRID LINE WIDTH}

Pen width for grid lines, in inches.

/LINEGRIDCOLR
{GRID LINE COLOR}

Color of grid lines, in user units from 0 to 15.

If you want to use colors 2 through 15, you must define your own color
map.

/LINEGRIDPATT
{GRID LINE PATTERN}

Pattern for drawing grid lines.

/LINETEXTRATIO
{TEXT LINE WIDTH RATIO}

This is the ratio of the pen width used for drawing text to the
character height.  A larger value for this means a wider pen.

If you are preparing a plot which will be photoreduced, you should
choose a wider pen ratio, say 0.12, for better readability after
reduction.

/MAINDISP
{EDIT EXISTING DATA GROUPS}

Enters the {Edit existing groups} menu.  This menu allows you to alter
certain parameters for data groups which have been read in, and to edit
the data points themselves.

/DISPFILE
{SELECTED GROUP}

Allows you to choose which "group" of data points will be edited when
you select {Edit selected group}.

/DISPGROUP
{EDIT SELECTED GROUP}

Enters a menu which allows you to display and edit parameters for the
currently selected group.

/GROUPEBARS
{DISPLAY ERROR BARS}

Chooses whether or not the error bars will be displayed for this group.
The error bar values are not destroyed--only hidden during plotting, and
can be subsequently revived.

If there were no error bars specified when the file was read, then you
will not be permitted to turn error bars on here.

/GROUPSYMB
{SCATTER PLOT SYMBOL}

Chooses the symbol for rendering the group as a scatter plot.

/GROUPFILL
{FILL PLOT SYMBOL}

Selects whether or not the plot symbol will be filled in.  Note that
filling is not applicable to some symbols, e.g. the X. Filling is only
available on Postscript devices.

/GROUPSYMBSIZ
{PLOT SYMBOL SIZE}

The size, in inches, of the square box which bounds each plot symbol.
Note that the "dot" symbol is not scaled by this variable.

/GROUPSYMBWID
{SYMBOL LINE WIDTH}

Pen width for drawing scatter plot symbols, in inches.  If you want to
hide the symbols entirely, do not select zero for this variable.
Instead, choose "none" for the plot symbol.

/GROUPSYMBCOLR
{PLOT SYMBOL COLOR}

Color for plot symbols, in user units from 0 to 15.

If you want to use colors 2 through 15, you must define your own color
map.

/GROUPLINWID
{LINE WIDTH}

Pen width for rendering line plot in inches.  If you want to hide the
line entirely, do not select zero for this variable. Instead, choose
"none" for the line pattern.

/GROUPLINPATT
{LINE PLOT PATTERN}

Pattern for rendering line plot.  A "line plot" connects
successive data points in the data group with straight lines.

/GROUPLINCOLR
{PLOT LINE COLOR}

Color for plot line, in user units from 0 to 15.

If you want to use colors 2 through 15, you must set up your own
colormap in INITOPT.CMD.  See the documentation.

/GROUPXOFF
{X OFFSET}

This is a value which is added to each X value throughout the plotting
process.  It is normally set to zero, but you can change it to produce a
vertical shift in your data.

/GROUPXMULT
{X MULTIPLIER}

This is a value which multiplies each X value throughout the plotting
process.  It is normally set to 1, but you can change it to scale your
data.

/GROUPYOFF
{Y OFFSET}

This is a value which is added to each Y value throughout the plotting
process.  It is normally set to zero, but you can change it to produce a
horizontal shift in your data.

/GROUPYMULT
{Y MULTIPLIER}

This is a value which multiplies each Y value throughout the plotting
process.  It is normally set to 1, but you can change it to scale your
data.

/GROUPEXCLUD
{EXCLUDE DURING RANGING}

During autoranging, the upper and lower bounds for the data set are
calculated.  You can force GRAFSYS to ignore a group during this
calculation by choosing this item.  This is useful, for instance, if you
want a "fit" line to extend to extend to the edges of the plot
boundaries.  The extra points beyond the boundaries will not be
rendered.

/GROUPEDIT
{EDIT DATA POINTS}

Enters the data point editor.

/DISPDELETE
{DELETE GROUP}

Causes the selected data group to be deleted.  The memory space used by
that group is freed, and is again available for other data groups or a
print image.

/DISPSAVE
{SAVE GROUP}

Saves a set of data points to a plain ASCII text file.  These files can
be read back into GRAFSYS at a later time.

It is also possible to save the entire plot, options and all, in the
Save menu.

/DISPNAME
{FILENAME}

The name of the file to which you want the selected data file written.

/MAINCMDFIL
{EXECUTE COMMAND FILE}

Causes GRAFSYS to process a command file.  See the reference card or the
complete documentation for a description of the command language.  You
can use this language to set up custom graphics "macros" or perform
complete automated plotting operations.

Also, if you used the Save menu to save a plot, you can recover that
plot by executing the file you saved it in as a command file.

/MAINCMDFILNAM
{COMMAND FILE NAME}

The full pathname of the command file.

/MAINCURRDIR
{CURRENT DIRECTORY}

Allows you to perform the equivalent of a DOS CD or ChDir command.  Any
string permitted in the DOS command is permitted here.

/MAINABOUT
{ABOUT GRAFSYS}

Enters the About GRAFSYS menu.  This menu displays copyright information
about GRAFSYS, and has an item which prints an order blank to a printer
or disk file.

/ABOUTSCREEN
{GRAFSYS SCIENTIFIC PLOTTING PACKAGE}

Version 2.01

Copyright 1991 by Francis J. Deck.  All rights reserved.

This package is intended to be distributed as SHAREWARE.  This means
that the package may be freely copied and passed around, and tested on
any machine.  If you decide to make use of GRAFSYS, then you must pay
the license fee.  The GRAFSYS manual contains the specific terms of the
copyright.

I depend on you, the user, for support.  The license fee is only
$35, or $15 for students, plust 5% Indiana sales tax if
applicable. Registrants will receive a disk with the latest
revision, and a notice when the next version is released.

Site licenses are available.  If interested, see GRAFSYS.DOC.

The PrintGL utility is a separately copyrighted package, which is
bundled with GRAFSYS.  If you are using it, you should become a
registered user.  Consult the documentation file PRINTGL.DOC.

/ABOUTDISP
{DISPLAY SHAREWARE INFORMATION SCREEN}

A screen is displayed with a message about the GRAFSYS copyright.

/ABOUTPRINT
{PRINT AN ORDER BLANK}

Prints an order blank to the printer or a disk file.  The default
destination is PRN which is the printer device.  If you want to print
off-line or to a disk file, select "Destination" below.

/ABOUTDEST
{DESTINATION}

The full pathname or logical device to receive the order blank. Use PRN
for the parallel line printer.

/MAINSAVE
{SAVE}

Enters the Save menu.  This menu allows you to save the current state of
GRAFSYS to a file.

/SAVEFILE
{SAVE DESTINATION}

Full DOS pathname for save command file.

{WARNING:}  We recommend that you not overwrite INITOPT.CMD.

/OKSAVE

{SAVE USING ABOVE OPTIONS}

You must choose this menu selection to generate the save file.

/MAINRESTART
{RESTART}

The restart operation gives you a clean slate within GRAFSYS.  First,
all data groups are deleted, data storage space is made available again.
Second, the initialization command file INITOPT.CMD is executed to reset
all user options to their defalt values.

This process is equivalent to exiting GRAFSYS and restarting it from
DOS.  To prevent you from accidentally destroying a plot, you will be
prompted for confirmation.

/MAINCONFREST
{RESTART CONFIRMATION}

You are being asked to confirm your decision to restart GRASFYS.  If you
choose "Y", GRAFSYS will restart itself, meaning that all data files
will be wiped out and all options returned to their default values.
Pressing the return key here will prevent the restart operation from
occuring.

/DMPRANGE
Error... Attempt to plot out of device range...

An attempt was made to plot outside of the maximum plotting range of the
device.  Please note that the size of the plot, as seen by the device,
is the size selected in the Plot menu, plus the offset origin, which is
set in the Other menu.  For the dot matrix printer, the data format
specification limits the width of a plot to 8 inches.

/DGEDIT
{Data Group Editor}

        Key:          Action:
        ----          -------
        {Arrow Keys}    Move cursor.
        {PgUp, PgDn}    Move up and down one screen.
        {Ins}           Insert point at cursor location.
        {Del}           Delete point at cursor location.
        {Esc}           Exit editor.
        {Return}        Insert line.
        {F1}            Help.
        {F2}            Delete line.

/FGF
{f(x) =}

The function you want to be graphed.

Available functions:

        sqr     sqrt    exp     ln      log     sin     cos     tan
        arcsin  arccos  arctan  abs     sgn     int

Use {+},{-},{*},{/}.  To raise to a power, use {^}.  In addition:

        Bad:                    Good:

        a^b^c                   (a^b)^c or a^(b^c) avoids ambiguity.
        a^-1                    a^(-1)

Examples:

        x + x^2
        sin(x)^2

/FGXMIN
{MINIMUM X}

The minimum value of X on the plot.

/FGXMAX
{MAXIMUM X}

The maximum value of X on the plot.

/FGNPP
{NUMBER OF PLOTTED POINTS}

FGRAPH will calculate this number of equally-spaced points over the
chosen range of X values, and calculate f(x) for each value.  Then, a
curve will be approximated by connecting the points with a line.  Use a
larger number of points to get a smoother curve, or a smaller number for
speed.

/FGQUIT
{DISPLAY PLOT AND RETURN TO FGRAPH}

FGRAPH will now run GRAFSYS to display your plot.  After it is done
plotting, you can press any key to return to FGRAPH.

/FGSTAY
{DISPLAY PLOT AND STAY IN GRAFSYS}

FGRAPH will run GRAFSYS to display the plot.  After the plot is
complete, press any key to get into the main menu of GRAFSYS.  When you
quit GRAFSYS, you will be returned to FGRAPH.

/FGNAME
{NAME OF PLOT FILE}

Whenever FGRAPH runs GRAFSYS it saves the plot in a plot file.  You can
use this plot file later to recall the plot.

/DUMMY

This is the end of the GRAFSYS Help File.
