COMSOL 6.2 - mphplot

mphplot(model) opens a figure window and adds a menu where it is possible to switch between all the different result plots in a model as well as any geometry and mesh plots. A toolbar is added to the figure that allows the user to control the use of views, lights, and camera settings.

mphplot(model,pgtag,…) renders the plot group tagged pgtag from the model object model in a figure window in MATLAB®.

pd = mphplot(model,pgtag,…) also returns the plot data used in the MATLAB figure in a cell array pd. pd contains ordinary MATLAB data and can later be used to recreate the plot using mphplot. It is also possible to investigate and extract data from the plot this way in order to create plots in other ways or to further analyze the data. Set createplot to off if a plot should be not be created. Note that pd contains data in single precision even though all calculations in COMSOL Multiphysics are carried out in double precision.

mphplot(pd,…) makes a plot using the post data structure pd that is generated using the function mpheval. Plots involving points, lines, and surfaces are supported.

The function mphplot accepts the following property/value pairs:

Table 6-35: property/value pairs for the mphplot command.
property	value	default	description
axiscolor	char \| RGB array	gray	Symmetry axis color
colortablesteps	Integer	256	Number of steps in colortables*
createplot	on \| off	on	Create a plot
index	Positive integer	1	Index of variable to use for plotting post data structure
mesh	on \| off	on	Plot the mesh when using post data structure
parent	Double		Set the parent axes
rangenum	Positive integer	none	Color range bar (or legend) to display
run	on \| off	on	Run the plot group node
server	on \| off	off	Plot on server **
view	String \| auto \| none	auto	View settings tag

* The minimum number of steps in colortables is 256.

** The plot on server option requires that you start COMSOL with MATLAB in graphics mode.

Only one color range bar and one legend is supported in a MATLAB figure. When the option plot on server is active, all active color range bars are displayed.

When extracting plot data structure on machines without a graphics display set the property createplot to 'off' and use the output pd to extract data that can be used for plotting later. The pd struct only contains ordinary MATLAB data and can be saved using the save command.

The data fields returned by mphplot are subject to change. The most important fields are:

•

p, the coordinates for each point that are used for creating lines or triangles.

•

n, the normals in each point for the surfaces. These are not always available.

•

t, contains the indices to columns in p of a simplex mesh, each column in t representing a simplex.

•

d, the data values for each point.

•

rgb, the color values (red, green, and blue) entities at each point.

Example