Partial Differential Equation Toolbox |

pdeplot

Generic PDE Toolbox plot function

Syntax

-     pdeplot(p,e,t,'PropertyName',PropertyValue,)
      h=pdeplot(p,e,t,'PropertyName',PropertyValue,)

Description

`pdeplot(p,e,t,p1,v1,...)` is the generic PDE Toolbox plot function. It can display several functions of a PDE solution at the same time.

The geometry of the PDE problem is given by the mesh data `p`, `e`, and `t`. For details on the mesh data representation, see `initmesh`.

Valid property/value pairs include the following.

Property Name | Property Value/Default | Description
`xydata` | data | `Triangle data`
`xystyle` | `off|flat|{interp}` | `x-y data plot style`
`contour` | {`off`}|`on` | `Show contours`
`zdata` | data | `Node or triangle data`
`zstyle` | `off`|{`continuous`}| `discontinuous` | `3-D height plotstyle`
`flowdata` | data | `Node or triangle data`
`flowstyle` | `off`|{`arrow`} | `Flow plot style`
`colormap` | colormap `cool` | `x-y data colormap name or colormap matrix`
`xygrid` | {`off}`|`on` | `Convert to x-y grid before plotting`
`gridparam` | [tn; a2; a3] | `Triangle index and interpolation parameters from earlier call to `tri2grid``
`mesh` | {`off`}`|on` | `Show mesh in plot`
`colorbar` | `off|`{`on`} | `Show colorbar`
`title` | " | `Plot title text`
`levels` | 10 | `Number of levels or a vector specifying levels`

The `pdeplot` is used both from inside the `pdetool` GUI and from the command line. It is able to display three entities simultaneously. `xydata` can be visualized by a surface plot. Either flat or interpolated (default) shading can be used for the surface plots. A contour plot can be superimposed on the surface plot (in black) or plotted independently (in colors) by setting `contour` to `on`. `zdata` is visualized by displaying height. The triangles can be either tilted by interpolation (default) or flat. Flow data can be visualized by plotting arrows like the MATLAB `quiver` plot. All data types can be either node data or triangle data (flow data can only be triangle data). Node data is represented by a column vector of length `size(p,2)` and triangle data is represented by a row vector of length `size(t,2)`. If no `xydata`, `zdata`, or `flowdata` is supplied, `pdeplot` plots the mesh specified by `p`, `e`, and `t`.

The option `mesh` displays or hides (default) the triangle mesh in the plot. The option `xygrid` first converts the data to x-y data (using `tri2grid`), and then uses a standard MATLAB plotting algorithm. The property `gridparam` passes the `tri2grid` data to `pdeplot`. This speeds up animation (see `pdedemo5` and `pdedemo6`). The property `colormap` renders the plot using any MATLAB colormap or color matrix. `colorbar` adds a colorbar to the plot. `title` inserts a title into the plot. `levels` only applies to contour plots: Given a scalar integer value, it plots that number of equally spaced contour levels; given a vector of level values, it plots those contour lines on the levels in the vector.

`h=pdeplot(p,t,u)` additionally returns handles to the drawn axes objects.

Examples

The command sequence below plots the solution to Poisson's equation on the L-shaped membrane in 3-D.

-     [p,e,t]=initmesh('lshapeg');
      u=assempde('lshapeb',p,e,t,1,0,1);
      pdeplot(p,e,t,'xydata',u,'zdata',u,'mesh','off');

See Also

`pdecont`, `pdegplot`, `pdemesh`, `pdesurf`

| pdenonlin |  | pdepoly |