( BR) Details concerning the DESL pubplot command.

The DESL "pp" function allows the user to generate a PostScript file containing one or more frames of publication-qual graphic output.

Please review the anatomy of a plot for an overview of the main parts of a typical DESL plot.

A complete PostScript plot file can contain an unlimited number of frames. A "frame" is one page. Each frame can contain an unlimited number of plots. A "plot" is a display of information for up to 20 curves. A "curve" is a sequence of information which, in general, will be displayed together, represented by a certain symbol and/or line.

.	(Begin modifications on 052102) All curves for a particular plot can contain a maximum of 50000 points. (End modifications on 052102)

The time at which this total of points is established is AFTER

1. global conditions
2. file-specific conditions
3. restrictions based on the "pseq" state eliminations
4. data averaging has been applied but BEFORE (a) tolerance checks, (b) "voidval" checks, and data clipping occurs.

A "blank" box, filled or unfilled, is drawn before a key. A key is drawn before all "text" strings.

All LOCATION arguments which can be specified for "pp" options are in INCHES, unless otherwise stated. The default size of a plot is 10 inches by 10 inches. This size can be affected in many ways.

The "pp" function is unique among DESL functions in that the processing of specified options/argument lists is NOT totally order independent. Except where noted within the definition of specific options, the entry of option/argument lists IS order independent UP TO THE POINT of issuance of the "plot" or "plotf" option. At that time a plot is generated. After a plot is generated the user-specified sequence of options/argument lists is once again referenced until "plot" or "plotf" is encountered. This cycle repeats until the end of the user specifications is reached. Careful attention should always be paid to the current state of the definable plotting parameters.

Any blinking names enclosed in brackets are required or are in a set of options, one of which must be specified. Any non-blinking names enclosed in brackets are optional or are in a set of options, only one of which can be specified.

In cases where the option name is one of a set each different set number is indicated by a red numeric set number superscript trailing the respectiveright bracket :

[Top][Bottom][Option list]

( BRabsorigin) (Command :pubplot) Details for the absorigin option.

[General syntax rules for this keyword.]

Example : absorigin

[Top][Bottom][Option list]

( BRallfrom) (Command :pubplot) Details for the allfrom option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRaltvars) (Command :pubplot) Details for the altvars option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRannmag) (Command :pubplot) Details for the annmag option.

[General syntax rules for this keyword.]

Example : annmag 1.2

[Top][Bottom][Option list]

( BRaorigin) (Command :pubplot) Details for the aorigin option.

[General syntax rules for this keyword.]

Example : aorigin 40 .75

[Top][Bottom][Option list]

( BRarrowhead) (Command :pubplot) Details for the arrowhead option.

[General syntax rules for this keyword.]

Example : arrowhead 1.5

[Top][Bottom][Option list]

( BRauto) (Command :pubplot) Details for the auto option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRautox) (Command :pubplot) Details for the autox option.

[General syntax rules for this keyword.]

If "autox" or "auto" is specified, the scale extremes WILL be calculated and will override any which could also have been specified via "xmax" and/or "xmin". If the calculated "xmax" and "xmin" values are equal the plot is skipped.

[Top][Bottom][Option list]

( BRautoy) (Command :pubplot) Details for the autoy option.

[General syntax rules for this keyword.]

If "autoy" or "auto" is specified, the scale extremes WILL be calculated and will override any which could also have been specified via "ymax" and/or "ymin". If the calculated "ymax" and "ymin" values are equal the plot is skipped.

[Top][Bottom][Option list]

( BRautoz) (Command :pubplot) Details for the autoz option.

[General syntax rules for this keyword.]

If "autoz" is specified, the scale extremes WILL be calculated and will override any which could also have been specified via "zmax" and/or "zmin". If the calculated "zmax" and "zmin" values are equal the plot is skipped.

[Top][Bottom][Option list]

( BRavg) (Command :pubplot) Details for the avg option.

[General syntax rules for this keyword.]

Example : avg 1 1 4 2

[Top][Bottom][Option list]

( BRaxiscolor) (Command :pubplot) Details for the axiscolor option.

[General syntax rules for this keyword.]

Example : axiscolor 3

[Top][Bottom][Option list]

( BRaxisrot) (Command :pubplot) Details for the axisrot option.

[General syntax rules for this keyword.]

Example : axisrot 27.3

[Top][Bottom][Option list]

( BRaxlwt) (Command :pubplot) Details for the axlwt option.

[General syntax rules for this keyword.]

Example : axlwt .65

[Top][Bottom][Option list]

( BRbackward) (Command :pubplot) Details for the backward option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRblank) (Command :pubplot) Details for the blank option.

[General syntax rules for this keyword.]

A fifth value of 0 to 1 will produce a shaded rectangle without a frame. If the 0-->1 value has had 10 added to it, a black frame will also be drawn at the rectangle's perimeter. Up to 10 blank rectangles can be drawn per plot.

Example : blank 1 1 5 6 .85

[Top][Bottom][Option list]

( BRborder) (Command :pubplot) Details for the border option.

[General syntax rules for this keyword.]

Example : border 1 1 5 6 2 12

[Top][Bottom][Option list]

( BRbottominc) (Command :pubplot) Details for the bottominc option.

[General syntax rules for this keyword.]

Example : bottominc .5

[Top][Bottom][Option list]

( BRcangle) (Command :pubplot) Details for the cangle option.

[General syntax rules for this keyword.]

Example : cangle 5

[Top][Bottom][Option list]

( BRcdec) (Command :pubplot) Details for the cdec option.

[General syntax rules for this keyword.]

Example : cdec 4

[Top][Bottom][Option list]

( BRcdetail) (Command :pubplot) Details for the cdetail option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRcfiles) (Command :pubplot) Details for the cfiles option.

[General syntax rules for this keyword.]

The primary intent of the capability provided via "cfiles" is to allow the inclusion of information which is considered to be CONSTANT; ie, information which would normally be the SAME in ALL SIF DATA records read. An example of this type of data would be pressure port location information.

If specified, and an adjunct file is found and is of a type consistent with the "cfrom" specified or default file type specifier, the contents of the NAMEs record and the FIRST DATA record on the named "cfiles" file is effectively merged into the NAMEs and DATA records, respectively, to result in read SIF records which are as if they had contained the adjunct information originally. Up to 1000 SIF items can be added from an adjunct file.

Example : cfiles add1 add2 Indicates the adjunct files to be used - one per curve, for ADDITIONAL data extraction during plotting. There is a 1:1 correspondence between curves and "cfiles" file names. The primary intent of the capability provided via the "cfiles" is to allow the inclusion of information, along with the read SIF data, which is considered to be CONSTANT; ie, information which would normally be the SAME in ALL SIF records read. An example of this type of data would be pressure port location information.

If specified, and an adjunct file is found and is of a type consistent with the "cfrom" specified or default file type specifier, the contents of the NAMEs record and the FIRST DATA record on the named "cfiles" file is merged into the NAMEs and DATA records, respectively, to result in effective NEW records which are as if they had contained the adjunct information originally. Up to 1000 SIF items can be added from an adjunct file.

Example : cfiles add1 add2

[Top][Bottom][Option list]

( BRcfreq) (Command :pubplot) Details for the cfreq option.

[General syntax rules for this keyword.]

If a positive value follows "cfreq", this value IS the minimum distance, in inches, between contour in-line labels. The actual distance between labels may vary, depending on other label positioning parameters.

The default value of cfreq = 1.

Example : cfreq 0

[Top][Bottom][Option list]

( BRcfrom) (Command :pubplot) Details for the cfrom option.

[General syntax rules for this keyword.]

Example : cfrom ffsif sif rep 3 ffsif

[Top][Bottom][Option list]

( BRcharalign) (Command :pubplot) Details for the charalign option.

[General syntax rules for this keyword.]

Example : charalign

[Top][Bottom][Option list]

( BRckmag) (Command :pubplot) Details for the ckmag option.

[General syntax rules for this keyword.]

Example : ckmag 1.2

[Top][Bottom][Option list]

( BRclab) (Command :pubplot) Details for the clab option.

[General syntax rules for this keyword.]

Example : clab 202

[Top][Bottom][Option list]

( BRcldist) (Command :pubplot) Details for the cldist option.

[General syntax rules for this keyword.]

Example : cldist 1.5

[Top][Bottom][Option list]

( BRclevels) (Command :pubplot) Details for the clevels option.

[General syntax rules for this keyword.]

Example : clevels .4 .6 .8 .85 .9 .95

[Top][Bottom][Option list]

( BRclip) (Command :pubplot) Details for the clip option.

[General syntax rules for this keyword.]

Example : clip off

[Top][Bottom][Option list]

( BRclist) (Command :pubplot) Details for the clist option.

[General syntax rules for this keyword.]

.	(Begin modifications on 052102) All specified "clist" sets combined must have no more than 50000 elements. (End modifications on 052102)

There must be equal numbers of "xlist" and "ylist" and "clist" members for each respective curve-id specified.

The list of contour names/values which follow the curve-id number can include one or more of four special forms of implicit expansion methods : "curve", "thru", "at", and "to/by". If "curve" is used, a "curvefile" MUST be active. (See "curvefile" option.)

[Top][Bottom][Option list]

( BRclwt) (Command :pubplot) Details for the clwt option.

[General syntax rules for this keyword.]

Example : clwt .75

[Top][Bottom][Option list]

( BRcmax) (Command :pubplot) Details for the cmax option.

[General syntax rules for this keyword.]

Example : cmax .75

[Top][Bottom][Option list]

( BRcmin) (Command :pubplot) Details for the cmin option.

[General syntax rules for this keyword.]

Example : cmin .75

[Top][Bottom][Option list]

( BRcntld) (Command :pubplot) Details for the cntld option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRcolorkey) (Command :pubplot) Details for the colorkey option.

[General syntax rules for this keyword.]

If the type of surface plot is type 1 (see above) the color of the "inside" facets of the figure will be some shade (depending on facet orientation) of palette color number 1. (See the "palette" option.) The color of the"outside" facets of the surface will be a shade of palette color number 2.

If the type of surface plot is type 2 (see above) the color of the "inside" facets of the figure will be some shade (depending on facet orientation) of palette color number 1. (See the "palette" option.) The color of the "outside" facets of the surface will be a color which is determined by the correspondence between the local facet average value of the "z" dependent variable and the "z" values defined in the "colorkey" z_value-to-color pairing as discussed below.

In general, the syntax for the "colorkey" argument list is the following :

Example : colorkey 11240 2 10 6 3 0 3 8 4

[Top][Bottom][Option list]

( BRcolors) (Command :pubplot) Details for the colors option.

[General syntax rules for this keyword.]

Example : colors 1 32 2 18

[Top][Bottom][Option list]

( BRcontour) (Command :pubplot) Details for the contour option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRcopy) (Command :pubplot) Details for the copy option.

[General syntax rules for this keyword.]

Example : copy 2

[Top][Bottom][Option list]

( BRcorder) (Command :pubplot) Details for the corder option.

[General syntax rules for this keyword.]

Example : corder 2

[Top][Bottom][Option list]

( BRcpaths) (Command :pubplot) Details for the cpaths option.

[General syntax rules for this keyword.]

Example : cpaths ..\ ..\Main\ sub1\

[Top][Bottom][Option list]

( BRcports) (Command :pubplot) Details for the cports option.

[General syntax rules for this keyword.]

Example : cports 22

[Top][Bottom][Option list]

( BRcrvlwt) (Command :pubplot) Details for the crvlwt option.

[General syntax rules for this keyword.]

Example : crvlwt 1 1 5

[Top][Bottom][Option list]

( BRcset) (Command :pubplot) Details for the cset option.

[General syntax rules for this keyword.]

The item immediately following "cset" is the file sequence number in the "files" list for which the following up-to-20 conditions will be applicable.

Each file-specific 3-item condition, like its global 3-item condition counterpart, is made up of (1) a SIF variable name, (2) a 2-character logical conjunction, and (3) a second SIF variable name or a constant.

Example : cside 3

[Top][Bottom][Option list]

( BRcsize) (Command :pubplot) Details for the csize option.

[General syntax rules for this keyword.]

Example : csize .4

[Top][Bottom][Option list]

( BRcthresh) (Command :pubplot) Details for the cthresh option.

[General syntax rules for this keyword.]

Example : cthresh 3

[Top][Bottom][Option list]

( BRctol) (Command :pubplot) Details for the ctol option.

[General syntax rules for this keyword.]

Example : ctol -5

[Top][Bottom][Option list]

( BRcurvefile) (Command :pubplot) Details for the curvefile option.

[General syntax rules for this keyword.]

If a curvefile is to be used it MUST be specified BEFORE any "xlist" / "ylist" / "clist" which references it. This is an exception to the normal DESL input rule; normally, the order of specification of a particular function's input options and arguments is not important.

A curve segment extends until the next "curve" line is encountered.

Note that the structure of the "xlist", "ylist", and "clist" lines in a curve file is slightly DIFFERENT than when the "xlist", "ylist", and "clist" options are encountered in the normal stream of plotting input.

Example : curvefile pcurvs

[Top][Bottom][Option list]

( BRcurves) (Command :pubplot) Details for the curves option.

[General syntax rules for this keyword.]

Whether the number of curves is set EXPLICITLY by this "curves" option or set IMPLICITLY by the number of "files" specified, the established number of curves remains in effect until EXPLICITLY changed; ie, changed via a new "curves" specification. The number of curves WILL NOT be implicitly changed via "reset *files".

Example : curves 4

[Top][Bottom][Option list]

( BRdestin) (Command :pubplot) Details for the destin option.

[General syntax rules for this keyword.]

The string following "destin" must be no longer than 32 characters. If the destin string is longer than 16 characters, the question mark delimiters must be used.

Example : destin ?lpr -Plw PF?

[Top][Bottom][Option list]

( BRdfreq) (Command :pubplot) Details for the dfreq option.

[General syntax rules for this keyword.]

Example : dfreq 4 1 1 6

[Top][Bottom][Option list]

( BRdorigin) (Command :pubplot) Details for the dorigin option.

[General syntax rules for this keyword.]

Example : dorigin 1 -.3

[Top][Bottom][Option list]

( BRemptyplot) (Command :pubplot) Details for the emptyplot option.

[General syntax rules for this keyword.]

Example : emptyplot on

[Top][Bottom][Option list]

( BRencaps) (Command :pubplot) Details for the encaps option.

[General syntax rules for this keyword.]

Example : encaps

[Top][Bottom][Option list]

( BRendimport) (Command :pubplot) Details for the endimport option.

[General syntax rules for this keyword.]

Example : endimport eof

[Top][Bottom][Option list]

( BRendloop) (Command :pubplot) Details for the endloop option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRenrich) (Command :pubplot) Details for the enrich option.

[General syntax rules for this keyword.]

Example : enrich 15

[Top][Bottom][Option list]

( BReqtol) (Command :pubplot) Details for the eqtol option.

[General syntax rules for this keyword.]

Example : eqtol .5

[Top][Bottom][Option list]

( BRerrorbarcap) (Command :pubplot) Details for the errorbarcap option.

[General syntax rules for this keyword.]

Example : errorbarcap 3

[Top][Bottom][Option list]

( BRerrorbarlwt) (Command :pubplot) Details for the errorbarlwt option.

[General syntax rules for this keyword.]

Example : errorbarlwt 1.2

[Top][Bottom][Option list]

( BRerrorshade) (Command :pubplot) Details for the errorshade option.

[General syntax rules for this keyword.]

Example : errorshade .85

[Top][Bottom][Option list]

( BRfglwt) (Command :pubplot) Details for the fglwt option.

[General syntax rules for this keyword.]

Example : fglwt .55

[Top][Bottom][Option list]

( BRfgpattern) (Command :pubplot) Details for the fgpattern option.

[General syntax rules for this keyword.]

Example : fgpattern 1 2

[Top][Bottom][Option list]

( BRfigure) (Command :pubplot) Details for the figure option.

[General syntax rules for this keyword.]

Following the optional scale factor which can be specified there can be three other values specified. The first is a figure rotation angle, the next is the x center of rotation, and the third is the y center of rotation. The rotation angle is in degrees, positive being in the counterclockwise direction, and the x and y rotation center position is in inches, relative to the lower left corner of the page. If a figure is to be rotated, ONLY explicit x/y pairs should be specified in the figure; ie, no implicit curve-drawing figure specifications ("arc", etc) should be specified. The default rotation angle is 0. The default center of rotation is a x=0., y=0.

All "(r)imports" are done BEFORE all "(r)figures".

A figure file contains directives which instruct the plotting software as to what and how to draw desired lines and shapes. It is helpful to have PostScript documentation available when setting up a figure file as the primitives are referenced with respect to correct directive syntax. Basically, a figure file :

1. defines points which are later to be connected by a solid or dashed, visible or invisible line,
2. defines complete curves via the use of a curve-drawing directive, or
3. fills closed shapes.

All lengths and positions defined in a figure file are in inches. (See "rfigure" for exception.) All angles are in degrees.

The structure of a figure file must adhere to the following rules :

Some of the directives which can be contained in a figure file closely resemble the PostScript primitives they either mimic or match:

Example : figure 2 8.4 figfile fig1 .75

[Top][Bottom][Option list]

( BRfiles) (Command :pubplot) Details for the files option.

[General syntax rules for this keyword.]

This list of files can be implicitly extended via use of the <list argument which can appear among the specified file names. If one or more of the <list-type arguments are specified, where "list" is a currently defined file name list, the file names contained in the indicated file name list(s) will be included, at their respective point(s) of encounter, in the current file list. The referenced list(s) must have been produced by the "newfiles" and/or "newfilex" argument lists associated with one or more previously executed DESL commands. Each "list" name can be up to 15 characters long. File names can also include the {...} construct. This type specification within a file name implies that the list name given between the curly brackets ( {} ), is to be used to have each of its elements substituted in turn for the { ... }, inclusively, such that an implicit lengthening of the file list is accomplished, up to the maximum number of files allowed. Any time such a {...} usage occurs, all lists mentioned must exist; i.e., must have been previously defined in the current DESL session. Only one {...} construct can be included in a file name. Including more than one such construct will result in unpredictable results.

An example of this type of file name specification is the following :

t43r{runs}.sif

Here, the list "runs" will have its elements used, in turn, in place of the {runs} substring.

.	(Begin modifications on 052102) Each file name, whether it includes the {...} or not, can be a maximum of 256 characters long. If a file name is more than 16 characters long it must be enclosed in question marks (?) . (End modifications on 052102)

Example : files run1 thru run7 <flist48

[Top][Bottom][Option list]

( BRfinegrid) (Command :pubplot) Details for the finegrid option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRflagmag) (Command :pubplot) Details for the flagmag option.

[General syntax rules for this keyword.]

Example : flagmag 1 1.5

[Top][Bottom][Option list]

( BRfont) (Command :pubplot) Details for the font option.

[General syntax rules for this keyword.]

The default font = Times-Roman (11). After any string is drawn, the current font ALWAYS reverts back to the default font.

Example : font 63

[Top][Bottom][Option list]

( BRfrom) (Command :pubplot) Details for the from option.

[General syntax rules for this keyword.]

Example : from ffsif sif rep 3 ffsif

[Top][Bottom][Option list]

( BRglwt) (Command :pubplot) Details for the glwt option.

[General syntax rules for this keyword.]

Example : glwt .5

[Top][Bottom][Option list]

( BRgrid) (Command :pubplot) Details for the grid option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRgriddelay) (Command :pubplot) Details for the griddelay option.

[General syntax rules for this keyword.]

Example : griddelay

[Top][Bottom][Option list]

( BRhzero) (Command :pubplot) Details for the hzero option.

[General syntax rules for this keyword.]

Following the line weight value can be a third item specifying the line type horizontal line to be drawn. The default line type is a solid line (type 1). The possible line types are as indicated in the "lines" documentation.

.	(Begin modifications on 052102) Following the line type value can be a fourth item specifying the horizontal line color to be drawn. The value specified is a valid palette color number. (End modifications on 052102)

For a "polar" type plot the implication of "hzero" is dependent on the value of the xaxis or yaxis code specified. A summary of the actions taken for different values of "xaxis" and "yaxis" is as follows, where "NUM1" and "NUM2" are the two values which can follow "hzero" :

Example : hzero 0 3

[Top][Bottom][Option list]

( BRimpascii) (Command :pubplot) Details for the impascii option.

[General syntax rules for this keyword.]

There are additional text formatting control sequences which can be embedded in the ascii text file; see "import".

Example : impascii 22 .5 0.9 1.2

[Top][Bottom][Option list]

( BRimport) (Command :pubplot) Details for the import option.

[General syntax rules for this keyword.]

If the file is an ascii file, it will be converted to a PostScript file before being included in the plotted PostScript file being created.

The imported image can be thought of as a transparent sheet overlaid on the current plot. For ascii text files, the text will typically be located at the upper left hand corner of the transparent sheet.

A file imported via "import" will NOT be affected by any scaling which may already be in effect.

The contents of the text fields in an "acsii" file is like that which can be contained in text associated with the "text" option; ie, all of the "dollar-sign-ass type constructs are legal. However, some of these dollar-sign-asso constructs depend on definitions of tabs, etc which should have occurred outside of the ascii file itself.

There are several additional formatting constructs which can be embedded within the ascii file itself. These formatting controls affect the interpretation and display of the ascii text itself as it is ultimately included in the plotting PostScript file being created.

The formatting controls are of the form :

backslash + one or more strings and/or numbers

Following the name of the PostScript file to be imported is an optional scale factor. A value of less than 1 will cause a reduction in size of the imported image. Following the optional scale factor is an optional rotation angle at which the imported PostScript file will be drawn. This angles is in degrees and a positive angle rotates the figure counterclockwise The rotation axis is always the current plot's origin. All "(r)imports" are done BEFORE all "(r)figures".

Example : import 2 8.4 sketch.ps 1.2

[Top][Bottom][Option list]

( BRinsideout) (Command :pubplot) Details for the insideout option.

[General syntax rules for this keyword.]

Example : insideout

[Top][Bottom][Option list]

( BRinteger) (Command :pubplot) Details for the integer option.

[General syntax rules for this keyword.]

Example : integer on

[Top][Bottom][Option list]

( BRkey) (Command :pubplot) Details for the key option.

[General syntax rules for this keyword.]

Delayed keys must be dealt with within input to pubplot with a knowledge of HOW these keys are treated within the program. A delayed key defines a set of information which is to be plotted at some FUTURE time. Each set of information which could ultimately be included in a drawn key is created as being tied to a certain particular identification (id) number. Up to 1000 sets of delayed key information can be defined in one pubplot session. Delayed key information is saved on a scratch file and is referenced by its id number. Delayed key information sets are stored in the order that they are encountered.

There is nothing to prevent duplicate delayed key id numbers from being defined. This situation could easily arise when using the "loop"/"endloop" construct. Delayed key id numbers are always stored, for reference purposes, as the absolute value of the actual number specified. Therefore, when a delayed key information set is being DEFINED, it does not matter what sign the delayed key id number is; it will be stored as a positive number. However, when a key is to be DRAWN including one or more delayed keys, the sign of each delayed key information set is important. The absolute magnitude of the specified id numbers will be used for attempts at matches with previously-defin delayed key information sets.

The SIGN of each of the specified delayed key id numbers controls the DIRECTION of the search on the scratch file for a delayed key id match. Since delayed keys are stored IN THE ORDER THEY ARE ENCOUNTERED - ie, in chronological order, it is important to make sure that the search for delayed key id matches is conducted in the proper direction. A positive delayed key id number implies a FORWARD chronological search and a negative number implies a backward chronological search.

The next several items are numeric and are key-code dependent. If the key is to be delayed or should be drawn at the current time and include one or more delayed keys, then these items MUST be present. After these key-delay values, the actual desired key variables, whose values (or their string counterparts from a substitution file) are to be included in the column(s) of the key, must be specified. Key column headings are the same as these variable names unless they are translated via the use of a label file. A key can have up to 10 columns and 20 rows BEFORE recombination with delayed keys, and up to 20 columns and 30 rows AFTER recombination with delayed keys.

Color and line type attributes associated with a delayed key are actually assigned at the time when a delayed key is drawn; ie, when it is combined with other keys. The user has the ability to redefine both line patterns per line types and the color palette. If either or both of these are redefined between the time when a key is delayed and the time when a delayed key is drawn the key may not reflect the originally-speci respective attribute(s).

If an "unset" key variable is not found on the SIF file, the string *NF* will show up in the key in place of a value. Also, if "notify" is on, the user will be notified of the fact that the variable was not found.

Following each variable name a real (F, G, or E) or integer (I) format specification can be included. This format will override the default format of g10.3 for the particular variable it follows.

Following this optional real format specification the values which would have been established from SIF file data extraction for a particular key variable or strings which could have been defined via a substitution file can be defined.

If the word "set", followed by one or more values, is encountered the values assigned to the respective variable will be those following the "set" and will be, from that point on, treated as if they had come from the SIF file(s), whether or not the variable was found on the SIF file(s).

If a position in a list of "set" arguments needs to be skipped (ie, NOT explicitly set to a value) then the string "empty" can be used to effectively skip key entries which are NOT being reset.

If the word "setk" is encountered it must be followed by a number indicating how many key rows worth of values or strings are being set. Then, following that number, a sequence of the values and/or up-to-64-charact strings which are to be assigned to the named key variable should be specified.

If a value is specified in the sequence of values and/or strings, that value is assigned to the respective variable and will be, from that point on, treated as if it had come the SIF file, whether or not the variable was actually on the SIF file.

If a string is specified in the sequence of values and/or strings, that string is assigned to the respective variable and will be, from that point on, treated as if it had been defined as a result of a translation via the use of a substitution file. A string specified in a list of "setk" values/strings can be up to 64 characters long. If the string is to contain embedded blanks or be longer than 16 characters the question mark delimiters MUST be used.

If a position in a list of "setk" arguments needs to be skipped (ie, NOT explicitly set to a value or string) then the string "empty" can be used to effectively skip key entries which are NOT being reset.

In general, the syntax for the "key" argument list is the following :

1. kcode : 5-digit code value representing user desires for key style, delay items, substitution (see "kcode" definition below)

2. x/y : x and y location values (inches) from current origin to top left of "key box"

3. #1, #2,: context-specific delay values (see "kcode" definition below)

4. name : SIF variable name. Can be blank, as would be specified by "? ?" . Will be the key column heading unless changed via a label file. If all key column headings are blank the vertical space allowed for key headings will be eliminated.

5. fmt : E, F, or G real format for variable value display

6. set : delimiter indicating next "N" items are defined values to be put into the respective rows for this particular column. "empty" is allowed, implying no value is being set. A value, represented here as V#1, etc, like its SIF-derived counterpart, can be changed into a string via a substitution file's use. Values set in this way do NOT have to be associated with an EXISTING SIF variable; ie, the variable specified in "name" does NOT have to be on the respective SIF file. Values assigned via "set" will overstore values derived from SIF files.

7. setk : delimiter indicating next "snum" items are defined values or strings to be put into the respective rows for this particular column. "empty" is allowed, implying no value/string is being set. A string, represented here as Str#1, etc, is analogous to its substitution file-derived counterpart.

8. V#1,V#2, : Values to assign to a key variable per curve

9. Str#1, Str#2, : Strings to assign to a key variable per curve

where ...

hdr : either (1) a SIF variable name or (2) the corresponding translation from the use of a specified "label" file, or (3) a blank, having been specified by ? ?. If all key column headings are blank the vertical space allowed for key headings will be eliminated.

symb : optionally, the desired curve's symbol type

line : optionally, the desired curve's line style

### : a value from the SIF OR a "set"/"setk"-ind hardwired value

str : is a string which has been substituted for a value via the use of a substitution file or has been "setk"-induced

[Top][Bottom][Option list]

( BRkeytextcolors) (Command :pubplot) Details for the keytextcolors option.

[General syntax rules for this keyword.]

Example : keytextcolors 0 4 3 0

[Top][Bottom][Option list]

( BRkeydrop) (Command :pubplot) Details for the keydrop option.

[General syntax rules for this keyword.]

Example : keydrop 0 0 1 0 0 1

[Top][Bottom][Option list]

( BRkeyfill) (Command :pubplot) Details for the keyfill option.

[General syntax rules for this keyword.]

If the value following "keyfill" is negative the absolute value of the number is a palette color number to use for filling the key box.

Example : keyfill .98

[Top][Bottom][Option list]

( BRkeyframe) (Command :pubplot) Details for the keyframe option.

[General syntax rules for this keyword.]

Example : keyframe 0 0 -2 2

[Top][Bottom][Option list]

( BRkeyjustify) (Command :pubplot) Details for the keyjustify option.

[General syntax rules for this keyword.]

Example : keyjustify 0 0 2

[Top][Bottom][Option list]

( BRkeylines) (Command :pubplot) Details for the keylines option.

[General syntax rules for this keyword.]

Example : keylines

[Top][Bottom][Option list]

( BRkeymarks) (Command :pubplot) Details for the keymarks option.

[General syntax rules for this keyword.]

Example : keymarks .6

[Top][Bottom][Option list]

( BRkeyscale) (Command :pubplot) Details for the keyscale option.

[General syntax rules for this keyword.]

Example : keyscale .75

[Top][Bottom][Option list]

( BRkeyshadow) (Command :pubplot) Details for the keyshadow option.

[General syntax rules for this keyword.]

Example : keyshadow .07 -.07

[Top][Bottom][Option list]

( BRkeysymbsize) (Command :pubplot) Details for the keysymbsize option.

[General syntax rules for this keyword.]

Example : keysymbsize 1 2

[Top][Bottom][Option list]

( BRksqueeze) (Command :pubplot) Details for the ksqueeze option.

[General syntax rules for this keyword.]

If the value of the x key squeezing factor is negative more of the horizontal space between the lines/symbols and the first key body column will also be affected. If the value of the y key squeezing factor is negative more of the vertical space between the key column headers and the first key body line will also be affected.

Example : ksqueeze .5

[Top][Bottom][Option list]

( BRlabfile) (Command :pubplot) Details for the labfile option.

[General syntax rules for this keyword.]

1. All lines are ASCII,
2. Any line beginning with "* " is a comment and is ignored, (asterisk + one or more blanks)
3. Blank lines are ignored,
4. Only 2 items per line per translation : the first up to 16 characters and the second up to 50/64 characters. Any string longer than 16 characters MUST be enclosed in question-mark (?) delimiters. The 50-character limit is imposed for axis labels, the 64-character limit is imposed for all other labels.
5. Free-field interpretation. Therefore, embedded blanks require the "?" delimiters,
6. First item is label "corresponding" name; name to be translated must match VERBATIM with this name,
7. Second item is the name translation string.

An example of such a file is the following :

[Top][Bottom][Option list]

( BRlabmag) (Command :pubplot) Details for the labmag option.

[General syntax rules for this keyword.]

Example : labmag .5

[Top][Bottom][Option list]

( BRland) (Command :pubplot) Details for the land option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRlandscape) (Command :pubplot) Details for the landscape option.

[General syntax rules for this keyword.]

Example : landscape off

[Top][Bottom][Option list]

( BRlayout) (Command :pubplot) Details for the layout option.

[General syntax rules for this keyword.]

Example : layout 2 3 3 3

[Top][Bottom][Option list]

( BRlimits) (Command :pubplot) Details for the limits option.

[General syntax rules for this keyword.]

Example : limits on

[Top][Bottom][Option list]

( BRlimitx) (Command :pubplot) Details for the limitx option.

[General syntax rules for this keyword.]

Example : limitx on

[Top][Bottom][Option list]

( BRlimity) (Command :pubplot) Details for the limity option.

[General syntax rules for this keyword.]

Example : limity on

[Top][Bottom][Option list]

( BRlines) (Command :pubplot) Details for the lines option.

[General syntax rules for this keyword.]

Plotted lines are actually drawn via the use of one of the above line patterns or a user-defined line pattern (see the "lpattern" option) via the use of a particular PostScript line pattern. In either case, if a symbol is also drawn for a particular curve, the distance between the symbols may have an effect on the part of the line pattern which is visible. After each symbol is drawn the curve's line pattern begins at a random position in its cycle. If the distance between symbols is small and the line pattern being drawn has one or more relatively long solid segments in it, the possibility of the pattern beginning somewhere in that long solid segment is high and could cause the apparent situation of the distinguishing section(s) of the line pattern being drawn in a relatively few locations on the curve.

Up to 20 line types can be specified. If 1000 is added to the line type, the corresponding curve entry will be omitted from a key which may be drawn. The line type used to draw the corresponding curve, in this case, is modulo (line_type,1000) There is no default line type. If no line type and no symbol type are specified, no curve will be plotted.

The line types defined will also be used in a 1:1 correspondence to specified contour level values when drawing a contour plot. The "colors" option can be used to cause the lines drawn to be other than the default color of black.

Example : lines 0 1 2 0

[Top][Bottom][Option list]

( BRlinescale) (Command :pubplot) Details for the linescale option.

[General syntax rules for this keyword.]

Example : linescale 4.0

[Top][Bottom][Option list]

( BRlist) (Command :pubplot) Details for the list option.

[General syntax rules for this keyword.]

Example : list loop1 run1 thru run8

Example : list 5000 1 4 7 8 to 12

[Top][Bottom][Option list]

( BRloop) (Command :pubplot) Details for the loop option.

[General syntax rules for this keyword.]

The following section of "pp" input is legitimate:

But, the following section of "pp" input is NOT legitimate:

The second input section is not legitimate because ONLY values MUST follow "symbols". This is why the dummy loop parameter variable name MUST be a name which "looks" like a value.

The number of settings which are specified for the "list"-defined loop variables IS the upper limit on the number of trips which will be taken through the respective loop block. Subsequent loop trips after the first trip use the NEXT loop variable setting as defined by "list".

If all of the loop variables were NOT defined as having the SAME number of elements, the list whose number of elements was the SHORTEST will determine the actual number of loop trips taken. Each of the up-to-20 loop variables which could have been defined are incremented in parallel as cycling through the loop progresses. The settings of all of the "pp" flags/switches (set via default or specific option/ argument-list entries) in effect at the TOP of a loop are in effect at the TOP of EACH CYCLE of the SAME loop - WHETHER OR NOT any "pp" settings were changed WITHIN the loop.

Example :

[Top][Bottom][Option list]

( BRlpattern) (Command :pubplot) Details for the lpattern option.

[General syntax rules for this keyword.]

Example : lpattern 3 10 3 5 3

[Top][Bottom][Option list]

( BRlwt) (Command :pubplot) Details for the lwt option.

[General syntax rules for this keyword.]

Example : lwt 1.

[Top][Bottom][Option list]

( BRmaglevels) (Command :pubplot) Details for the maglevels option.

[General syntax rules for this keyword.]

Example : maglevels 1 -24 0 1.34 2 1.5

[Top][Bottom][Option list]

( BRmesh) (Command :pubplot) Details for the mesh option.

[General syntax rules for this keyword.]

Example : mesh 1 2

[Top][Bottom][Option list]

( BRmirror) (Command :pubplot) Details for the mirror option.

[General syntax rules for this keyword.]

Example : mirror 90

[Top][Bottom][Option list]

( BRnewkeylines) (Command :pubplot) Details for the newkeylines option.

[General syntax rules for this keyword.]

Example : newkeylines 1 2

[Top][Bottom][Option list]

( BRnewkeysymbols) (Command :pubplot) Details for the newkeysymbols option.

[General syntax rules for this keyword.]

Example : newkeysymbols 901 2

[Top][Bottom][Option list]

( BRnolines) (Command :pubplot) Details for the nolines option.

[General syntax rules for this keyword.]

Example : nolines

[Top][Bottom][Option list]

( BRnoop) (Command :pubplot) Details for the noop option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRnosymbols) (Command :pubplot) Details for the nosymbols option.

[General syntax rules for this keyword.]

Example : nosymbols

[Top][Bottom][Option list]

( BRnotify) (Command :pubplot) Details for the notify option.

[General syntax rules for this keyword.]

Also, if notify is on, an x or y plot or sort variable which is NOT found on the appropriate SIF file will be reported. The default state is "on".

Example : notify off

[Top][Bottom][Option list]

( BRnumclevels) (Command :pubplot) Details for the numclevels option.

[General syntax rules for this keyword.]

Example : numclevels 4

[Top][Bottom][Option list]

( BRoldlimits) (Command :pubplot) Details for the oldlimits option.

[General syntax rules for this keyword.]

Example : oldlimits

.

(Begin modifications on 052405) [Top][Bottom][Option list] ( BRoldlimitsx) (Command :pubplot) Details for the oldlimitsx option. [General syntax rules for this keyword.] If this option is specified, the settings WHICH WERE ACTUALLY USED for the X axis scaling parameters (minimum, maximums, deltas, lengths, and compression factors) for the previous plot will be used again, REGARDLESS of whether or not any of the options which would normally have been used to explicitly set one or more of these parameters is specified or not. This option is not meaningful except for the second through the last plot being done. Only "oldlimitsx" OR "oldlimitsy" should be specified for a particular plot. If both need to be used "oldlimits" must be specified. Example : oldlimitsx (End modifications on 052405)

.

(Begin modifications on 052405) [Top][Bottom][Option list] ( BRoldlimitsy) (Command :pubplot) Details for the oldlimitsy option. [General syntax rules for this keyword.] If this option is specified, the settings WHICH WERE ACTUALLY USED for the Y axis scaling parameters (minimum, maximums, deltas, lengths, and compression factors) for the previous plot will be used again, REGARDLESS of whether or not any of the options which would normally have been used to explicitly set one or more of these parameters is specified or not. This option is not meaningful except for the second through the last plot being done. Only "oldlimitsx" OR "oldlimitsy" should be specified for a particular plot. If both need to be used "oldlimits" must be specified. Example : oldlimitsy (End modifications on 052405)

[Top][Bottom][Option list]

( BRorigin) (Command :pubplot) Details for the origin option.

[General syntax rules for this keyword.]

Example : origin 3 4

[Top][Bottom][Option list]

( BRpalette) (Command :pubplot) Details for the palette option.

[General syntax rules for this keyword.]

Example : palette 3 .5 0 .8

Palette color numbers can range from 1 to 50. The color red/green/blue values are combined to form resulting colors. If these three color values are the same, between 0 and 1, the resulting color is some shade of gray : all 0's is black, all 1's is white. All other colors result from some other combinations of these three values. The palette color numbers defined are referenced by then "color", "blank", "border", "keyfill" and "text" options and the "$K" in-line string construct. (See "text".) The default color values for each of the 50 allowable palette colors is 0, 0, and 0, representing the color black.

Example : palette 12 .2 .6 .4 3 .5 0 .8

[Top][Bottom][Option list]

( BRpaper) (Command :pubplot) Details for the paper option.

[General syntax rules for this keyword.]

1. all lines are ASCII
2. any line beginning with "* " is a comment and is ignored (asterisk + one or more blanks)
3. blank lines are ignored
4. only 2 items per line per translation : the first up to 16 characters and the second up to 64 characters. Any string longer than 16 characters MUST be enclosed in question-mark (?) delimiters.
5. free-field interpretation, therefore embedded blanks require the "?" delimiters
6. first item is name to be translated; must match VERBATIM with path name specified or implied via "paths" argument list
7. second item is the corresponding path name translation

An example of such a file is the following :

Example : pathfile pathA

[Top][Bottom][Option list]

( BRpaths) (Command :pubplot) Details for the paths option.

[General syntax rules for this keyword.]

Example : paths ..\ ..\Main\ sub1\

[Top][Bottom][Option list]

( BRpdump) (Command :pubplot) Details for the pdump option.

[General syntax rules for this keyword.]

Example : pdump *files *x *symbols

[Top][Bottom][Option list]

( BRplot) (Command :pubplot) Details for the plot option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRplotf) (Command :pubplot) Details for the plotf option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRplotfile) (Command :pubplot) Details for the plotfile option.

[General syntax rules for this keyword.]

Example : plotfile PF

[Top][Bottom][Option list]

( BRplusmag) (Command :pubplot) Details for the plusmag option.

[General syntax rules for this keyword.]

Example : plusmag 2

[Top][Bottom][Option list]

( BRpolaroff) (Command :pubplot) Details for the polaroff option.

[General syntax rules for this keyword.]

Example : polaroff 3

[Top][Bottom][Option list]

( BRpolarrot) (Command :pubplot) Details for the polarrot option.

[General syntax rules for this keyword.]

Example : polarrot 90

[Top][Bottom][Option list]

( BRprestore) (Command :pubplot) Details for the prestore option.

[General syntax rules for this keyword.]

Example : prestore ps1 psfile3

[Top][Bottom][Option list]

( BRpsave) (Command :pubplot) Details for the psave option.

[General syntax rules for this keyword.]

Example : psave ps1 psfile3

[Top][Bottom][Option list]

( BRpseq) (Command :pubplot) Details for the pseq option.

[General syntax rules for this keyword.]

If it is known that the data to be extracted for adjacent curves, which use the SAME SIF file, exist sequentially on the SIF file, then a definite I/O speed advantage can be achieved by the use of the "on" argument because the SIF file in question will NOT be rewound before the data for the next curve is searched for.

If the "on" or "once" argument is specified, the FIRST record from a file which FAILS to meet any conditions specified, AFTER at least one record HAS satisfied these same conditions, will cause reading of the file to end. The use of the "once" argument is a good way to speed up file processing when doing pressure plots when ONLY one data point is needed to plot the curve.

If "on" is specified and the last record of the file is processed while not encountering any records which fail the condition(s) for the current curve (file) processing of the next curve (file) will begin with a rewond file.

The default "pseq" state is "off" : read through the entire SIF file and rewind the SIF file after each curve.

Example : pseq on

[Top][Bottom][Option list]

( BRpsort) (Command :pubplot) Details for the psort option.

[General syntax rules for this keyword.]

Example : psort alpha alpha null alpha

[Top][Bottom][Option list]

( BRptag) (Command :pubplot) Details for the ptag option.

[General syntax rules for this keyword.]

Example : ptag ?flap = 20?

[Top][Bottom][Option list]

( BRpubnum) (Command :pubplot) Details for the pubnum option.

[General syntax rules for this keyword.]

Example : pubnum .275

[Top][Bottom][Option list]

( BRquick) (Command :pubplot) Details for the quick option.

[General syntax rules for this keyword.]

Also, the axis labels will be set to the same as the respective axes variable names.

The location in the "pp" input specifications where "quick" is encountered is important if one or more of the parameters which are set when "quick" is specified are also explicitly set. In this case, the last specification, whether explicitly set or via "quick", will have precedence or will possible extend a list defined earlier. It may be necessary to use the "reset" option to accomplish the desired settings when "quick" is also specified.

Example : quick

[Top][Bottom][Option list]

( BRreassociate) (Command :pubplot) Details for the reassociate option.

[General syntax rules for this keyword.]

Following this option name is either (1) a positive or negative integer, indicating the number of slots within the aforementioned option value lists to shift right or left, respectively, (2) the string "rev" or "reverse", or the number 0, incicating a reversal of the current order of the aforementioned option value lists, or (3) up to 20 values indicating the new order for the existing values of the aforementioned options. Either the number 0 or the string "reverse" implies the reversal of the existing order of these values.

Example : reassociate -3

[Top][Bottom][Option list]

( BRreset) (Command :pubplot) Details for the reset option.

[General syntax rules for this keyword.]

Most "pubplot" plotting parameters are automatically reset when a new value is specified for them. There are SOME parameters, however, which are NOT reset merely by redefining them but actually have their current list ADDED to. These parameters include "files", "x", "y", "lines", "symbols", "splines", and "cset". These parameters should usually be explicitly reset before redefining them.

.	(Begin modifications on 103102) The settings for "scale" and "plotfile" are NOT reset at "reset all". (End modifications on 103102)

Example : reset *files *x *symbols

[Top][Bottom][Option list]

( BRrfigure) (Command :pubplot) Details for the rfigure option.

[General syntax rules for this keyword.]

In a figure to be drawn in the PLOT'S coordinates; ie, if the x and y positions are NOT specified :

NO curved-line drawing commands should be used; ie, all lines drawn in the figure should be as a result of two or more x/y explicit or implicit pairs having been specified.

Following the optional scale factor which can be specified after the name of the figure being drawn there can be three other values specified. The first is a figure rotation angle, the next is the x center of rotation, and the third is the y center of rotation. The rotation angle is in degrees, positive being in the counterclockwise direction. The x and y rotation center position is either in inches or plotted data units, depending on whether the figure x/y location has been specified (see above). If the center position is in inches it is relative to the origin of the plot. If an "rfigure"-drawn figure is to be rotated, ONLY explicit x/y pairs should be specified in the figure; ie, no implicit curve-drawing figure specifications ("arc", etc) should be specified.

All "(r)imports" are done BEFORE all "(r)figures".

Example : rfigure 5 .4 figure fig1

[Top][Bottom][Option list]

( BRrimport) (Command :pubplot) Details for the rimport option.

[General syntax rules for this keyword.]

Example : rimport 0 1 sketch.ps

[Top][Bottom][Option list]

( BRrotations) (Command :pubplot) Details for the rotations option.

[General syntax rules for this keyword.]

Example : rotations roll -30 20 yaw

[Top][Bottom][Option list]

( BRscale) (Command :pubplot) Details for the scale option.

[General syntax rules for this keyword.]

Example : scale .5

[Top][Bottom][Option list]

( BRscreen) (Command :pubplot) Details for the screen option.

[General syntax rules for this keyword.]

Example : screen pageview

[Top][Bottom][Option list]

( BRsetvoid) (Command :pubplot) Details for the setvoid option.

[General syntax rules for this keyword.]

Example : setvoid -888.

[Top][Bottom][Option list]

( BRshade) (Command :pubplot) Details for the shade option.

[General syntax rules for this keyword.]

The second value is optional and is used to control the shading intensity of the surface when the shading is a function of surface orientation. The default value is .4. The specified value should be between 0 and 1. The closer the value is to 1, the lighter the shading will be. The actual color of the surface is governed by the "colorkey" option arguments.

Example : shade -1 .5

[Top][Bottom][Option list]

( BRsplines) (Command :pubplot) Details for the splines option.

[General syntax rules for this keyword.]

For example, if an enrichment factor is 10 then the curve will appear as though 10-3, or 7, ADDITIONAL points will be interpolated for between each original data point; three of the desired number of new interpolated points are always required for internal calculations.

If a following value = 1, then the default enrichment factor (see "enrich") is used. If a value is greater than 2 this value supersedes the default enrichment for the respective curve. A value of 2 causes NO line to be drawn.

A curve which will be drawn as a spline, can have no more than 200 data points and MUST have at least 3 points. If fewer than three points exist in a curve to be plotted as a spline the spline request will be ignored and a warning message will be issued.

Example : splines 0 1 20 1

[Top][Bottom][Option list]

( BRspsymbols) (Command :pubplot) Details for the spsymbols option.

[General syntax rules for this keyword.]

Example : spsymbols 2 901 .4 .5 -10 10

[Top][Bottom][Option list]

( BRsubsfile) (Command :pubplot) Details for the subsfile option.

[General syntax rules for this keyword.]

For either substitution into a "text" string or into a "key", the VALUE to be used for an exact- or range-match in the substitution file is an AVERAGE value for one or more curve's data. In a key, the value used for entry into the substitution file is the average value for the respective curve being described in the key. In a text string, the value used is either the average value for the specified parameter as it exists for ALL data being considered or is the average value of that parameter from some particular specified curve number. (See the "text" option.)

The rules governing structure of a substitution file are the following :

1. all lines are ASCII
2. any line beginning with "* " is a comment and is ignored (asterisk + one or more blanks)
3. blank lines are ignored
4. free-field interpretation, therefore embedded blanks require the "?" delimiters
5. Each line containing valid substitution specs MUST contain : in item 1, a SIF variable name to match an asterisk-delimit "title" (SIF) value; in item 2, a value which represents, if item 3 is also a value, the lower bound of a RANGE of values or, if item 3 is a name, the value to match EXACTLY; in item 3, a value which represents the upper bound of a RANGE of of values OR the (beginning of the) string to substitute for the value in question; in item 4, if there are more than 3 items specified, the (remainder of the) string to substitute for the value in question. Long strings (>16 characters) can be achieved by enclosing up to 64 characters with the standard question mark delimiters.
6. The SIF variable name specified in item 1 WILL be translated to upper case UNLESS the "namecase" status is NOT in "force upper". (See the "namecase" and "status" commands.)

For an exclamation point-delimited SIF variable in a text string, a substitution file WILL NOT be searched EVEN if one is specified.

An example of a substitution file is the following :

Example : subsfile subf1

[Top][Bottom][Option list]

( BRsurface) (Command :pubplot) Details for the surface option.

[General syntax rules for this keyword.]

The colors which are used to shade a surface plot are determined by pointers to the set of colors established by the "palette" argument list. The "inside" surface is always drawn using the FIRST palette color.

The surface facet resolutions in the X and Y directions are governed by the "xtic" and "ytic" option/argument lists, respectively. The light source for a surface plot which is shaded as a function of the facet orientation is at the same position as the viewpoint.

Example : surface

[Top][Bottom][Option list]

( BRsymbfigs) (Command :pubplot) Details for the symbfigs option.

[General syntax rules for this keyword.]

The general structure of the "symbfigs" argument list is shown below :

• "sym1" ...... the symbol number being redefined,
• "sym2" ...... the optional symbol number to be ALSO drawn
• "figfile" ... the name of the file containing the figure
• "scl" ....... the scale factor to be applied to the figure
• "X-tran" .... the horizontal origin translation distance, in
• "Y-tran" .... the vertical origin translation distance, in
• "fig" ....... the name of the figure to be drawn

The first item following the "symbfigs" option must be the symbol number being redefined. Following the symbol number being redefined can be an optional symbol number to draw IN ADDITION TO the new symbol shape. If a symbol is to be also drawn it is drawn BEFORE the figure is drawn. Following these one or two items should be the name of the file which contains one or more "figures". Following the name of the figure file are three values representing the scale factor and an X and a Y translation value. The figure to be drawn instead of the symbol being redefined is normally drawn with the units as defined in the figure drawing commands. Whereas normally the "origin" reference point for a figure is either the lower left corner of the page or the current plot origin the origin of the figure when being used to redefine a symbol shape if the center of the symbol itself - or the data point position. The two X and Y translation values are expressed in inches and allow the user to adjust the position of the figure to be drawn such that the "center" of the figure will be drawn at the data point being plotted. The scale factor specified will be used to scale the figure AFTER it has had its "center" been positionally adjusted. The translation values are in inches. A scale factor less than 1.0 will reduce the size of the figure.

Following the three scale and translation values is the name of the figure to be drawn as the redefined symbol shape. (Again, see the "figure" option for a discussion of the possible contents of a figure.) Up to 20 symbol redefinitions can be specified in one or more sets of this type of 6- or 7-item argument list section.

Example : symbfigs 12 figfile .02 0 10 fig_1

[Top][Bottom][Option list]

( BRsymboff) (Command :pubplot) Details for the symboff option.

[General syntax rules for this keyword.]

Example : symboff 1 1.5 0.

[Top][Bottom][Option list]

( BRsymbolfill) (Command :pubplot) Details for the symbolfill option.

[General syntax rules for this keyword.]

Example : symbolfill 902 .95 904 .8

[Top][Bottom][Option list]

( BRsymbols) (Command :pubplot) Details for the symbols option.

[General syntax rules for this keyword.]

Symbol numbers 1 through 20 can also be drawn with a "flag" protruding from their boundaries. A "flag" is a one- or two-segment line whose first segment is drawn in a radial direction from the symbol's center and whose optional second segment is drawn perpendicular to the first segment, joining the first segment at their ends. The lengths of these two segments are 6 and 4 points, respectively. These "flagged" symbols correspond to the NASA LaRC standard symbol numbers of 101 through 120, 201 through 220, ... , and 801 through 820. The position and type of flag (1 or 2 segments) is governed by the value of the symbol code. Adding 100, 200, 300, or 400 to the symbol codes of from 1 to 20 will imply a one-segment flag is to be drawn on the specified symbol. Adding 500, 600, 700, or 800 to the symbol codes of from 1 to 20 will imply a two-segment flag is to be drawn on the specified symbol. A one-segment flag is a line drawn radially on the outside of the symbol. A two-segment flag is a one-segment flag with a perpendicular segment at its end. The position at which the flag will be drawn is such that the radial line coincident with the flag's first line segment is at 45, 135, 225, or 315 degrees, respectively, as measured in a counter-clockwis direction from the positive X-axis :

Adding 900 to the symbol numbers 1 through 10 yields the respective SOLID symbol.

If 1000 is added to the symbol type, the corresponding curve entry will be OMITTED from a key which may be drawn. The symbol type which will be used for the corresponding curve, in this case, is modulo (symb_type,1000)

.	(Begin modifications on 123002) If 2000 is added to a solid (9xx) symbol type, the symbols drawn will be drawn with a black outline. (End modifications on 123002)

Symbol numbers of 3x thru 6x, where "x" is 1 to 6, imply that the respective curves to be plotted are to be considered to be "delta", or "error", information. Plots of error type information are defined to be based on some other "baseline" curve also being plotted. The baseline curve must not have a symbol number in the range 31 through 99. The position of an error-type symbol number in the list of all expressed or implied symbol numbers is important. The associated baseline curve can either appear before or after the error-type symbol number. If the symbol number's tens-digit is 3 or 5 then a search is made in the backward direction in the list of symbols. If the symbol number's tens-digit is 4 or 6 then a search is made in the forward direction in the list of symbols.

If the symbol number's tens digit is 3 or 4 the type of plot which is produced is an "error bar" plot; ie, the error data is plotted as a bar or line which extends outward in one or two directions from the baseline data point's symbol. The direction of this type of line is controlled by the symbol number's ones digit : a 1 implies a line to the right, a 2 implies a line upward, a 3 implies a line leftward, and a 4 implies a line downward. A symbol number ones digit value of 5 implies 1 and 3 while a symbol number ones digit value of 6 implies 2 and 4. If the symbol number's ones digit is 5 or 6 the error type data is assumed to be applicable in both of the implied directions equally and will be drawn in such a manner. The length of the line(s) drawn outward from the base line data value is governed by the value of the error data itself.

If the symbol number's tens digit is 5 or 6 the type of plot which is produced is an "shaded error band" plot; ie, the error data is plotted as a shaded band which extends outward in one or two directions from the baseline data point's symbol. The direction of this type of shaded band is controlled by the symbol number's ones digit : a 1 implies a band to the right, a 2 implies a band upward, a 3 implies a band leftward, and a 4 implies a band downward. A symbol number ones digit value of 5 implies 1 and 3 while a symbol number ones digit value of 6 implies 2 and 4. If the symbol number's ones digit is 5 or 6 the error type data is assumed to be applicable in both of the implied directions equally and will be drawn in such a manner. The width of the band(s) drawn outward from the base line data value is governed by the value of the error data itself.

The error bar type symbols can have a perpendicular "cap" drawn at their ends. The length of this cap is controlled by the option "errorbarcap". The width of the error bar lines, including the caps, is controlled by the option "errorbarlwt" or the current color per curve as specified by the "colors" option argument list.

It is important to note a few things :

Both the baseline and the error type curves MUST have the SAME number of data points. If this is NOT the case the error type curve will be skipped. Since it is likely that the baseline data and the associated error type data will vary widely in magnitude it is important to realize that if tolerances and limits (clipping is disallowed for error type curves) are imposed it is possible to create data sets - baseline and error type - which contain a different number of data values. A worse case which could arise is that if tolerances, etc are imposed and, coincidentally, the results are that the two associated baseline and error type curves contain the SAME number of data values it is NOT guaranteed that the associated pairs of data points still logically correspond. The shade of the band is controlled by the option "errorshade" or the current color per curve as specified by the "colors" option argument list.

Up to 20 symbol types can be specified. There is no default symbol type. If no line type and no symbol type are specified, no curve will be plotted. The "colors" option can be used to cause the symbols drawn to be other than the default color of black.

Example : symbols 1 0 0 5

[Top][Bottom][Option list]

( BRsymbsize) (Command :pubplot) Details for the symbsize option.

[General syntax rules for this keyword.]

Example : symbsize 1 1.5 1

[Top][Bottom][Option list]

( BRtabs) (Command :pubplot) Details for the tabs option.

[General syntax rules for this keyword.]

Example : tabs A 2.3 T 1.1 6.0 R 5.444 4.0

[Top][Bottom][Option list]

( BRtext) (Command :pubplot) Details for the text option.

[General syntax rules for this keyword.]

For the x location, the first item can also be one of "center", "centerf", "centerk", "centerpf", or "centerpk". For the y location, the second item can also be one of "top", "topf", "topk", "toppf", "toppk", "bottom", "bottomf", "bottomk", "bottompf", or "bottompk". In these cases the meanings of the prefixes "center", "top", "bottom" are, respectively, position horizontally at the "center" of the plot area in question, position vertically near the top of the plot area in

question, and position vertically near the bottom of the plot area in question. The "plot area" is determined by the string suffix. No suffix implies that the plot area is the entire figure (page). The plot area implied by the suffix "f" is the "figure" AS DRAWN THUS FAR without accounting for the extent of any key which may have also been drawn. The plot area implied by the suffix "k" is the "figure" AS DRAWN THUS FAR accounting for the extent of key(s) which may have also been drawn. The plot area implied by the "pf" suffix is the CURRENT FIGURE ONLY without accounting for the extent of any key which may have also been drawn. The plot area implied by the suffix "pk" is the CURRENT FIGURE ONLY accounting for a key which may have also been drawn.

There are six optional numeric items which may follow the x/y position values/codes. A numeric item can be skipped by entering "null". A skipped numeric argument remains set at its default value.

The first of these six is a text magnification factor. If this numeric argument is positive it represents the text magnification factor to be applied to the current text string. If this numeric argument is negative the absolute value of the number is the desired actual point size at which the current text string will be drawn, regardless of the current plot scaling and "pubnum" settings; ie, the effective text magnification value is recalculated.

The default text magnification value is 1.

The second of these six implies a box and a shading factor if the value is greater than or equal to 0 or a text shadowing effect if the value is negative.

If a box is to be drawn behind the text string, it is drawn before the text itself is drawn. The box can be filled with a shade from white to black and may have a line drawn at its perimeter according to the magnitude of this value. A value of 0 to 1 will produce a shaded box without a frame. The value 0 corresponds to black, and 1 corresponds to white. If the 0-->1 value has 10 added to it, a frame will also be drawn at the box's perimeter.

If text shadowing is to be done, the absolute magnitude of the value specified is a factor representing the fraction of the current font's point size to "white out" around each character. The time at which the white shadow is produced depends on the composition of the string being drawn.

Normally, the dollar sign special character, which is used to signal a change in font style, font size, or character position, is also the point in the overall text string where the characters UP TO THAT POINT are drawn. If a shadow is desired, the order of drawing is (1) white shadow, then (2) text string. The important point here is that a subsequent string of characters has the potential, depending on the width of the white shadow, to obscure some of the previous characters in the same text string.

This type of shadowing has the effect of hiding only the minimum "behind-text" lines, etc, which have been previously drawn.

The third of these six is used to specify a rotation angle for the text string in question. Angles are measured positive counterclockwise with 0 degrees causing the text string to move to the right, horizontally.

The fourth of these six items is a curve number. If the value specified is greater than 0 and less than or equal to the number of curves being plotted in the current plot, any averaging of values to be done in the process of completing one or more asterisk-delimit or exclamation-deli SIF variable replacements in the text string will be an average over the specified curve's data and NOT over all curves in the plot, as is the default situation. The default curve number per text string is 0.

The fifth of these six items is a text id number. If the specified value is positive, the associated text string is implied to be one which can ONLY be caused to appear as a result of a "text"-type construct in a figure file; the text string will NOT be shown at the location specified by the horizontal and vertical expressed or implied positions. (See "rfigure".) The text string will be drawn at the desired horizontal and vertical position. A specified value of 0 has no meaning and is ignored.

The sixth of these six items is a text palette color number. This color number will be used when drawing the text unless preempted by an inline "$K" string construct. The default color for the text string is black.

After the x/y position codes and the up-to six optional items which could follow, the text string itself is entered. The text string is an up-to-200 character, question-mark delimited string. The string is a line of arbitrary text, possibly including SIF variable names. Any legal PostScript "$" controlling sequences (ie, font, level codes, tabs) can be contained in a text string. (See below for more info.)

Also included in this string of characters can be up to 10 asterisk- or exclamation point-delimited constructs of the type :

1. *file#*, where "file" serves as a option implying that the specified file's name is to be substituted in that position. Here, "#" represents a number indicating which file of the up-to-20 files possibly specified to reference, (example : *file3* implies the name of the expressed or implied file number 3),
2. *datetag*, where "datetag" serves as a option implying that the current date and time are to be substituted in that position,
3. * name (fmt) * or ! name (fmt) !, where "name" is a SIF variable and "(fmt)" is an optional real (E, F, or G) or integer (I) format specification, or
4. * value *, where value is a supplied number.

Example of such strings are the following :

When the text string is printed this type of asterisk- or exclamation point-delimited string is replaced by a value, which is the value of the variable named within the string. The value of each variable indicated is an average value for the named SIF variable for the data being plotted in ALL of the curves for the current plot, except in the case where a specific curve number has been specified as the fourth value in the "text" argument list after the text "y" location parameter. In this case the averaging is limited to the specified curve.

If the delimiter used is an asterisk (*) and a valid substitution file has been specified via "subsfile" then, for each such expressed or implied value to be printed, a search through the substitution file is made to check for exact matches or range matches for the value of the SIF variable in QUESTION or, if a specific value was given, for ANY variable. If such a match is found, the corresponding string in the substitution file is inserted into the text string in place of the value in question. If, instead of the asterisk (*), the exclamation point (!) is used as a delimiter, no search will be made for a string to substitute for the value in the applicable text string EVEN IF A SUBSTITUTION FILE HAS BEEN SPECIFIED.

Only one variable is allowed per asterisk- or exclamation point-delimited string. If that variable is not found in the SIF file being printed, that delimited string is effectively eliminated from the text string. The values displayed in a text string are either in the current default format or can be printed in an optionally-speci other real format. Following each variable name a real (F, G, or E) or integer (I) format specification can be included.

There are 9 fonts which can be accessed : see "font" for styles.

Here, the word "wind" will be printed in Times-RomanItali font, whereas the rest of the sentence will be printed in the Times-Roman font. The default font is Times-Roman ($11).

Some characters in each of the fonts cannot be implied by entering their character in a name or title; ie, some characters which a PostScript printer can print are NOT on a keyboard. To print a character which is not on a keyboard, a 3-digit octal number corresponding to that character in the desired font can be entered, PRECEDED BY AN ESCAPING BACKSLASH.

Since the asterisk and/or exclamation point is used in the above-mentioned context for the "text" option/argument list, it should NOT be used for any other purpose in a text string.

Since the characters "*" and "!" are used to imply a substitution, they MUST be specified via the backslash and three-digit octal number if they are included in normal text.

Tables of these correspondences are found in the DESL documentation for all allowable fonts.

The capability to print characters at 3 superscript levels and 3 subscript levels also exists. If a character is preceded by either $N (default), $U, $H, $P, $D, $L, or $B then the size and position of that character, as well as remaining characters in the string in question until changed, will be affected. If a character is preceded by either $H or $P then the position only of that character, as well as remaining characters in the string in question until changed, will be affected.

The following explains the effect of each of these "$" prefixes :

An example of a text string with the above text changes is the following :

Again, the "$"-prefixed font and vertical placement codes remain in effect until changed or the string containing them ends.

The following explains the effect of other "$" prefixes :

Setting a color can be achieved by inclusion of the "$K#" string, where "#" represents a 2-DIGIT palette color number. A color number of 00 represents the default color which is black. A color setting established via this type string remains in effect until the string ends or until another "$K#" string is encountered in the same string.

Both horizontal and vertical "tab" position setting and use can be achieved by inclusion of the "$^c", $Tc, $Vc and "$Cc" strings, where "c" represents an upper-case letter, A-Z, implying tab setting 0 to 26, respectively.

The "^" character indicates a tab to set. When a tab is set both its horizontal and vertical positions are stored. A "T", "C", "V", "E", or "F" indicates a tab to use, either left-justified horizontally at the tab, centered horizontally about the tab positioned vertically at the tab, left-justified horizontally AND positioned vertically, or centered horizontally AND positioned vertically, respectively. Once set, a tab remains set and referenceable until changed.

A substring which is used to establish a tab position for a centered ("C" or "F") type tab extends to the next tab definition ("T", "C", "E", or "F") or to the end of the string, whichever is encountered first.

A examples of a text string with tabbing control are the following :

On-the-fly magnification can be achieved by inclusion of the "$M#" string, where "#" represents a magnification level index, 0 to 9, previously defined by the "maglevels" option and argument list. Any magnification thus invoked is effective until changed and is in addition to any other magnification factor which may already be in effect.

An example of a text string with magnification control is the following :

Example positioning of text ANYWHERE on the page is possible via the use of the "$*###" string, where "*" represents one of the directional symbols, <, v, >, or ^ and "###" represents a THREE-DIGIT value, in points (1 point = 1/72 inch). The directional symbols, <, v, >, and ^ move the current position in the leftward, downward, rightward, and upward directions, respectively. For example, $<023 will reset the current position 23 points to the left of where it previously was. Three digits MUST be used for the magnitude of the movement.

A legitimate symbol number can be drawn via the use of the "$S###" construct, where "###" represents a 3-digit symbol number. Attention may need to be paid to the vertical position of the symbol as it will be drawn at the current vertical position. If the symbol number implies an error-bar type symbol it can ONLY be values of 031 through 036. (See "symbol" option discussion.)

A symbol scale factor can be set via the use of the "$s###" construct, where "###" represents a 3-digit value. Here, the three digit number DIVIDED BY 100. yields the symbol magnification factor for any symbol drawn via the "$S" construct.

The width of both the underline line drawn with the "$u" and "$e##" constructs and the standard line drawn with the "$l##" and "$d###" constructs are governed by the value set via the "$w##" construct, where the "##" represents a 2-digit number of points.

Underlining can be achieved by the two-step process begun by the "$u" construct and ended by the "$e##" construct. The "$u" indicates that the current position is to be marked for use by a subsequent "$e##" which will actually cause the underlining to be drawn to the current position where the "$e##" is encountered. The 2-digit number, "##", following the "$e" is a number of points to shift below the current vertical position to move before drawing the solid underline line. The width of the solid line is governed by the "$w##" construct.

A line of any legitimate style can be drawn via the use of the "$d###" and "$l##" constructs. The "$d###" construct defines the length of the line to be drawn. The 3-digit number represented by "###" is the line length and is in points. The "$l##" construct indicates that a line is to be drawn NOW and is to be of the style "##". (See "lines" option.) The width of the solid line is governed by the "$w##" construct. Attention may need to be paid to the vertical position of the line as it will be drawn at the current vertical position..

Example : text center 3.5 .8 ?Cntrd text at y = 3.5?

[Top][Bottom][Option list]

( BRtextframe) (Command :pubplot) Details for the textframe option.

[General syntax rules for this keyword.]

Example : textframe 0 0 -2 2

[Top][Bottom][Option list]

( BRtextsleep) (Command :pubplot) Details for the textsleep option.

[General syntax rules for this keyword.]

Example : textsleep 2

[Top][Bottom][Option list]

( BRtranslate) (Command :pubplot) Details for the translate option.

[General syntax rules for this keyword.]

Example : translate 3 4

[Top][Bottom][Option list]

( BRtvspace) (Command :pubplot) Details for the tvspace option.

[General syntax rules for this keyword.]

Example : tvspace .75

[Top][Bottom][Option list]

( BRtype) (Command :pubplot) Details for the type option.

[General syntax rules for this keyword.]

Example : type polar

[Top][Bottom][Option list]

( BRvfile) (Command :pubplot) Details for the vfile option.

[General syntax rules for this keyword.]

"Voiding" in these two cases means two different things:

(1) If all conditions on the same line are TRUE and a suffix has NOT also been specified, then the entire SIF record which has satisfied the conditions is ignored (or kept if "keep" is the FIRST line of the void file). (2) If all conditions on the same line are TRUE and a suffix HAS been specified as the last item on a void file line, the SIF record is NOT ignored but, rather, the values of up to 200 SIF variables whose names end in the suffix specified are changed to the value associated with the specified or default "setvoid" value. (See the "setvoid" option.)

The structure of a valid void file must adhere to the following rules :

1. Any line beginning with an asterisk followed by at least one blank space is considered a comment and is ignored.
2. Blank lines are ignored.
3. The string "keep" may be encountered as the first non-comment line.
4. There may be an unlimited number of lines in a void file.
5. From the point issued until "nulled", abbreviations, which can be included anywhere in the void file within a line containing conditions, can be used as a "shorthand" for any part of a condition. Abbreviations are defined in lines which BEGIN with at least the first 4 characters of the word "abbreviation" and are followed, on the same line, by PAIRS of items : the first in each pair IS the abbreviation and the second in each pair is the string to be substituted for an encountered abbreviation. Up to 1750 abbreviations can be defined. If strings to be substituted for abbreviations contain one of the 2-character logical operators (see below) any blanks which end this string will be ignored; ie, "conditions" should be constructed such that at least one blank will delimit items AFTER any substitutions have been made. Abbreviations can be activated and deactivated or replaced as the void file is processed. If an abbreviation is encountered which is the same as one which has already been defined, the new one replaces the old one unless the string to be substituted for the abbreviation is the string "null". In this case the existing abbreviation is eliminated.
6. Each line which is not blank, not a comment, not "keep" and does not contain one or more abbreviations can contain up to 20 "conditions" and an optional suffix or it will be ignored.
7. A "condition" is a three-item group of items which is of the form : name/value logical name/value where, "name/value" represents either a SIF name OR a constant value, and "logical" represents one of the allowable nine 1- or 2-character logical operators : eq, =, lt. <, le, ge, gt, >, or ne. An illegally formed condition will cause the line containing it to be skipped and cause a message to be issued to this effect.
8. A suffix is any string which will be used to try to match the END of up to 200 SIF names corresponding to values in the pertinent SIF record.

Before the void file is used, by specifying "vfile" rather than "vfilen", and if the DESL session is purely interactive, the user will have the opportunity to edit the void file.

An EXAMPLE of a void file is the following :

An EXAMPLE of a "keep" file is the following :

Example : vfile void1

[Top][Bottom][Option list]

( BRvfilen) (Command :pubplot) Details for the vfilen option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRvoidval) (Command :pubplot) Details for the voidval option.

[General syntax rules for this keyword.]

During plotting, "voided" values of either the independent OR dependent variable cause the display of the corresponding PAIR of values to be essentially skipped.

Example : voidval -888

[Top][Bottom][Option list]

( BRvzero) (Command :pubplot) Details for the vzero option.

[General syntax rules for this keyword.]

Following the line weight value can be a third item specifying the line type vertical line to be drawn. The default line type is a solid line (type 1). The possible line types are as indicated in the "lines" documentation.

.	(Begin modifications on 052102) Following the line type value can be a fourth item specifying the vertical line color to be drawn. The value specified is a valid palette color number. (End modifications on 052102)

For a "polar" type plot the implication of "vzero" is dependent on the value of the xaxis or yaxis code specified. A summary of the actions taken for different values of "xaxis" and "yaxis" is as follows, where "NUM1" and "NUM2" are the two values which can follow "vzero" :

Example : vzero 1 2.5

[Top][Bottom][Option list]

( BRx) (Command :pubplot) Details for the x option.

[General syntax rules for this keyword.]

Example : x alpw alpw alpha2 alpw

[Top][Bottom][Option list]

( BRxan) (Command :pubplot) Details for the xan option.

[General syntax rules for this keyword.]

Example : xan 2

[Top][Bottom][Option list]

( BRxaninc) (Command :pubplot) Details for the xaninc option.

[General syntax rules for this keyword.]

Example : xaninc .25 -.1

[Top][Bottom][Option list]

( BRxaxdec) (Command :pubplot) Details for the xaxdec option.

[General syntax rules for this keyword.]

Example : xaxdec 4

[Top][Bottom][Option list]

( BRxaxis) (Command :pubplot) Details for the xaxis option.

[General syntax rules for this keyword.]

For polar plots, "theta" is an angle measured counterclockwise from the positive x-axis horizontal.

In general, specification of a polar plot "xaxis" code will force a conversion of the x/y data to radius/theta or theta/radius data. It IS legitimate to force this conversion at the same time a contour plot is being done.

If both "xaxis" and "yaxis" are set, either explicitly or by default, and the plot is a "polar" plot, the "xaxis" setting will take precedence.

Example : xaxis 33

[Top][Bottom][Option list]

( BRxclip) (Command :pubplot) Details for the xclip option.

[General syntax rules for this keyword.]

Example : xclip off

[Top][Bottom][Option list]

( BRxcomp) (Command :pubplot) Details for the xcomp option.

[General syntax rules for this keyword.]

Example can be accomplished by specifying a compression factor greater than 1. The value of "xcomp" is automatically implied and, if specified, overridden if BOTH "xdelta" and "xlen" are specified.

Example : xcomp .75

[Top][Bottom][Option list]

( BRxdelta) (Command :pubplot) Details for the xdelta option.

[General syntax rules for this keyword.]

If the plot is to be logarithmic on the x axis, the "xdelta" value serves only, along with the "xmin" and "xmax" options to establish the length of the x axis. A logarithmic plot cannot be drawn inverted.

Example : xdelta 2

[Top][Bottom][Option list]

( BRxexp) (Command :pubplot) Details for the xexp option.

[General syntax rules for this keyword.]

Example : xexp on

[Top][Bottom][Option list]

( BRxfactor) (Command :pubplot) Details for the xfactor option.

[General syntax rules for this keyword.]

Example : xfactor -1 1 -1

[Top][Bottom][Option list]

( BRxftic) (Command :pubplot) Details for the xftic option.

[General syntax rules for this keyword.]

Example : xftic

[Top][Bottom][Option list]

( BRxlabel) (Command :pubplot) Details for the xlabel option.

[General syntax rules for this keyword.]

Example : xlabel $41a

[Top][Bottom][Option list]

( BRxlabinc) (Command :pubplot) Details for the xlabinc option.

[General syntax rules for this keyword.]

Example : xlabinc -.2 0

[Top][Bottom][Option list]

( BRxlen) (Command :pubplot) Details for the xlen option.

[General syntax rules for this keyword.]

Example : xlen 10

[Top][Bottom][Option list]

( BRxlist) (Command :pubplot) Details for the xlist option.

[General syntax rules for this keyword.]

Up to 20 sets of variables can be specified via the value of the "curve-id" set number.

.	(Begin modifications on 052102) All specified "xlist" sets combined must have no more than 50000 elements. (End modifications on 052102)

There must be equal numbers of "xlist" and "ylist" members for each respective curve-id specified.

Specification of "xlist" before either "x" or "y" implies that a "pressure" type plot is to be done; ie, one plot is to be produced for each SIF data record for each file. (See the "notify" option.)

Each plot will contain 1 curve per "set" of "xlist" and "ylist" variables specified from one file at a time. The list of x-axis names/values which follow the curve-id number can include one or more of four special forms of implicit expansion methods : "curve", "thru", "at", and "to/by". If "curve" is used, a "curvefile" MUST be active. (See "curvefile" option.)

[Top][Bottom][Option list]

( BRxloglab) (Command :pubplot) Details for the xloglab option.

[General syntax rules for this keyword.]

The tens digit corresponds to (1) above. The values it can legitimately be set to and their meanings are summarized below :

The ones digit corresponds to (2) above. The values it can legitimately be set to and their meanings are summarized below :

Normally the powers-of-10 labeling is drawn "outside" of any intermediate labeling. If no intermediate labeling is to be done the powers-of-10 labeling moves closer to the x axis. The default logarithmic x-axis labeling value is 14.

Example : xloglab 21

[Top][Bottom][Option list]

( BRxmax) (Command :pubplot) Details for the xmax option.

[General syntax rules for this keyword.]

Example : xmax 100

[Top][Bottom][Option list]

( BRxmin) (Command :pubplot) Details for the xmin option.

[General syntax rules for this keyword.]

Example : xmin -10

[Top][Bottom][Option list]

( BRxoff) (Command :pubplot) Details for the xoff option.

[General syntax rules for this keyword.]

Example : xoff 5

[Top][Bottom][Option list]

( BRxoffset) (Command :pubplot) Details for the xoffset option.

[General syntax rules for this keyword.]

Example : xoffset -.5 0

[Top][Bottom][Option list]

( BRxtic) (Command :pubplot) Details for the xtic option.

[General syntax rules for this keyword.]

The default number of minor tic increments per major tic mark is 2. If the x-axis is logarithmic, the effective value of xtic is halved above 6.0 in each cycle drawn. If the plot is of type "polar", the "xtic" argument will establish the number of radial or concentric fine grid lines to draw. Which it determines is a function of the "xaxis" or "yaxis" code specified.

If the plot is a surface plot the "xtic" argument serves to indicate the desired resolution of the surface in the X direction. Higher "xtic" values result in more surface facets but also greater time required to compute the resultant surface to draw. A combined X and Y maximum for number of surface facets is 15000.

Example : xtic 4

[Top][Bottom][Option list]

( BRxtol) (Command :pubplot) Details for the xtol option.

[General syntax rules for this keyword.]

Example : xtol .05

[Top][Bottom][Option list]

( BRxtrapts) (Command :pubplot) Details for the xtrapts option.

[General syntax rules for this keyword.]

Example : xtrapts 8

[Top][Bottom][Option list]

( BRy) (Command :pubplot) Details for the y option.

[General syntax rules for this keyword.]

Example : y cl cl cl2 cl

[Top][Bottom][Option list]

( BRyan) (Command :pubplot) Details for the yan option.

[General syntax rules for this keyword.]

Example : yan 2

[Top][Bottom][Option list]

( BRyaninc) (Command :pubplot) Details for the yaninc option.

[General syntax rules for this keyword.]

Example : yaninc .25 -.1

[Top][Bottom][Option list]

( BRyaxdec) (Command :pubplot) Details for the yaxdec option.

[General syntax rules for this keyword.]

Example : yaxdec 4

[Top][Bottom][Option list]

( BRyaxis) (Command :pubplot) Details for the yaxis option.

[General syntax rules for this keyword.]

For polar plots, "theta" is an angle measured counterclockwise from the positive x-axis horizontal.

In general, specification of a polar plot "yaxis" code will force a conversion of the x/y data to radius/theta or theta/radius data. It IS legitimate to force this conversion at the same time a contour plot is being done.

Example : yaxis 33

[Top][Bottom][Option list]

( BRyclip) (Command :pubplot) Details for the yclip option.

[General syntax rules for this keyword.]

Example : yclip off

[Top][Bottom][Option list]

( BRycomp) (Command :pubplot) Details for the ycomp option.

[General syntax rules for this keyword.]

Example can be accomplished by specifying a compression factor greater than 1. The value of "ycomp" is automatically implied and, if specified, overridden if BOTH "ydelta" and "ylen" are specified.

Example : ycomp .75

[Top][Bottom][Option list]

( BRydelta) (Command :pubplot) Details for the ydelta option.

[General syntax rules for this keyword.]

If the plot is to be logarithmic on the y axis, the "ydelta" value serves only, along with the "ymin" and "ymax" options to establish the length of the y axis. A logarithmic plot cannot be drawn inverted.

Example : ydelta 2

[Top][Bottom][Option list]

( BRyexp) (Command :pubplot) Details for the yexp option.

[General syntax rules for this keyword.]

Example : yexp on

[Top][Bottom][Option list]

( BRyfactor) (Command :pubplot) Details for the yfactor option.

[General syntax rules for this keyword.]

Example : yfactor -1 1 -1

[Top][Bottom][Option list]

( BRyftic) (Command :pubplot) Details for the yftic option.

[General syntax rules for this keyword.]

Example : yftic

[Top][Bottom][Option list]

( BRylabel) (Command :pubplot) Details for the ylabel option.

[General syntax rules for this keyword.]

Example : ylabel C$DL

[Top][Bottom][Option list]

( BRylabinc) (Command :pubplot) Details for the ylabinc option.

[General syntax rules for this keyword.]

Example : ylabinc 0 -.5

[Top][Bottom][Option list]

( BRylaboff) (Command :pubplot) Details for the ylaboff option.

[General syntax rules for this keyword.]

Example : ylaboff .5

[Top][Bottom][Option list]

( BRylabrot) (Command :pubplot) Details for the ylabrot option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRylen) (Command :pubplot) Details for the ylen option.

[General syntax rules for this keyword.]

Example : ylen 5

[Top][Bottom][Option list]

( BRylist) (Command :pubplot) Details for the ylist option.

[General syntax rules for this keyword.]

.	(Begin modifications on 052102) All specified "ylist" sets combined must have no more than 50000 elements. (End modifications on 052102)

There must be equal numbers of "xlist" and "ylist" members for each respective curve-id specified.

Specification of "ylist" before either "x" or "y" implies that a "pressure" type plot is to be done; ie, one plot is to be produced for each SIF data record for each file. (See the "notify" option.)

Each plot will contain 1 curve per "set" of "xlist" and "ylist" variables specified from one file at a time. The list of y-axis names/values which follow the curve-id number can include one or more of four special forms of implicit expansion methods : "curve", "thru", "at", and "to/by". If "curve" is used, a "curvefile" MUST be active. (See "curvefile" option.)

[Top][Bottom][Option list]

( BRyloglab) (Command :pubplot) Details for the yloglab option.

[General syntax rules for this keyword.]

The tens digit corresponds to (1) above. The values it can legitimately be set to and their meanings are summarized below :

The ones digit corresponds to (2) above. The values it can legitimately be set to and their meanings are summarized below :

Normally the powers-of-10 labeling is drawn "outside" of any intermediate labeling. If no intermediate labeling is to be done the powers-of-10 labeling moves closer to the y axis. The default logarithmic y-axis labeling value is 14.

Example : yloglab 21

[Top][Bottom][Option list]

( BRymax) (Command :pubplot) Details for the ymax option.

[General syntax rules for this keyword.]

Example : ymax 25

[Top][Bottom][Option list]

( BRymin) (Command :pubplot) Details for the ymin option.

[General syntax rules for this keyword.]

Example : ymin 0

[Top][Bottom][Option list]

( BRyoff) (Command :pubplot) Details for the yoff option.

[General syntax rules for this keyword.]

Example : yoff 5

[Top][Bottom][Option list]

( BRyoffset) (Command :pubplot) Details for the yoffset option.

[General syntax rules for this keyword.]

Example : yoffset -.5 0

[Top][Bottom][Option list]

( BRytic) (Command :pubplot) Details for the ytic option.

[General syntax rules for this keyword.]

If the y-axis is logarithmic, the effective value of ytic is halved above 6.0 in each cycle drawn. If the plot is of type "polar", the "ytic" argument will establish the number of radial or concentric fine grid lines to draw. Which it determines is a function of the "xaxis" or "yaxis" code specified.

If the plot is a surface plot the "ytic" argument serves to indicate the desired resolution of the surface in the Y direction. Higher "ytic" values result in more surface facets but also greater time required to compute the resultant surface to draw. A combined X and Y maximum for number of surface facets is 15000.

Example : ytic 3

[Top][Bottom][Option list]

( BRytol) (Command :pubplot) Details for the ytol option.

[General syntax rules for this keyword.]

Example : ytol -.5

[Top][Bottom][Option list]

( BRz) (Command :pubplot) Details for the z option.

[General syntax rules for this keyword.]

Example : z cl cl clx

[Top][Bottom][Option list]

( BRzaxis) (Command :pubplot) Details for the zaxis option.

[General syntax rules for this keyword.]

Example : zaxis 1

[Top][Bottom][Option list]

( BRzcomp) (Command :pubplot) Details for the zcomp option.

[General syntax rules for this keyword.]

Example can be accomplished by specifying a compression factor greater than 1. The value of "zcomp" is automatically implied and, if specified, overridden if BOTH "zdelta" and "zlen" are specified.

Example : zcomp .75

[Top][Bottom][Option list]

( BRzdelta) (Command :pubplot) Details for the zdelta option.

[General syntax rules for this keyword.]

Example : zdelta 4

[Top][Bottom][Option list]

( BRzlen) (Command :pubplot) Details for the zlen option.

[General syntax rules for this keyword.]

Example : zlen 10

[Top][Bottom][Option list]

( BRzlist) (Command :pubplot) Details for the zlist option.

[General syntax rules for this keyword.]

[Top][Bottom][Option list]

( BRzmax) (Command :pubplot) Details for the zmax option.

[General syntax rules for this keyword.]

Example : zmax 12

[Top][Bottom][Option list]

( BRzmin) (Command :pubplot) Details for the zmin option.

[General syntax rules for this keyword.]

Example : zmin 12

[Top][Bottom][Option list]

DESL Manager at ViGYAN, Inc.

30 Research Drive
Hampton, VA 23666
Voice: (757) 865-1400
Toll Free: (800) 288-3998
FAX: (757) 865-8177

© 1998 ViGYAN, Inc.