JWAVE_BAR3D Function

JWAVE User Guide > JWAVE Convenience Wrappers > JWAVE_BAR3D Function

This JWAVE wrapper function provides a convenient interface to the PV‑WAVE BAR3D procedure. This function always returns a Viewable object (a 3D bar chart) to the JWAVE client. Its parameters let you control many aspects of a plot’s appearance.

Parameters

This section lists the parameters that the JWAVE_BAR3D wrapper can retrieve, unpack, and use to produce a 3D bar chart. These parameters correspond to the parameters and keywords of the PV‑WAVE BAR3D procedure. You must set these parameters in the client application with the JWaveView.setParam method.

Z—(required) A 2D numeric array containing elevation values.

Keyword Parameters

This section lists the keyword parameters that can be retrieved and unpacked in this wrapper function. For detailed information on these keywords, refer to Keyword and Named Color Parameters.

Ax	Ticklen	[XYZ]Style
Az	Title	[XYZ]Ticklen
Charsize	[XYZ]Charsize	[XYZ]Tickname
Charthick	[XYZ]Gridstyle	[XYZ]Ticks
Gridstyle	[XYZ]Margin	[XYZ]Title
Position	[XYZ]Minor	ZAxis
Subtitle	[XYZ]Range

Named Color Parameters

These parameters must be set by the JWAVE client Java application with the JWaveView.setNamedColor method.

Background

Color

Named ColorSet Parameters

These parameters must be set by the JWAVE client Java application with the JWaveView.setNamedColorSet method.

ColumnColors

RowColors

Returns

This wrapper returns a Viewable object (a 3D bar chart) to the JWAVE Java client application.

Example

In the client Java application, the setParam method is used to set the parameters to be passed to this JWAVE wrapper on the server. JWAVE_BAR3D unpacks the parameters and builds a PV‑WAVE BAR3D command to produce a 3D bar chart.

These lines of Java code establish a connection to the server with the JWAVE wrapper JWAVE_BAR3D. Then, a data parameter and two configuration parameters are set.

JWaveView myJWaveView = new JWaveView(connection, ”JWAVE_BAR3D”)

myJWaveView.JWaveView.setParam(”Z”, threed);

myJWaveView.JWaveView.setParam(”CHARSIZE”, 2);

myJWaveView.JWaveView.setParam(”TITLE”, ”Snow Depth”);

myJWaveView.setNamedColor(”BACKGROUND”, java.awt.Color.blue);