Starts a VDA Tool used for plotting a histogram.

var — The name of a 1D, 2D, or 3D variable to plot or an equivalent expression.

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.

The Parent keyword is used to connect WzHistogram 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:

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.

var = DIST(40)

WzHistogram, var, XSize=400, YSize=400

HISTOGRAM, PLOT_HISTOGRAM