Resource Library: Graphics

home *** CD-ROM | disk | FTP | other *** search

/ Resource Library: Graphics / graphics-16000.iso / msdos / plotting / grfsy / grafsys.hlp < prev next >

Wrap

Text File | 1991-06-07 | 42KB | 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.