next up previous contents index
Next: plfc: Plot filled contours Up: Output Primitives Previous: plv: Plot a Vector   Contents   Index


plf: Plot a Filled Mesh

Calling Sequence
...

plf(z[, y, x][, ireg][, <keylist>])

Description
Plot a filled mesh y versus x. y, x, and ireg are as for plm. The z array must have the same shape as y and x, or one smaller in both dimensions. If z is of type unsigned char (Python typecode 'b'), it is used ``as is''; otherwise, it is linearly scaled to fill the current palette, as with the bytscl function. The mesh is drawn with each zone in the color derived from the z function and the current palette; thus z is interpreted as a zone-centered array. The y, x, and ireg arguments may all be omitted to default to the mesh set by the most recent plmesh call.

A solid edge can optionally be drawn around each zone by setting the edges keyword non-zero. ecolor and ewidth determine the edge color and width. The mesh is drawn zone by zone in order from ireg(2+ imax) to ireg(jmax* imax) (the latter is ireg(imax, jmax)), so you can achieve 3D effects by arranging for this order to coincide with back-to-front order. If z is nil, the mesh zones are filled with the background color, which you can use to produce 3D wire frames.

Keyword Arguments

The following keyword argument(s) apply only to this function.

edges = 0/ 1 
ecolor = <color value> 
ewidth = <float value>

Set the appearance of the zone edges in a filled mesh plot (plf). By default, edges= 0, and the zone edges are not plotted. If edges= 1, a solid line is drawn around each zone after it is filled; the edge color and width are given by ecolor and ewidth, which are ``fg'' and 1.0 by default.

The following additional keyword arguments can be specified with this function. legend, hide, region, top, cmin, cmax See ``Plot Function Keywords'' on page [*] for detailed descriptions of these keywords. (See the bytscl function description on page [*] for explanation of top, cmin, cmax.)

Examples

The following gives a filled mesh plot of the same mesh we have been considering in the preceding examples.

plf (mag(x+. 5, y-. 5))

8#8


next up previous contents index
Next: plfc: Plot filled contours Up: Output Primitives Previous: plv: Plot a Vector   Contents   Index
Michiel Jan Laurens de Hoon 2003-04-19