DESL


DESL Home | Website Outline | Commands | Examples | Download | Contacts

A Gallery of DESL "pubplot" examples.


The attempt is made, in general, in the table below to present examples of the use of the DESL pubplot (abbreviation is "pp") command which include, progressively, more and more of the available pubplot options.

[Jump down to the table of examples]

Whereas for all other DESL commands the accumulation of input - options and arguments - is examined and acted upon at the encounter of the go option, regardless of the order of the components of the input itself (assuming a component is either an option alone or an option and its argument(s)), the pubplot command's input IS order dependent in a sense. You will notice, as the examples below grow more complex, that multiple plots can be produced per page. At the point in the input when the next plot is to be produced, the input gathered thus far is what is to be used to produce the plot. So, with pubplot, unlike the other DESL commands, encountering go signals the end of all input, but the actions implied before the end of the input are dependent on the order of the input specified. More will be said about this situation as pertinent examples are presented.

In the table below the Case No. can be clicked to see (and download) the DESL commented text input which produced the plot represented by the thumbnail proxy in column 2.

The thumbnail proxy in column 2 can be clicked to see a .jpg representation of the PostScript file which was produced by DESL using the input referred to in column 1.

The thumbnail proxy plots have blue sections representing the "area" covered by the plot proper - i.e., the plot excluding any annotation and text. The area which represents a key is colored red. The area(s) which represent text and/or labels are colored green . Curve representations (more than one implying two or more curves) are shown as yellow circles or circles/squares.

(See the anatomy of a plot to see a labeled typical DESL plot.)

In the examples below the files "r10", "r11" and "r12" are SIF files. ASCII (ffsif) versions of r10 , r11 and r12 can be used to duplicate the results in the table below.

To convert these ffsif files into SIF files for use in the duplication of the results shown below, do the following :

translate
  files r10.ffs r11.ffs r12.ffs allto sif
  allfrom ffsif newfiles r10 r11 r12 go



Case No. Thumbnail
Comments
1 This is the least verbose possible set of DESL pubplot input.

A lot of what happens here is due to the implications of the "quick" option. "quick" causes the autoscaling on both axes, the setting of the plot labels, the name of the PostScript file, etc.

The default axes lengths of 10 inches has been used. Without explicit or implicit axis length definitions all pubplot plots will be made with these axes lengths.

2 This is the simplest possible set of DESL pubplot input WITHOUT using the "quick" option while getting the minimum possible output. No axes labels, default plot sizing. No text. Plot is not offset from the paper origin (lower,left corner) and therefore no axis annotation is visible. Plot is the default 10 inches by 10 inches.
3 Like case 2 but with three additional features :
  • explicit offset of the plot from the page origin via the "translate" option
  • use of the "scale" option to scale the entire plot to 50% of its default size (scaling shrinks/expands from page origin inward/outward)
  • explicit naming of the PostScript file being produced via the "plotfile" option.

Here, as in all DESL plotting, the plot is scaled AFTER the origin translation occurs. Therefore, the visual effect of the finished product is such that the offset appears to have only been shifted rightward and upward by 1 inch each.

The default is to use the actual maximum and minimum x and y axis variable values when determining the scaling to apply to the plot. This feature is responsible for the axes having the ratty tic labels. NEAT autoscaling is NOT the default. But at least now the information on the page origin side of the axes is visible. There is NO axis labeling by default. Plot is the default 10 inches by 10 inches, reduced in scale by 50%.

4 Like case 3 but with two additional features :
  • autoscaling on the X axis
  • addition of text at the top of the page

The autoscaling of the X axis has changed the plot from case 3 to one which now has neater tic increments and labeling. The Y axis has not been affected. If the option autoy or auto would have been used, the Y axis also would have been autoscaled.

An example of the use of the text option is also presented. In this case the X and Y positioning arguments are given in two of their symbolic forms : "center" and "top", not indicating, as could have been specified, explicit X and Y positions relative to the plot origin position. The "center" argument implies the approximate center of the page regardless of the position of the plot also on the page.

5 Like case 4 but with four additional features :
  • autoscaling on BOTH axes
  • addition of automatically imported "run" number into the text at the top of the page
  • addition of line type specification
  • X- and Y-axis labeling added

Both the X and Y axes are autoscaled now. which now has neater tic increments and labeling. The Y axis has not been affected. If the option autoy or auto would have been used, the Y axis also would have been autoscaled.

An example of the use of the text option is also presented. In this case the X and Y positioning arguments are given in two of their symbolic forms : "center" and "top", not indicating, as could have been specified, explicit X and Y positions relative to the plot origin position. The "center" argument implies the approximate center of the page regardless of the position of the plot also on the page.

You will notice that when the line is drawn between the symbols is becomes apparent that the order of drawing the symbols was not monotonically increasing in "cl". The default situation is not to sort data before plotting.

6 Like case 5 but with several additional features :
  • addition of two more curves to plot
  • addition of automatically imported "mach" number into the text at the top of the page
  • assignment of symbol and line types to all three curves
  • sorting of the data
  • coarse grid added
  • key added

Two more files have been named implying two more curves to be plotted. Since only one x and only one y axis variable name has been specified, the implication is that a list whose length is the same as the files list is to be produced by replicating the last name specified in each list.

In general, if the explicit curves option is not mentioned, the number of curves is set by and equal to the number of files specified. There is an implicit 1:1 correspondence between members of an expressed or implied files list of arguments and those of the x, y, lines and symbols.

The coarse grid is drawn at the major tic marks every (unscaled) inch.

The value of "mach" in the text string at the top of the page should be an average value for all of the data plotted and should be very close to the same as the average of the three values of "mach" shown in the key, since the values shown in a key are, themselves, averages of the pertinent parameter for the curve in question. The key style is that of an overlaid rectangle filled with the appropriate information. The key code, in this case 301, defines this key property. The key upper left corner is positioned at 8.2 (scaled) inches above and to the right of the plot origin.


DESL Home | Website Outline | Commands | Examples | Download | Contacts


Contact the DESL manager

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

© 1999 ViGYAN, Inc.