Partial Differential Equation Toolbox |

Plot Menu

Plot Solution | Display a plot of the solution.
Parameters . . . | Open dialog box for plot selection.
Export Movie . . . | If a movie has been recorded, the movie matrix `M` is exported to the main workspace.

Parameters . . .

Plot Selection Dialog Box

Parameters . . . opens a dialog box containing options controlling the plotting and visualization.

The upper part of the dialog box contains four columns:

- Plot type (far left) contains a row of six different plot types, which can be used for visualization:

- Color. Visualization of a scalar property using colored surface objects.
- Contour. Visualization of a scalar property using colored contour lines. The contour lines can also enhance the color visualization when both plot types (Color and Contour) are checked. The contour lines are then drawn in black.
- Arrows. Visualization of a vector property using arrows.
- Deformed mesh. Visualization of a vector property by deforming the mesh using the vector property. The deformation is automatically scaled to 10% of the problem domain. This plot type is primarily intended for visualizing x- and y-displacements (u and v) for problems in structural mechanics. If no other plot type is selected, the deformed triangular mesh is displayed.
- Height (3-D plot). Visualization of a scalar property using height (z-axis) in a 3-D plot. 3-D plots are plotted in separate figure windows. If the Color and Contour plot types are not used, the 3-D plot is simply a mesh plot. You can visualize another scalar property simultaneously using Color and/or Contour, which results in a 3-D surface or contour plot.
- Animation. Animation of time-dependent solutions to parabolic and hyperbolic problems. If you select this option, the solution is recorded and then animated in a separate figure window using the MATLAB `movie` function.

A colorbar is added to the plots to map the colors in the plot to the magnitude of the property that is represented using color or contour lines.

- Property contains four pop-up menus containing lists of properties that are available for plotting using the corresponding plot type. From the first pop-up menu you control the property that is visualized using color and/or contour lines. The second and third pop-up menus contain vector valued properties for visualization using arrows and deformed mesh, respectively. From the fourth pop-up menu, finally, you control which scalar property to visualize using z-height in a 3-D plot. The lists of properties are dependent on the current application mode. For the generic scalar mode, you can select the following scalar properties:

- u. The solution itself.
- abs(grad(u)). The absolute value of u, evaluated at the center of each triangle.
- abs(c*grad(u)). The absolute value of c · u, evaluated at the center of each triangle.
- user entry. A MATLAB expression returning a vector of data defined on the nodes or the triangles of the current triangular mesh. The solution `u`, its derivatives `ux` and `uy`, the x and y components of c · u, `cux` and `cuy`, and `x` and `y` are all available in the local workspace. You enter the expression into the edit box to the right of the Property pop-up menu in the User entry column.

  Examples: `u.*u, x+y`

- The vector property pop-up menus contain the following properties in the generic scalar case:

  - -grad(u). The negative gradient of u, -u.
  - -c*grad(u). c times the negative gradient of u, -c · u.
  - user entry. A MATLAB expression `[px; py]` returning a 2-by-ntri matrix of data defined on the triangles of the current triangular mesh (ntri is the number of triangles in the current mesh). The solution `u`, its derivatives `ux` and `uy`, the x and y components of c · u, `cux` and `cuy`, and `x` and `y` are all available in the local workspace. Data defined on the nodes is interpolated to triangle centers. You enter the expression into the edit field to the right of the Property pop-up menu in the User entry column.

  - Examples: `[ux;uy], [x;y]`

For the generic system case, the properties available for visualization using color, contour lines, or z-height are u, v, abs(u,v), and a user entry. For visualization using arrows or a deformed mesh, you can choose (u,v) or a user entry. For applications in structural mechanics, u and v are the x- and y-displacements, respectively.

For the visualization options in the other application modes, see Application Modes. Note that the variables available in the local workspace for a user entered expression are the same for all scalar and system modes (the solution is always referred to as u and, in the system case, `v`).

- User entry contains four edit fields where you can enter your own expression, if you select the user entry property from the corresponding pop-up menu to the left of the edit fields. If the user entry property is not selected, the corresponding edit field is disabled.
- Plot style contains three pop-up menus from which you can control the plot style for the color, arrow, and height plot types respectively. The available plot styles for color surface plots are

- Interpolated shading. A surface plot using the selected colormap and interpolated shading, i.e., each triangular area is colored using a linear, interpolated shading (the default).
- Flat shading. A surface plot using the selected colormap and flat shading, i.e., each triangular area is colored using a constant color.

- You can use two different arrow plot styles:

  - Proportional. The length of the arrow corresponds to the magnitude of the property that you visualize (the default).
  - Normalized. The lengths of all arrows are normalized, i.e., all arrows have the same length. This is useful when you are interested in the direction of the vector field. The direction is clearly visible even in areas where the magnitude of the field is very small.

  For height (3-D plots), the available plot styles are

  - Continuous. Produces a "smooth" continuous plot by interpolating data from triangle midpoints to the mesh nodes (the default).
  - Discontinuous. Produces a discontinuous plot where data and z-height are constant on each triangle.

A total of three properties of the solution -- two scalar properties and one vector field -- can be visualized simultaneously. If the Height (3-D plot) option is turned off, the solution plot is a 2-D plot and is plotted in the main axes of the `pdetool` GUI. If the Height (3-D plot) option is used, the solution plot is a 3-D plot in a separate figure window. If possible, the 3-D plot uses an existing figure window. If you would like to plot in a new figure window, simply type `figure` at the MATLAB command line.

Additional Plot Control Options

In the middle of the dialog box are a number of additional plot control options:

- Plot in x-y grid. If you select this option, the solution is converted from the original triangular grid to a rectangular x-y grid. This is especially useful for animations since it speeds up the process of recording the movie frames significantly.
- Show mesh. In the surface plots, the mesh is plotted using black color if you select this option. By default, the mesh is hidden.
- Contour plot levels. For contour plots, the number of level curves, e.g., `15` or `20` can be entered. Alternatively, you can enter a MATLAB vector of levels. The curves of the contour plot are then drawn at those levels. The default is 20 contour level curves.

  Examples: `[0:100:1000]`, `logspace(-1,1,30)`

- Colormap. Using the Colormap pop-up menu, you can select from a number of different colormaps: `cool`, `gray`, `bone`, `pink`, `copper`, `hot`, `jet`, `hsv`, and `prism`.
- Plot solution automatically. This option is normally selected. If turned off, the PDE Toolbox does not display a plot of the solution immediately upon solving the PDE. The new solution, however, can be plotted using this dialog box.

For the parabolic and hyperbolic PDEs, the bottom right portion of the Plot Selection dialog box contains the Time for plot parameter.

Time for plot. A pop-up menu allows you to select which of the solutions to plot by selecting the corresponding time. By default, the last solution is plotted.

Also, the Animation plot type is enabled. In its property field you find an Options . . . button. If you press it, an additional dialog box appears. It contains parameters that control the animation:

- Animation rate (fps). For the animation, this parameter controls the speed of the movie in frames per second (fps).
- Number of repeats. The number of times the movie is played.
- Replay movie. If you select this option, the current movie is replayed without rerecording the movie frames. If there is no current movie, this option is disabled.

For eigenvalue problems, the bottom right part of the dialog box contains a pop-up menu with all eigenvalues. The plotted solution is the eigenvector associated with the selected eigenvalue. By default, the smallest eigenvalue is selected.

You can rotate the 3-D plots by clicking the plot and, while keeping the mouse button down, moving the mouse. For guidance, a surrounding box appears. When you release the mouse, the plot is redrawn using the new viewpoint. Initially, the solution is plotted using -37.5 degrees horizontal rotation and 30 degrees elevation.

If you click the Plot button, the solution is plotted immediately using the current plot setup. If there is no current solution available, the PDE is first solved. The new solution is then plotted. The dialog box remains on the screen.

If you click the Done button, the dialog box is closed. The current setup is saved but no additional plotting takes place.

If you click the Cancel button, the dialog box is closed. The setup remains unchanged since the last plot.

| Solve Menu |  | Window Menu |