PointData
Create a point data plot.
Syntax
model.result(<pgtag>).create(<ftag>,"PointData");
model.result(<pgtag>).feature(<ftag>).set(property, <value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"PointData") creates a point data plot feature named <ftag> belonging to the 2D or 3D plot group <pgtag>.
Point data plots are used to visualize raw point data given as points and colors (see the example below). Point data plots can be added to 2D and 3D plot groups.
The following properties are available:
Table 7-82: Valid Property/Value Pairs for Point Data Plots
name
Value
Default
Description
color
custom | black | blue | cyan | gray | green |magenta | red | white | yellow
red
The uniform color to use. Active when coloring is uniform.
colordata
double 1D array
 
The color data for the point data plot as a real N-vector.
coloring
colortable | uniform
uniform
How to color the points.
colorlegend
on | off
on
Whether to show color legend when coloring is set to colortable.
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.
colortablerev
on | off
off
Whether to reverse to color table when coloring is set to colortable
colortablesym
on | off
off
Whether to symmetrize the color range around 0 when coloring is set to colortable.
description
String
 
A label showing a short description of the stored data.
pointdata
double 2D array
 
The point data for the point data plot, as x and y coordinates in 2D and x, y, and z coordinates in 3D in an sdim-by-N real matrix.
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.
sphereradiusscale
positive double
1
The scale factor applied to the point radii.
title
String
The auto-title.
The title to use when titletype is manual.
titletype
auto | manual | none
none
auto if the title contribution should be computed automatically. manual if the manual title contribution should be used (the title property). none if no title contribution should be used.
Attributes
None.
Example
A method for creating a circle of points in 2D.
Code for Use with Java
pg = m.result().create("pg5", 2);
plot = pg.create("pt1", "PointData");
N = 17;
p = new double[2][N];
color = new double[N];
double R = 1000;
for (int i = 0; i < N; i++) {
double angle = i * 2 * Math.PI / N;
p[0][i] = R * Math.cos(angle);
p[1][i] = R * Math.sin(angle);
color[i] = p[1][i];
}
plot.set("pointdata", p)
.set("colordata", color)
.set("coloring", "colortable");
plot.run();
See Also
AnnotationData, ArrowData, LineData, SurfaceData, TubeData