pointplot3d - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : 3-D : plots/pointplot3d

plots

  

pointplot3d

  

create a 3-D point plot

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

pointplot3d(L, options)

pointplot3d(A, options)

pointplot3d(v1, v2, v3, options)

Parameters

L

-

set or list of three-dimensional points

A

-

n by 3 Matrix where n is any positive integer

v1, v2, v3

-

Vectors, all of the same length

options

-

(optional) equations of the form option=value where option is any of the available plot3d options, or one of connect, symbol, useunits, or color

Description

• 

The pointplot3d function is used to create a three-dimensional plot of points. The points that are to be plotted come from the set or list L, the Matrix A, or the Vectors v1, v2, and v3.

• 

The list can be either a list of points p, where p is a list or Vector containing three numbers, or a flat list whose length is a multiple of three.

• 

The Matrix must be n by 3, where n is any positive integer. Each row of the Matrix contains the x-, y- and z-coordinates of a point. If a 3 by n Matrix is given, with n not equal to 3, then it will be automatically transposed. The Vectors, representing the x-coordinates, y-coordinates and z-coordinates respectively, can have any length, but all three must have the same length.

• 

If you have a large number of points, it is recommended that the data be provided as a Matrix with datatype set to float.

• 

A common error is to provide a sequence of points without putting them in a list. Note that pointplot3d([1,2,3], [4,5,6], [7,8,9]) is interpreted as the points (1,4,7), (2,5,8) and (3,6,9), and not as the points (1,2,3), (4,5,6) and (7,8,9).

• 

The option connect=true specifies that the points are to be connected by line segments.  In this case, L should be a list to ensure a consistent ordering of the points. The value of this option is assumed to be true if the style=line or style=pointline option is provided.

• 

The option symbol=s specifies the symbol used in the display.  See the symbol entry in the plot3d/option help page for a list of available symbols.

• 

The option useunits=[ux, uy, uz] specifies the units to be used on the x-, y-, and z-axis, respectively. Units can be used with all of the calling sequences listed above. By default, Maple picks a suitable unit of a dimension appropriate for the data. It is typically the units given for the first point. All data are converted to this unit and the unit is used as the label for the axis, unless labels are specified using the labels option. (See plot3d/options for the labels option.) If you want to specify the unit for some but not all of the three axes and let Maple pick the others, you can specify the ones you don't want to choose as "default" or default. If not all values given for a particular coordinate axis can be converted to the appropriate unit (specified or default), Maple issues an error.

• 

The option color=s specifies the color of the points. The allowable values for s are given in the plot/color help page. A list or Vector of n colors, where n is the number of points, can also be provided.

• 

Remaining arguments are interpreted as options which are specified as equations of the form option = value. These options are the same as those available for the plot3d command, as described in plot3d/options.

Examples

withplots:

pointplot3d0,1,1,1,1,2,3,0,5,axes=normal,symbol=box

pointplot3d0,1,1,1,1,2,3,0,5,color=red,green,blue,axes=normal,symbol=box

pointsseqcosπT40,sinπT40,T40,T=0..40:

pointplot3dpoints

The following constructions are equivalent.

A1,2,3,4,5|1,3,5,7,9|0,1,0,1,0.5

A110231350471590.5

(1)

pointplot3dA,color=magenta,axes=normal,symbol=cross

v11,2,3,4,5

v112345

(2)

v21,3,5,7,9

v213579

(3)

v30,1,0,1,0.5

v301010.5

(4)

pointplot3dv1,v2,v3,color=magenta,axes=normal,symbol=cross

The default units for this input are meters, seconds, and kilograms.

v42Unitm,3Unitft,4Unitdm

v42m3ft4dm

(5)

v5200Units,2Unitmin,0.1Unith

v5200s2min0.1h

(6)

v60.1Unitkg,8Unitoz,0.8Unitlb

v60.1kg8oz0.8lb

(7)

pointplot3dv4,v5,v6

If we want to display the points in feet, minutes, and ounces, we can specify that as follows.

pointplot3dv4,v5,v6,useunits=Unitft,Unitmin,Unitoz

If we are fine with meters on the x-axis and kilograms on the z-axis, but want minutes on the y-axis, we can use this.

pointplot3dv4,v5,v6,useunits=default,Unitmin,default

If we try to specify the x-axis as kilograms and the y-axis as newtons, an error is issued.

pointplot3dv4,v5,v6,useunits=Unitkg,UnitN,default

Error, (in plots:-pointplot3d) unable to convert `m` to `kg`

The commands to create the plot from the Plotting Guide are

pointsseqcosπT10,sinπT10,T10,T=0..40:

pointplot3dpoints,color=red

See Also

Matrix

plot/color

plot3d

plot3d/option

plots[pointplot]

Vector