Graphics and Plotting

Coordinate Conversion Routines

CONVERT_BASE Function

Converts a base-10 integer to an arbitrary base representation.

CONVERT_COORD Function

Converts coordinates from one coordinate system to another.

CONV_FROM_RECT Function

Converts rectangular coordinates (points) to polar, cylindrical, or spherical coordinates.

CONV_TO_RECT Function

Converts polar, cylindrical, or spherical coordinates to rectangular coordinates (points).

POLY_DEV Function

Returns a list of 3D points converted from normal coordinates to device coordinates.

POLY_NORM Function

Returns a list of 3D points converted from data coordinates to normal coordinates.

POLY_TRANS Function

Returns a list of 3D points transformed by a 4-by-4 transformation matrix.

General Graphics Routines

CPROD Function

Returns the Cartesian product of some arrays.

CURSOR Procedure

Reads the position of the interactive graphics cursor from the current graphics device.

DERIVN Function

Differentiates a function represented by an array.

DEVICE Procedure

Provides device-dependent control over the current graphics device (as specified by the SET_PLOT procedure).

EMPTY Procedure

Causes all buffered output for the current graphics device to be written.

ERASE Procedure

Erases the display surface of the currently active window.

IMAGE_CONT Procedure

Standard Library procedure that overlays a contour plot onto an image display of the same array.

MOVIE Procedure

Standard Library procedure that shows a cyclic sequence of images stored in a three-dimensional array.

PLOT Procedures

Plots vectors or points on the current graphics device in either two or three dimensions.

PROFILE Function

Standard Library function that extracts a profile from an image.

PROFILES Procedure

Standard Library procedure that lets you interactively draw row or column profiles of the image displayed in the current window. The profiles are displayed in a new window, which is deleted when you exit the procedure.

RDPIX Procedure

Standard Library procedure that displays the X, Y, and pixel values at the location of the cursor in the image displayed in the currently active window.

SCALE3D Procedure

Standard Library procedure that scales a three-dimensional unit cube into the viewing area.

SET_PLOT Procedure

Specifies the device type used by PV‑WAVE  graphics procedures.

SHOW3 Procedure

Standard Library procedure that displays a two-dimensional array as a combination contour, surface, and image plot. The resulting display shows a surface with an image underneath and a contour overhead.

T3D Procedure

Standard Library procedure that accumulates one or more sequences of translation, scaling, rotation, perspective, or oblique transformations and stores the result in the system variable !P.T.

THREED Procedure

Standard Library procedure that plots a two-dimensional array as a pseudo three-dimensional plot on the currently selected graphics device.

TVCRS Procedure

Manipulates the cursor within a displayed image, allowing it to be enabled and disabled, as well as positioned.

XYOUTS Procedure

Draws text on the currently selected graphics device starting at the designated data coordinate.

ZOOM Procedure

Expands and displays part of an image (or graphic plot) from the current window in a second window.

Gridding Routines

FAST_GRID2 Function

Returns a gridded, 1D array containing Y values, given random X,Y coordinates (this function works best with dense data points).

FAST_GRID3 Function

Returns a gridded, 2D array containing Z values, given random X, Y, Z coordinates (this function works best with dense data points).

FAST_GRID4 Function

Returns a gridded, 3D array containing intensity values, given random 4D coordinates (this function works best with dense data points).

GRID_2D Function

Returns a gridded, 1D array containing Y values, given random X,Y coordinates (this function works best with sparse data points).

GRID_3D Function

Returns a gridded, 2D array containing Z values, given random X, Y, Z coordinates (this function works best with sparse data points).

GRID_4D Function

Returns a gridded, 3D array containing intensity values, given random 4D coordinates (this function works best with sparse data points).

GRIDN Function

Grids n dimensional data.

GRID_SPHERE Function

Returns a gridded, 2D array containing radii, given random longitude, latitude, and radius values.

INTERPOLATE Function

Interpolates scattered data at scattered locations.

Mapping Routines

MAP Procedure

Plots a map.

MAP_CONTOUR Procedure

Draws a contour plot from longitude/latitude data stored in a 2D array.

MAP_LAND Procedure

For each map pixel, identify longitude, latitude, and cover type.

MAP_PLOTS Procedure

Plots vectors or points (specified as longitude/latitude data) on the current map projection.

MAP_POLYFILL Procedure

Fills the interior of a region of the display enclosed by an arbitrary 2D polygon.

MAP_REVERSE Procedure

Converts output from routines like CURSOR and WtPointer from device, normal, or data coordinates to longitude and latitude coordinates.

MAP_VELOVECT Procedure

Draws a two-dimensional velocity field plot on a map, with each directed arrow indicating the magnitude and direction of the field.

MAP_XYOUTS Procedure

Draws text on the currently selected graphics device starting at the designated map coordinate.

USGS_NAMES Function

Queries a database containing names, FIPS codes, and longitude/latitude values for cities and towns in the United States. Plots a map.

Plotting Routines

AXIS Procedure

Draws an axis of the specified type and scale at a given position.

BAR Procedure

Plots a 2D bar graph that can include stacked and grouped bars, as well as various color and fill pattern options.

BAR2D Procedure

Creates a two-dimensional bar plot.

BAR3D Procedure

Creates a three-dimensional bar plot.

BOXPLOT Procedure

Creates a standard box plot.

CONTOUR Procedure

Draws a contour plot from data stored in a rectangular array.

CONTOUR2 Procedure

Draws a contour plot from data stored in a rectangular array.

CONTOURFILL Procedure

Standard Library procedure that fills both open and closed contours with specified colors or patterns.

CONTOURFS Procedure

Provides a wrapper which calls CONTOUR and CONTOURFILL that accepts all CONTOUR and CONTOURFILL keywords with the exceptions of Color_Index.

CORRELOGRAM Procedure

Plots a correlogram using either autocorrelation function (ACF) values or partial autocorrelation function (PACF) values.

CURSOR Procedure

Reads the position of the interactive graphics cursor from the current graphics device.

CUSUM Procedure

Creates a two-sided, V-mask Cumulative Sum chart of a process mean.

ERRPLOT Procedure

Standard Library procedure that overplots error bars over a previously-drawn plot.

GRID Function

Standard Library function that generates a uniform grid from irregularly-spaced data.

IMAGE_CONT Procedure

Standard Library procedure that overlays a contour plot onto an image display of the same array.

ISOSURF Procedure

Standard Library procedure that computes, and optionally displays, an isosurface of the specified 3D data.

MACHART ProcedureMACHART Procedure

Creates a standard or Exponentially Weighted Moving Average (EWMA) chart of a process mean.

OPLOT Procedure

Plots vector data over a previously drawn plot.

OPLOTERR Procedure

Standard Library procedure that overplots symmetrical error bars on any plot already output to the display device.

PARETO Procedure

Creates a PARETO chart with accompanying legend, cumulative percentages and annotations.

PIE Procedure

Displays data as a pie chart.

PIE_CHART Procedure

Creates a pie chart with colors, text labels, exploded slices and/or shadows.

PLOT Procedures

PLOT produces a simple XY plot.

PLOT_IO produces an XY plot with logarithmic scaling on the Y axis

PLOT_OI produces an XY plot with logarithmic scaling on the X axis.

PLOT_OO produces an XY plot with logarithmic scaling on both the X and Y axes.

PLOT_HISTOGRAM Procedure

Plots a histogram.

PLOTERR Procedure

Standard Library procedure that plots data points with accompanying symmetrical error bars.

PLOT_FIELD Procedure

Standard Library procedure that plots a two-dimensional velocity field.

PLOTS Procedure

Plots vectors or points on the current graphics device in either two or three dimensions.

PLOT_WINDROSE Procedure

Creates a Wind Rose plot.

POLYFILL Procedure

Fills the interior of a region of the display enclosed by an arbitrary two- or three-dimensional polygon.

POLYSHADE Function

Constructs a shaded surface representation of one or more solids described by a set of polygons.

PROFILE Function

Standard Library function that extracts a profile from an image.

PROFILE Function

Standard Library procedure that lets you interactively draw row or column profiles of the image displayed in the current window. The profiles are displayed in a new window, which is deleted when you exit the procedure.

SCALE3D Procedure

Standard Library procedure that scales a three-dimensional unit cube into the viewing area.

SET_SHADING Procedure

Modifies the light source shading parameters affecting the output of SHADE_SURF and POLYSHADE.

SHADE_SURF Procedure

Standard Library procedure that creates a shaded surface representation of a regular or nearly regular gridded surface, with shading from either a light source model or from a specified array of intensities.

SHADE_SURF_IRR Procedure

Creates a shaded-surface representation of a semiregularly gridded surface, with shading from either a light source model or from a specified array of intensities.

SHOW3 Procedure

Standard Library procedure that displays a two-dimensional array as a combination contour, surface, and image plot. The resulting display shows a surface with an image underneath and a contour overhead.

SURFACE Procedure

Draws the surface of a two-dimensional array projected into two dimensions, with hidden lines removed

T3D Procedure

Standard Library procedure that accumulates one or more sequences of translation, scaling, rotation, perspective, or oblique transformations and stores the result in the system variable !P.T.

THREED Procedure

Standard Library procedure that plots a two-dimensional array as a pseudo three-dimensional plot on the currently selected graphics device.

USERSYM Procedure

Lets you create a custom symbol for marking plotted points.

VEL Procedure

Standard Library procedure that draws a graph of a velocity field with arrows pointing in the direction of the field. The length of an arrow is proportional to the strength of the field at that point.

VELOVECT Procedure

Standard Library procedure that draws a two-dimensional velocity field plot, with each directed arrow indicating the magnitude and direction of the field.

XBAR Procedure

Creates an X Bar chart.

XRCHART Procedure

Creates an XR chart with an X Bar chart on top and an R chart beneath it.

XSCHART Procedure

Creates an XS chart with an X Bar chart on top and an S chart beneath it.

View Setup Routines

CENTER_VIEW Procedure

Sets system viewing parameters to display data in the center of the current window (a convenient way to set up a 3D view).

SET_VIEW3D Procedure, viewpoint, viewvector, perspective, izoom, viewup, viewcenter, winx, winy, xr, yr, zr

Generates a 3D view, given a view position and a view direction.

T3D Procedure

Standard Library procedure that accumulates one or more sequences of translation, scaling, rotation, perspective, or oblique transformation and stores the results in the system variable !P.T.

VIEWER Procedure

Lets users interactively define a 3D view, a slicing plane, and multiple cut-away volumes for volume rendering. (Creates a View Control and a View Orientation window in which to make these definitions.)

Window Routines

WCopy Function (Windows)

(Microsoft Windows Only) Copies the contents of a graphics window onto the Clipboard.

WDELETE Procedure

Deletes the specified window.

Window Procedure

Creates a window for the display of graphics or text.

WMenu Function (UNIX)

Displays a menu inside the current window whose choices are given by the elements of a string array and which returns the index of the user’s response.

WPaste Function (Windows)

(Microsoft Windows Only) Pastes the contents of the Clipboard into a graphics window.

WPrint Procedure (Windows)

(Microsoft Windows Only) Prints the contents of a specified window.

WRead_DIB Function (Windows)

(Microsoft Windows Only) Loads a Device Independent Bitmap (DIB) from a file into a graphics window.

WRead_META Function (Windows)

(Microsoft Windows Only) Loads a Windows metafile (WMF) into a graphics window.

WSet Procedure

Used to select the current window to be used by the graphics and imaging routines.

WShow Procedure

Exposes or hides the designated window. It does not automatically make the designated window the active window.

WWrite_DIB Function (Windows)

(Microsoft Windows Only) Saves the contents of a graphics window to a file as a Device Independent Bitmap (DIB).

WWrite_META Function (Windows)

(Microsoft Windows Only) Saves the contents of a graphics window to a file as a Windows metafile (WMF).

3D Visualization Toolkit (VTK) Routines

ISOSURF Procedure

Standard Library procedure that computes, and optionally displays, an isosurface of the specified 3D data.

vtkADDATTRIBUTE Procedure

Collects point attributes for VTK datasets.

vtkAXES Procedure

Creates a set of axes.

vtkBAR Procedure

Creates a plot of 3D cylinders.

vtkCAMERA Procedure

Changes the camera’s parameters.

vtkCOLORBAR Procedure

Adds a color bar legend to a VTK scene using the current PV‑WAVE color table.

vtkCLOSE Procedure

Closes the VTK process.

vtkCOMMAND Procedure

Sends Tcl and VTK commands to the Tcl process.

vtkERASE Procedure

Erases the contents of the current VTK window.

vtkGETNAMES Function

Returns the names of all Lights, Cameras and Actors in a renderer.

vtkGRID Procedure

Adds 3D grid lines to a VTK scene.

vtkHEDGEHOG Procedure

Creates a HedgeHog (vector) plot.

vtkINIT Procedure

Initializes the VTK system.

vtkISOSURFACE Procedure

Displays the requested iso surfaces of a volume.

vtkLIGHT Procedure

Adds a light to a VTK window.

vtkPLOTS Procedure

Adds a polyline.

vtkPOLYDATA Procedure

Passes vertex/polygon lists, lines, points, and triangles to VTK.

vtkPOLYSHADE Procedure

Renders a polygon object.

vtkPPMREAD Function

Reads a PPM file.

vtkPPMWRITE Procedure

Writes the contents of a VTK window to a PPM file.

vtkRECTILINEARGRID Procedure

Passes data describing a Rectiliniar Grid to VTK.

vtkRENDERWINDOW Procedure

Renders a VTK window.

vtkSCATTER Procedure

Renders 3D points.

vtkSHOW3 Procedure

Shows a 2D array three ways in a display that combines vtkSURFACE, "CONTOUR", and an image map.

vtkSLICEVOL Procedure

Creates a sliced 3D volume at specific x, y, z locations.

vtkSTRUCTUREDGRID Procedure

Passes data describing a structured grid to VTK.

vtkSTRUCTUREDPOINTS Procedure

Passes data describing structured points to VTK.

vtkSURFACE Procedure

Renders a surface.

vtkSURFGEN Procedure

Generates a 3D surface from sampled points assumed to lie on a surface.

vtkTEXT Procedure

Adds a text string.

vtkTVRD Function

Returns the contents of a VTK window as a bitmapped image.

vtkUNSTRUCTUREDGRID Procedure

Passes data describing an unstructured grid to VTK.

vtkWDELETE Procedure

Closes a VTK window, however it does not shut down the Tcl process.

vtkWINDOW Procedure

Creates a VTK window.

vtkWRITEVRML Procedure

Creates a Virtual Reality Modeling Language file (VRML .wrl file) from a scene in a VTK window.

vtkWSET Procedure

Sets the active VTK window.

VDA Tools Routines

NAVIGATOR Procedure

Starts the Navigator.

WzAnimate Procedure

Starts a VDA Tool used for animating a sequence of images.

WzClose Procedure

Closes all VDA tools registered with the Tools Manager.

WzColorEdit Procedure

Starts a VDA Tool used for editing the image and plot color tables used in other VDA Tools.

WzContour Procedure

Starts a VDA Tool used for plotting contours.

WzExport Procedure

Starts a VDA Tool used for exporting a PV‑WAVE variable to an external file in a specified format.

WzHistogram Procedure

Starts a VDA Tool used for plotting a histogram.

WzImage Procedure

Starts a VDA Tool used for displaying image data.

WzImport Procedure

Starts a VDA Tool used for importing data into PV‑WAVE.

WzInit Procedure

Initializes the VDA Tools Manager layer.

WzMultiView Procedure

Starts a VDA Tool used to display multiple plots.

WzPlot Procedure

Starts a VDA Tool used for 2D plotting.

WzPreview Procedure

Starts a VDA Tool used to view an ASCII file’s contents and select which parts of the file are to be read in as PV‑WAVE variables.

WzSurface Procedure

Starts a VDA Tool used for surface plots.

WzTable Procedure

Starts a VDA Tool used for creating an editable 2D array of cells containing string data.

WzVariable Procedure

Starts a VDA Tool used for viewing and exporting variables.