mphint2

[v1,...,v2] = mphint2(model,{e1,...,en},edim,...)

[v1,...,v2,unit] = mphint2(model,{e1,...,en},edim,...)

[v1,...,vn] = mphint2(model,{e1,...,en},...) evaluates the integrals 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, as a string: line, surface, volume or as an integer value.

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

The function mphint2 accepts the following property/value pairs:

Table 6-13: Property/Value Pairs for the mphint2 Command.
Property	Property value	Default	Description
dataseries	none \| average \| integral \| maximum \| rms \| stddev \| variance	none	Data series operation
dataset	String	Active solution dataset	Dataset tag
intorder	Positive integer	4	Integration order
intsurface	on \| off	off	Compute surface integral
intvolume	on \| off	off	Compute volume integral
matrix	on \| off	on	Returns data as a matrix or as a cell
method	auto \| integration \| summation	auto	Integration method
outersolnum	Positive integer \| 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 expressions e1,...,en are integrated 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 integrations. 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.

For time-dependent problems, the variable t can be used in the expressions ei. The value of t is the interpolation time when the property t is provided, and the time for the solution, when solnum is used. Similarly, lambda and the parameter are available as eigenvalues for eigenvalue problems and as parameter values for parametric problems, respectively.

The unit property defines the unit of the integral, if a inconsistent unit is entered, the default unit is used. In case of multiple expression, if the unit property is defined with a string, the same unit is used for both expressions. To use different units, set the property with a cell array. In case of inconsistent unit definition, the default unit is used instead.

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

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

Example

Integrate the normal heat flux across all boundaries:

model = mphopen('model_tutorial_llmatlab');

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

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

std.run;

[Q, unit] = mphint2(model,'ht.ntflux','surface');

Integrate the normal heat flux across all exterior boundaries

[Q, unit] = mphint2(model,'ht.ntflux','surface',...

'selection',[1:5,7:12]);