AvVolume, AvSurface, AvLine
Compute a volume average, surface average, or line average.
Syntax
model.result().numerical().create(<ftag>,"AvVolume");
model.result().numerical().create(<ftag>,"AvSurface");
model.result().numerical().create(<ftag>,"AvLine");
model.result().numerical(<ftag>).selection(...);
model.result().numerical(<ftag>).set(property, <value>);
model.result().numerical(<ftag>).getReal();
model.result().numerical(<ftag>).getReal(<columnwise>);
model.result().numerical(<ftag>).getReal(<outersolnum>);
model.result().numerical(<ftag>).getReal(<columnwise>,<outersolnum>);
model.result().numerical(<ftag>).getImag();
model.result().numerical(<ftag>).getImag(<allocate>, <columnwise>);
model.result().numerical(<ftag>).getImag(<outersolnum>);
model.result().numerical(<ftag>).getImag(<allocate>, <columnwise>,<outersolnum>);
model.result().numerical(<ftag>).isComplex();
model.result().numerical(<ftag>).isComplex(<outersolnum>);
model.result().numerical(<ftag>).computeResult();
model.result().numerical(<ftag>).setResult();
model.result().numerical(<ftag>).appendResult();
 
When added to an evaluation group, replace numerical(<ftag>) with evaluationGroup(<ftag>).
Description
model.result().numerical().create(<ftag>,"AvVolume") creates a volume average feature with the name <ftag>.
model.result().numerical().create(<ftag>,"AvSurface") creates a surface average feature with the name <ftag>.
model.result().numerical().create(<ftag>,"AvLine") creates a line average feature with the name <ftag>.
model.result().numerical(<ftag>).getReal() returns the real result, recomputing the feature if necessary. Data is ordered such that one row contains data for all solution numbers. This is identical to (columnwise) when columnwise is false. If columnwise is true, the ordering is the opposite: each column contains the values for all solution numbers.
model.result().numerical(<ftag>).getImag(allocate, columnwise) returns the imaginary part of complex result, recomputing the feature if necessary. If allocate is true, a zero-valued matrix is allocated even when the result is real. getImag() uses allocate true and columnwise false.
model.result().numerical(<ftag>).isComplex() returns true if the result is complex. The resulting value is a scalar, which true if any of the expressions in an array is complex-valued.
model.result().numerical(<ftag>).isComplex(<outersolnum>) returns true if the result is complex for the given outer solution. <outersolnum> is applicable only for parametric sweep solutions and is the index of each outer parametric solution.
model.result().numerical(<ftag>).selection() returns the selection of the geometry for the computation of the volume average, surface average, or line average. See Selections for more information about the available selection methods.
model.result().numerical(<ftag>).set(property,<value>) sets the value of a property of the volume average, surface average, or line average.
model.result().numerical(<ftag>).computeResult() returns the matrix of data that the setResult method adds to a table. The matrix includes data only, not the parameter columns, and it does not use any table-specific settings.
model.result().numerical(<ftag>).setResult() and model.result().numerical(<ftag>).appendResult() evaluates the feature and set or append the result in the table indicated by the table property.
The following properties are available:
none | parent | dataset name
The dataset this feature refers to. parent is only applicable if used in an evaluation group.
average | integral | maximum | minimum | none | rms | stddev | variance
true | false
auto | integration | summation
The descriptions of the expression in expr. Is used in the automatic title.
on | off
linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak
all | first | last | manual | manualindices | interp
How to input the solution to use. manual indicates that solnum is used. manualindices indicates that solnumindices is used. interp indicates that t is used.
The times to use, for transient levels. Available when data is not parent and the underlying data is transient.
on | off
on | off
on | off
The local z-coordinates, when locdef is set to physical.
The local relative z-coordinates, when locdef is set to relative.
reference | physical | relative
The location definition, if locinput is set to manual: a reference surface, physical z-coordinate, or a relative z-coordinate. Only available when using a Layered Material or Shell dataset. Not available for AvVolume.
fromdataset | manual
The location input: from the dataset or manual. Only available when using a Layered Material or Shell dataset. Not available for AvVolume.
An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when looplevelinput is manualindices on a level.
String array with all | first | last | manual | manualindices | interp on each level
all on all levels
How to input the solution to use, per level. manual on a level indicates that looplevel is used on that level. manualindices on a level indicates that looplevelindices is used on that level. interp on a level indicates that interp is used on that level.
abs | real
auto | integration | summation
abs | real
first | last | maximum | none
all | first | last | manual | manualindices
How to input the outer solutions to use. Applicable only for parametric sweep models. manual indicates that outersolnum is used. manualindices indicates that outersolnumindices is used.
An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when innerinput is manualindices.
solnum | solutioninfo
manual | parent
If data is a local dataset with nontrivial data and the feature is part of an evaluation group, specify solutions manually or take them from the parent evaluation group.
new | table name
The table to use when calling setResult() or appendResult(). new indicates that a new table is created.
inner | outer | data | level1
Whether to use inner or outer solutions as columns in the table when calling setResult() or appendResult(). Applicable only for parametric sweep models. The level values (level1, level2, and so on) are the levels in the parametric sweep.
The units to use for the expressions in expr. If the old unit is not valid when the expression changes, the unit property is reset to default.
See Also
IntVolume, IntSurface, IntLine