 pointplot3d - Maple Help

Home : Support : Online Help : Graphics : 3-D : 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, 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

 > $\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{\pi }T}{40}\right),\mathrm{sin}\left(\frac{\mathrm{\pi }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}{c}{1}\\ {2}\\ {3}\\ {4}\\ {5}\end{array}\right]$ (2)
 > $\mathrm{v2}≔⟨1,3,5,7,9⟩$
 ${\mathrm{v2}}{≔}\left[\begin{array}{c}{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 default units for this input are meters, seconds, and kilograms.

 > $\mathrm{v4}≔⟨2\mathrm{Unit}\left(m\right),3\mathrm{Unit}\left(\mathrm{ft}\right),4\mathrm{Unit}\left(\mathrm{dm}\right)⟩$
 ${\mathrm{v4}}{≔}\left[\begin{array}{c}{2}{}⟦{m}⟧\\ {3}{}⟦{\mathrm{ft}}⟧\\ {4}{}⟦{\mathrm{dm}}⟧\end{array}\right]$ (5)
 > $\mathrm{v5}≔⟨200\mathrm{Unit}\left(s\right),2\mathrm{Unit}\left(\mathrm{min}\right),0.1\mathrm{Unit}\left(h\right)⟩$
 ${\mathrm{v5}}{≔}\left[\begin{array}{c}{200}{}⟦{s}⟧\\ {2}{}⟦{\mathrm{min}}⟧\\ {0.1}{}⟦{h}⟧\end{array}\right]$ (6)
 > $\mathrm{v6}≔⟨0.1\mathrm{Unit}\left(\mathrm{kg}\right),8\mathrm{Unit}\left(\mathrm{oz}\right),0.8\mathrm{Unit}\left(\mathrm{lb}\right)⟩$
 ${\mathrm{v6}}{≔}\left[\begin{array}{c}{0.1}{}⟦{\mathrm{kg}}⟧\\ {8}{}⟦{\mathrm{oz}}⟧\\ {0.8}{}⟦{\mathrm{lb}}⟧\end{array}\right]$ (7)
 > $\mathrm{pointplot3d}\left(\mathrm{v4},\mathrm{v5},\mathrm{v6}\right)$ If we want to display the points in feet, minutes, and ounces, we can specify that as follows.

 > $\mathrm{pointplot3d}\left(\mathrm{v4},\mathrm{v5},\mathrm{v6},\mathrm{useunits}=\left[\mathrm{Unit}\left(\mathrm{ft}\right),\mathrm{Unit}\left(\mathrm{min}\right),\mathrm{Unit}\left(\mathrm{oz}\right)\right]\right)$ 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.

 > $\mathrm{pointplot3d}\left(\mathrm{v4},\mathrm{v5},\mathrm{v6},\mathrm{useunits}=\left["default",\mathrm{Unit}\left(\mathrm{min}\right),"default"\right]\right)$ If we try to specify the x-axis as kilograms and the y-axis as newtons, an error is issued.

 > $\mathrm{pointplot3d}\left(\mathrm{v4},\mathrm{v5},\mathrm{v6},\mathrm{useunits}=\left[\mathrm{Unit}\left(\mathrm{kg}\right),\mathrm{Unit}\left(N\right),"default"\right]\right)$

The commands to create the plot from the Plotting Guide are

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