plots - Maple Programming Help

Home : Support : Online Help : Graphics : Packages : plots : plots/pointplot3d

plots

 pointplot3d
 create a 3-D point plot

 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, 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 may 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 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, may 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

 > $\mathrm{with}\left(\mathrm{plots}\right):$
 > $\mathrm{pointplot3d}\left(\left\{\left[0,1,1\right],\left[1,-1,2\right],\left[3,0,5\right]\right\},\mathrm{axes}=\mathrm{normal},\mathrm{symbol}=\mathrm{box}\right)$
 > $\mathrm{pointplot3d}\left(\left[\left[0,1,1\right],\left[1,-1,2\right],\left[3,0,5\right]\right],\mathrm{color}=\left[\mathrm{red},\mathrm{green},\mathrm{blue}\right],\mathrm{axes}=\mathrm{normal},\mathrm{symbol}=\mathrm{box}\right)$
 > $\mathrm{points}≔\left\{\mathrm{seq}\left(\left[\mathrm{cos}\left(\frac{\mathrm{π}T}{40}\right),\mathrm{sin}\left(\frac{\mathrm{π}T}{40}\right),\frac{T}{40}\right],T=0..40\right)\right\}:$
 > $\mathrm{pointplot3d}\left(\mathrm{points}\right)$

The following constructions are equivalent.

 > $A≔⟨⟨1,2,3,4,5⟩|⟨1,3,5,7,9⟩|⟨0,1,0,1,0.5⟩⟩$
 ${A}{≔}\left[\begin{array}{ccc}{1}& {1}& {0}\\ {2}& {3}& {1}\\ {3}& {5}& {0}\\ {4}& {7}& {1}\\ {5}& {9}& {0.5}\end{array}\right]$ (1)
 > $\mathrm{pointplot3d}\left(A,\mathrm{color}=\mathrm{magenta},\mathrm{axes}=\mathrm{normal},\mathrm{symbol}=\mathrm{cross}\right)$
 > $\mathrm{v1}≔⟨1,2,3,4,5⟩$
 ${\mathrm{v1}}{≔}\left[\begin{array}{r}{1}\\ {2}\\ {3}\\ {4}\\ {5}\end{array}\right]$ (2)
 > $\mathrm{v2}≔⟨1,3,5,7,9⟩$
 ${\mathrm{v2}}{≔}\left[\begin{array}{r}{1}\\ {3}\\ {5}\\ {7}\\ {9}\end{array}\right]$ (3)
 > $\mathrm{v3}≔⟨0,1,0,1,0.5⟩$
 ${\mathrm{v3}}{≔}\left[\begin{array}{c}{0}\\ {1}\\ {0}\\ {1}\\ {0.5}\end{array}\right]$ (4)
 > $\mathrm{pointplot3d}\left(\mathrm{v1},\mathrm{v2},\mathrm{v3},\mathrm{color}=\mathrm{magenta},\mathrm{axes}=\mathrm{normal},\mathrm{symbol}=\mathrm{cross}\right)$

The commands to create the plot from the Plotting Guide are

 > $\mathrm{points}≔\left\{\mathrm{seq}\left(\left[\mathrm{cos}\left(\frac{\mathrm{π}T}{10}\right),\mathrm{sin}\left(\frac{\mathrm{π}T}{10}\right),\frac{T}{10}\right],T=0..40\right)\right\}:$
 > $\mathrm{pointplot3d}\left(\mathrm{points},\mathrm{color}=\mathrm{red}\right)$