mphmean

[v1,...,vn] = mphmean(model,{e1,...,en},edim,...)

[v1,...,vn,unit] = mphmean(model,{e1,...,en},edim,...)

[v1,...,vn] = mphmean(model,{e1,...,en},edim,...) evaluates the means of the string expressions e1,...,en and returns the result in N matrices v1,...,vn with M rows and P columns. M is the number of inner solution and P the number of outer solution used for the evaluation. edim defines the element dimension: line, surface, volume or as an integer value.

[v1,...,vn] = mphmean(model,{e1,...,en},edim,...) also returns the units of the maximum in a 1xN cell array.

The function mphmean accepts the following property/value pairs:

Table 6-17: Property/Value Pairs for the mphmean Command.
Property	Property value	Default	Description
dataseries	none \| average \| integral \| maximum \| minimum \| rms \| stddev \| variance	none	Data series operation
dataset	String	Active solution dataset	Dataset tag
intorder	Positive integer	4	Integration order
matrix	off \| on	on	Returns data as a matrix or as a cell
method	auto \| integration \| summation	auto	Integration method
outersolnum	Positive integer array \| all \| end	1	Solution number for parametric sweep
selection	Integer vector \| string \| all	all	Selection list or named selection
solnum	Integer vector \| end \| all	all	Solution for evaluation
squeeze	on \| off	on	Squeeze singleton dimensions
t	Double array		Time for evaluation

The property dataset controls which dataset is used for the evaluation. Datasets contain or refer to the source of data for postprocessing purposes. Evaluation is supported only on Solution datasets.

The mean of expressions e1,...,en is evaluated for one or several solutions. Each solution generates an additional column in the returned matrix. The properties solnum and t control which solutions are used for the evaluation. The solnum property is available when the dataset has multiple solutions — for example, in the case of parametric, eigenfrequency, or time-dependent solutions. The t property is available only for time-dependent problems. If solnum is provided, the solutions indicated by the indices provided with the solnum property are used. If t is provided, solutions are interpolated. If neither solnum nor t is provided, all solutions are evaluated.

The property solnum is used to select the solution number when a parametric, eigenvalue, or time-dependent solver has been used.

The property outersolnum is used to select the outer solution number when a parametric sweep has been used in the study step node.

If the matrix property is set to off the output is cell arrays of length P containing cell arrays of length M.

Example

Evaluate the mean temperature in the model domain:

model = mphopen('model_tutorial_llmatlab');

std = model.study.create('std');

std.feature.create('stat','Stationary');

std.run;

maxT = mphmean(model,'T','volume');

Evaluate the mean temperature on boundary 9:

maxT = mphmean(model,'T','surface','selection',9);