PrincipalSurface, PrincipalVolume
Create a principal stress or principal strain plot in volumes or on surfaces.
Syntax
model.result(<pgtag>).create(<ftag>,"PrincipalVolume");
model.result(<pgtag>).create(<ftag>,"PrincipalSurface");
model.result(<pgtag>).feature(<ftag>).set(property, <value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
  model.result(<pgtag>).create(<ftag>,"PrincipalVolume") create a volume principal stress or principal strain plot named <ftag> belonging to the plot group <pgtag>.
The following properties are available:
Table 7-77: Valid Property/Value Pairs for Principal stress/strain Plots
Property
Value
Default
Description
arrowcount
positive integer
200
The number of arrows. Available for PrincipalSurface in 3D.
arrowlength
normalized | proportional | logarithmic
proportional
The arrow scaling: Proportional uses the actual arrow length, normalized a unit length, and logarithmic a length proportional to the logarithm of the arrow length.
arrowtype
arrow | cone
arrow
The type of arrow to draw
arrowxmethod
number | coord
number
Indicates whether the x-coordinates of the arrows should be specified by number of points to distribute evenly across the data or by coordinates. Available for PrincipalSurface in 2D and PrincipalVolume in 3D.
arrowymethod
number | coord
number
Indicates whether the y-coordinates of the arrows should be specified by number of points to distribute evenly across the data or by coordinates. Available for PrincipalSurface in 2D and PrincipalVolume in 3D.
arrowzmethod
number | coord
number
Indicates whether the z-coordinates of the arrows should be specified by number of points to distribute evenly across the data or by coordinates. Available for PrincipalVolume in 3D.
color
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
red
The color to use.
const
String array of property/value pairs
Empty
Parameters to use in the expressions.
customcolor
RGB-triplet
{1,0,0} or last used color.
The uniform color to use. Active when color is set to custom.
data
none | parent | data set name
parent
The data set this feature refers to.
inheritarrowscale
Boolean
true
If inheritplot is not none: Determines if arrow scale is inherited.
inherit color
Boolean
true
If inheritplot is not none: Determines if the color is inherited.
inheritplot
none | plot name
none
The plot that arrow scale and color are inherited from.
interp
double array
Time corresponding to last selected solnum for transient levels.
The time to use, for transient levels. Available when data is not parent and the underlying data is transient.
logrange
double > 1
100
If arrowlength is logarithmic: The ratio between the maximum arrow length and the arrow length below which no arrow is drawn.
looplevel
array of nonnegative integers and strings
Last solution for transient or parametric solution for each level. Otherwise first solution for each level.
The index of the solution to use, per level, or interp, but only for transient solutions. Available when data is not parent and the underlying data has multiple solutions.
outersolnum
nonnegative integer
1
The index of the outer solutions to use. Applicable only for parametric sweep models.
placement|
elements | uniform | uniformani
uniform
If uniform, then the arrows are distributed uniformly. If uniformanisotropic, then the arrows are distributed uniformly with weights taken from the weight property. If elements, then arrows are drawn in each element. Available for PrincipalSurface in 3D.
princdirstrainexpr
3-by-3 string matrix
Physics-dependent
If type is strain: The expressions for the principal directions.
princdirstressexpr
3-by-3 string matrix
Physics-dependent
If type is stress: The expressions for the principal directions.
princvalstrainexpr
1-by-3 string matrix
Physics-dependent
If type is strain: The expressions for the principal values.
princvalstressexpr
1-by-3 string matrix
Physics-dependent
If type is stress: The expressions for the principal values.
revcoordsys
cylindrical | cartesian
cartesian
Coordinate system for principal stress/strain vectors. Only available for plots that use a 1D or 2D revolution data set that has default axis settings and points to a solution or mesh data set for an axisymmetric geometry.
scale
positive double
1
If scaleactive is true: The length scale factor.
scaleactive
Boolean
false
Whether to use manual scaling.
solnum
nonnegative integer
Last solution for transient or parametric solution. Otherwise, first solution.
The index of the solution to use. Available when data is not parent and the underlying data has multiple solutions.
solrepresentation
solnum | solutioninfo
solutioninfo
Indicates which method of selecting solutions is active.
t
double
Time corresponding to last selected solnum
The time to use, for transient problems. Available when data is not parent and the underlying data is transient.
timeinterp
on | off
off
on if t is used to determine time steps, off if solnum is used.
title
String
The auto-title.
The title to use when titletype is manual.
titletype
auto | manual | none
auto
auto if the title contribution should be computed automatically, possibly using the group’s customization. manual if the manual title should be used (the title property). none if no title should be displayed.
type
stress | strain
stress
Selection between principal stress and principal strain plot.
weight
double array
1
If placement is uniformani: The weights given to the different axis directions.
xnumber
nonnegative integer
15 (3D), 7 (2D)
Number of points in the x-direction. Active when arrowxmethod is set to number. Available for PrincipalSurface in 2D and PrincipalVolume in 3D.
xcoord
double array
Empty
Absolute coordinates in the x-direction, active when arrowxmethod is set to coord. Available for PrincipalSurface in 2D and PrincipalVolume in 3D.
ynumber
integer
15 (3D), 7 (2D)
Number of points in the y-direction. Active when arrowymethod is set to number. Available for PrincipalSurface in 2D and PrincipalVolume in 3D.
ycoord
double array
Empty
Absolute coordinates in the z-direction, active when arrowymethod is set to coord. Available for PrincipalSurface in 2D and PrincipalVolume in 3D.
znumber
integer
15 (3D), 7 (2D)
Number of points in the z-direction. Active when arrowzmethod is set to number. Available for PrincipalVolume in 3D.
zcoord
double array
Empty
Absolute coordinates in the z-direction, active when arrowzmethod is set to coord. Available for PrincipalVolume in 3D.