PrincipalLine, PrincipalSurface, PrincipalVolume
Create a principal stress or principal strain plot in volumes, on surfaces, or on lines (edges).
Syntax
model.result(<pgtag>).create(<ftag>,"PrincipalVolume");
model.result(<pgtag>).create(<ftag>,"PrincipalSurface");
model.result(<pgtag>).create(<ftag>,"PrincipalLine");
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-88: 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 | dataset name
parent
The dataset this feature refers to.
gporder
poitive integer
1
If pattern is gauss: The Gauss point order.
inheritarrowscale
Boolean
true
If inheritplot is not none: Determines if arrow scale is inherited.
inheritcolor
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 | gausspoints
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 mesh element centroids. If gausspoints, the arrows are drawn in the Gauss points (with order set by gporder). 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.
princstraindata
manual | any available principal strain data
First available principal strain data
The data used for the principal strain plot. If set to manual, specify principal values and directions. The data is referred to using the physics interface and an integer: solid_1, for example, is the first available principal strain data from a Solid Mechanics interface.
princstressdata
manual | any available principal stress data
First available principal stress data
The data used for the principal stress plot. If set to manual, specify principal values and directions. The data is referred to using the physics interface and an integer: solid_1, for example, is the first available principal stress data from a Solid Mechanics interface.
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 dataset that has default axis settings and points to a solution or mesh dataset 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.
Attributes
Color, Deform, Filter (Plot Attribute), Selection