WzBar Procedure

Starts a VDA Tool used for plotting a bar chart. This VDA Tool creates simple, stacked, and grouped bar charts.

Usage

WzBar, var 

Input Parameters

var — The name of a 1D, 2D, or 3D variable, with a maximum of 400 elements. See the Discussion section for information on the effects of these different dimensioned variables.

Keywords

NoBlock — If specified, the event loop (WwLoop) that is started by the VDA Tool will use the given value. By default a value of 1 (non-blocking loop) will be used. However, it may be necessary in certain circumstances to force a non-blocking loop by specifying NoBlock = 2. (See WwLoop in the PV‑WAVE Application Developer’s Guide for more information.)

Parent — The widget ID of the parent widget.

Position — Specifies, in pixels, the x and y (horizontal and vertical) coordinates for the starting location of the upper-left corner of the VDA Tool window.

Restore — A data structure previously saved in the Tools Manager with the TmSaveTools function. This keyword is reserved for internal use; it is not to be used at the command line (see Discussion).

Template — A string containing the name of a VDA Tool template file.

XSize — Specifies, in pixels, the width of the drawing area.

YSize — Specifies, in pixels, the height of the drawing area.

Discussion

Depending on the type of array assigned to var, one of the following happens:

If var is a 1D array, a simple bar chart is plotted.

If var is a 2D array, the bar chart can either consist of grouped bars or stacked bars. For grouped bars (the default) the first dimension is construed as a group and the second dimension as a bar value. If the Stack option is selected in the VDA Tool, then the first dimension is construed as a stack and the second dimension as a bar value.

If var is a 3D array, the bar chart consists of grouped, stacked bars. The first dimension is construed as a group, the second as the stack, and the third as a bar in a stack in a group.

The Parent keyword is used to connect WzBar to another application, such as the Navigator.

The Restore keyword is used specifically by the TM_RESTORE method. For information on the TM_RESTORE method, refer to the source code for WzHistogram in:

<wavedir>/lib/vdatools/wzbar.pro 
<wavedir>\lib\vdatools\wzbar.pro 

Where <wavedir> is the main PV‑WAVE directory.

A template is a VDA Tool without any data associated with it. The template contains all of the modifications to the VDA Tool — colors, axes, graphical elements — that were set when the template file was saved. Template files are saved with the Save Template As command from the File menu on the VDA Tool.

Note:

For information on how to use this VDA Tool, use online Help. Select the
On Window command from the VDA Tool Help menu to bring up Help on this VDA Tool.

Example

var = INDGEN(5)
WzBar, var, XSize=400, YSize=400 

See Also

BAR, BAR2D, WzBar3D, WzPie