ScatterVolume, ScatterSurface
Create a scatter plot on surfaces or in volumes.
Syntax
model.result(<pgtag>).create(<ftag>,"ScatterVolume");
model.result(<pgtag>).create(<ftag>,"ScatterSurface");
model.result(<pgtag>).feature(<ftag>).set(property, <value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"Scatter...") creates a scatter plot feature named <ftag> belonging to the plot group <pgtag>.
Scatter plots are available in 2D (ScatterSurface) and 3D (ScatterVolume),
The following properties are available:
Table 7-124: Valid Property/Value Pairs for Scatter Plots
Property
Value
Default
Description
arrowxmethod
number | coord
number
Indicates whether the x-coordinates of the spheres should be specified by number of points to distribute evenly across the data or by coordinates.
arrowymethod
number | coord
number
Indicates whether the y-coordinates of the spheres should be specified by number of points to distribute evenly across the data or by coordinates.
arrowzmethod
number | coord
number
Indicates whether the z-coordinates of the spheres should be specified by number of points to distribute evenly across the data or by coordinates. Available for ScatterVolume.
color
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
red
The color to use.
colorexpr
String
 
The expression for the colors of the spheres.
colordescr
String
 
A description of colorexpr.
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.
descr
String
Model dependent
The description of the expressions in expr. Is used in the automatic title.
descriptionintitle
on | off
on
Whether the title contribution should contain the description when titletype is custom.
differential
on | off
on
Whether the expression should be linearized at the linearization point. Applicable only if evalmethod is harmonic.
evalmethod
linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak
harmonic
Applicable only for solutions with a stored linearization point. Controls if the linearization point, the perturbation, or a combination should be used when evaluating the expression.
expr
String array of length 2 in 2D and 3 in 3D
Mode-dependent
The components to plot.
inheritcolor
Boolean
true
If inheritplot is not none: Determines if the color is inherited.
inheritplot
none | plot name
none
The plot that color and sphere scale are inherited from.
inheritrange
Boolean
true
If inheritplot is not none: Determines if the color and data ranges are inherited.
inheritspherescale
Boolean
true
If inheritplot is not none: Determines if the sphere scale is inherited.
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.
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.
planecoordsys
cutplane | cartesian
cartesian
Coordinate system for scatter plot vectors. Only available for plots that use a cut plane dataset that points to a 3D solution or mesh dataset.
prefixintitle
String
Empty
Added prefix to contribution to title.
radiusexpr
String
 
The expression for the radii of the spheres.
radiusdescr
String
 
A description of radiusexpr.
rangecoloractive
on | off
off
Whether to use the manual color range specified in rangecolormin and rangecolormax. The color range specifies the minimum and maxim value in the plotted colors. Default is the minimum and maximum data values.
rangecolormax
double
Plot dependent
The maximum color range value. Active when rangecoloractive is on.
rangecolormin
double
Plot dependent
The minimum color range value. Active when rangecoloractive is on.
rangedatactive
on | off
off
Whether to use the manual data range specified in rangedatamin and rangedatamax. Values outside the data range is not plotted.
rangedatamax
double
Plot dependent
The maximum data value. Active when rangedataactive is on.
rangedatamin
double
Plot dependent
The minimum data value. Active when rangedataactive is on.
revcoordsys
cylindrical | cartesian
cartesian
Coordinate system for scatter plot 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.
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.
solutionparams
manual | parent
manual
If data is a local dataset with nontrivial data, specify solutions manually or take them from the parent plot group.
sphereradiusscale
double
1
The scale factor applied to the sphere radii if sphereradiusscaleactive is true.
sphereradiusscaleactive
Boolean
false
If true, sphereradiusscale is used; otherwise the scale factor is computed automatically.
suffixintitle
String
Empty
Added suffix to contribution to title.
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 | custom | label | manual | none
auto
auto, if the title should be computed automatically. custom, if the title should be computed automatically, but customized. label, if the title should be the plot group’s label. manual, if the manual title should be used (the title property). none, if no title should be displayed.
typeintitle
on | off
on
Whether the title contribution should contain the type when titletype is custom.
xnumber
nonnegative integer
15 (3D), 7 (2D)
Number of points in the x direction. Active when arrowxmethod is set to number.
xcoord
double array
Empty
Absolute coordinates in the x direction, active when arrowxmethod is set to coord.
ynumber
integer
15 (3D), 7 (2D)
Number of points in the y direction. Active when arrowymethod is set to number.
ycoord
double array
Empty
Absolute coordinates in the z direction, active when arrowymethod is set to coord.
znumber
integer
15 (3D), 7 (2D)
Number of points in the z direction. Active when arrowzmethod is set to number. Available for ScatterVolume.
zcoord
double array
Empty
Absolute coordinates in the z direction, active when arrowzmethod is set to coord. Available for ScatterVolume.
Attribute
MaterialAppearance, Transparency (ScatterVolume only)
See Also
Surface (Plot), Volume