Point
Create a point plot in 2D or 3D.
Syntax
model.result(<pgtag>).create(<ftag>,"Point");
model.result(<pgtag>).feature(<ftag>).set(property,<value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"Point") creates a point plot feature named <ftag> belonging to the 2D or 3D plot group <pgtag>.
Point plots are used to visualize points using different geometric shapes and to plot torque arrows in 2D. Point plots can be added to 2D and 3D plot groups.
The following properties are available:
Table 7-114: Valid Properties for Point Plots.
name
Value
Default
Description
alwayssign
true | false
false
Always show the sign when numberformat is stopwatch or stopwatchsci.
alwayssignexp
true | false
false
Always show the sign of the exponent when numberformat is stopwatchsci.
anchorpoint
upperright | uppermiddle | upperleft | middleright | center | middleleft | lowerright | lowermiddle | lowerleft
upperleft
The position of the point text relative to the point, if pointtype is set to text.
backgroundcolor
custom | fromtheme | black | blue | cyan | gray | green | magenta | red | white | yellow | none
none
The color to use for background rectangle if pointtype is set to text.
bottomcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
black
The bottom color to use for a color gradient. Active when coloring is gradient.
color
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
red
The uniform color to use. Active when coloring is uniform.
coloring
colortable | uniform | gradient
colortable
How to color the points: using a color table, a uniform color, or a color gradient.
colorlegend
on | off
on
Whether to show color legend when coloring is set to colortable.
colorscalemode
linear | linearsymmetric | logarithmic
linear
Scaling of the color table: linear, linear symmetric around 0, or logarithmic, when coloring is set to colortable or gradient.
colortable
color table name
Rainbow
The color table to use when coloring is set to colortable. See Color Tables for a list of color tables.
colortabletrans
none | reverse | nonlinear | nonlinearsymmetric
none
Transformation of the color table, when coloring is set to colortable or gradient.
custombottomcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when bottomcolor is set to custom.
customcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when color is set to custom.
customtopcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when topcolor is set to custom.
data
none | parent | dataset name
parent
The dataset this feature refers to.
decimals
positive integer
2
Number of decimals when numberformat is stopwatch or stopwatchsci.
expr
String
Model dependent
The expression to plot.
fixedpointsize
true | false
false
Whether to use a fixed point size.
gporder
positive integer
1
If placement is gausspoints: The Gauss-point order.
heightexpr
String
1
Height expression, if pointtype is rectangle or ellipse.
includeunit
true | false
false
Whether to include the unit for the values if pointtype is set to text.
integerdigits
positive integer
3
Number of integer digits when numberformat is stopwatch.
labelprefix
String
 
Add an optional prefix to the point plot if pointtype is set to text.
labelsuffix
String
 
Add an optional suffix to the point plot if pointtype is set to text..
lagorder
integer
1
The Lagrange-point order to use if resolution is custom.
legendtitle
String
 
Color legend title, if showlegendstitle has been set to true in the parent plot group.
level
line | point | surface | volume
point
The geometry level for evaluating point data. The default is to take it from points. volume is only available in 3D.
maxpointcount
nonnegative integer
100000
The maximum number of points for point plots when level is not point.
nonlinearcolortablerev
on | off
off
Whether to reverse to color table or gradient when coloring is set to colortable or gradient and colortabletrans is set to nonlinear or nonlinearsymmetric.
numberformat
default | auto | engineering | scientific | stopwatch | stopwatchsci
auto
The number format for the point text: default, automatic, engineering, scientific, stopwatch, or scientific stopwatch.
orientation
horizontal | vertical
horizontal
Orient the point text horizontally or vertically, if pointtype is set to text.
placement
meshnodes | gausspoints
meshnodes
Placement of point evaluation, node points or Gauss points, if level is not point.
pointtype
point | text | block (3D) | ellipsoid (3D) | torque (2D) | rectangle (2D) | ellipse (2D)
point
The point type: point, text, block, or ellipsoid in 3D; point, text, torque, rectangle, or ellipse in 2D.
precision
positive integer
6
The precision for numerical values in the point text when numberformat is auto, engineering, or scientific.
radiusexpr
String
1
Point radius expression, if pointtype is point or torque.
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 are 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.
recover
off | pprint | ppr
off
The derivative recovery method (off, within domains, or everywhere), when placement is set to meshnodes.
resolution
normal | fine | finer | custom
 
The evaluation resolution, if placement is set to meshnodes
rotexpr
String
0
Rotation expression, if pointtype is rectangle or ellipse.
showframe
true | false
false
Whether to show a frame around the point text or not, if pointtype is set to text.
sphereradiusscale
positive double
1
The scale factor applied to the point radii.
smooth
none | material | internal | everywhere | expression
material
Smoothing settings, if level is not point. With material, smoothing is done inside domains with the same material. With internal, smoothing is done inside geometry domains. With expression, the smoothing is based on the expression in smoothexpr.
smoothexpr
String
dom
The expression to use for smoothing when smooth is set to expression.
solutionparams
manual | parent
manual
If data is a local dataset with nontrivial data, specify solutions manually or take them from the parent plot group.
textcolor
custom | fromtheme | black | blue | cyan | gray | green | magenta | red | white | yellow
fromtheme
The color to use for the texts when pointtype is set to text.
threshold
manual | none
none
Use a smoothing threshold.
thresholdvalue
double
0.1
Threshold value (0-1), if threshold is set to manual and level is not point.
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.
topcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
white
The top color to use for a color gradient. Active when coloring is gradient.
trailingzeros
true | false
false
Include trailing zeros when numberformat is auto, engineering, or scientific.
transformexpr
3-by-3 array
{"1","0","0";"0","1","0"; "0", "0", "1"}
The three axis vectors determining the size and rotation for 3D points with pointtype set to block or ellipsoid. Specify them using the setIndex method.
widthexpr
String
1
Width expression, if pointtype is rectangle or ellipse.
Attributes
Deform, Filter (Plot Attribute), Selection (Dataset Attribute), Transformation, Transparency (3D only)
See Also
PointData