9 Plot Setup Menu

Plots produced within the UDFAnalysis framework are output onto a single canvas called the parent plotting window. Most of the characteristics of this window, including its size, the size of any margins along the edge, as well as many generic plot specific properties are established in the Plot Setup menu. The menu is invoked from the Main Menu. Placement of the plots in the window is done in the Plot Layout Menu while the contents of each plot are defined in the Plot Definitions menu.

Clicking Plot Setup in the main menu brings up the menu shown in Figure 62.


PIC

Figure 62: Unpopulated Plot Setup Menu


Default values are supplied for all options except for the main window label. The options are described in the sections below.

9.1 Device

The device driver to use to render the graphics. Unless you have VTK installed the only option currently supported is Tk Canvas. If you have VTK installed then you can also select VTK Canvas. The latter has extensions which allow for fully rotatable and zoomable 3-D plots and is required for the use of certain plot types. Unless there are 3D plots being output Tk Canvas is the better and more robust choice of the two.

9.2 Window

All plots are output in a single parent window. Arrangement of the plots within the window is described in the Plot Layout section. The following options describe some of the basic options which control the characteristics of the parent window.

9.2.1 Width

The width of the parent graphics window in pixels.

9.2.2 Height

The height of the parent graphics window in pixels.

9.2.3 Top Gap

The amount of white space to leave along the top of the parent plot window. The units are in terms of a 12 point character. The option is used to add extra space for text. If you include an overall plot label you should increase this from its default value of 3 to 6 or 7.

9.2.4 Bot Gap

The amount of white space to leave along the bottom of the parent plot window. The units are in terms of a 12 point character. This is used to add extra space for text other than the nominal plot axis numerical and text labeling.

9.2.5 Left Gap

The amount of white space to leave along the left hand side of the parent plot window. The units are in terms of a 12 point character. This is used to add extra space for text other than the nominal plot axis numerical and text labeling.

9.2.6 Right Gap

The amount of white space to leave along the right hand side of the parent plot window. The units are in terms of a 12 point character. This is used to add extra space for text other than the nominal plot axis numerical and text labeling.

9.3 Label

An optional overall label can be placed at the top center of the parent plot window. No label is output if the label field is left blank. When outputting a top label the top gap should be increased to about 6 to allow room for it.

9.3.1 Label

The label output at the top of the parent plot window. If the label is blank then no label is output.

9.3.2 Color

The color of the top label. This is set through the Color Picker Menu. Click the color to bring up the menu.

9.3.3 Size

The size of the top label in points. Default is 12 point.

9.3.4 Bold

This is option to ON if the label should be output in bold text, OFF otherwise.

9.4 Color

These options define the plot wide color selections.

9.4.1 File

This is a set of defined color tables. Plots which convert value to color do so according to the selected color table.

9.4.2 Plot Bkgnd

Set the background color of the parent plot window. This is set through the Color Picker Menu. Click the color to bring up the menu. Note that if an object is output in the background color the plotting code will automatically switch the color to its complement. As an example if the background is white then any white text will be output in black

9.5 Grid

These options define the characteristics of a background or foreground grid that can be added to any of the defined plots. Grid lines are drawn in conjunction with major tick marks which are drawn along the plot axes. Grids are turned off and on for a given plot in the Plot Layout Menu.

9.5.1 Lines

A set of menu options which establish which grid lines are to be drawn. Options are X, Y, or XY to include only the X grid lines, only the Y grid lines, or both the X and the Y grid lines respectively.

9.5.2 Color

The color of the grid lines. This is set through the Color Picker Menu. Click the color to bring up the menu.

9.5.3 Line Style

The line style to use when outputting the grid. The default setting is SPDASH1. The options for the most part are self explanatory. SOLID produced solid lines. The DASH options produce dashed lines with different dash widths. The SPDASH options produce DASH lines but add a larger amount of space between the dashes. The DASHDOT options produce lines with alternating dashes and dots (smaller dashes). The DASH2DOT options produce lines with dashes separated by 2 dots. The DASHSPDOT options produce DASHDOT lines but with larger spaces between the dashes and dots.

9.5.4 Add

This is a toggle option which specifies when to grid the plot. The options are BEFORE and AFTER. Use BEFORE to output the grid prior to plotting of any data and AFTER to output the grid after all data have been plotted.

9.6 Offsets

These options allow for additional shifts in the numerical labeling around plots from the default.

9.6.1 X Ano

Adds an additional offset of the X axis numerical annotation from the plot axis. The value has units of characters. This applies to all defined plots.

9.6.2 Y Ano

Adds an additional offset of the Y axis numerical annotation from the plot axis. The value has units of characters. This applies to all defined plots.

9.7 3D Plots

These options set global options to use when outputting 3D plots with with the VTK device driver.

9.7.1 Format

This option specifies whether spectrogram like plots should be plotted either as FLAT plots (2D representation) or ELEVATED plots (3D).

9.7.2 Scale

This option applies only if the Format option is set to ELEVATE and defines the scaling to use when computing out of plane elevation. A larger value exaggerates the elevations.

9.7.3 Decimate

This option applies only if the Format option is set to ELEVATE. The option allows for plots to be decimated in the X direction prior to being output. Elevated plots are generated from a 2D data grid which often are defined in the X direction to have one grid cell per plot pixel. This is often too dense to produce a good 3D raised representation of the data. Decimating the grid prior to plotting in these cases improves the plot. Set decimate to 1 for no decimation, 2 to use every other X grid cell, 3, to use every second X grid cell, and so on.