home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-06-07 | 41.2 KB | 1,378 lines |
- /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.
-