polygonplot3d - Maple Help

Online Help

All Products    Maple    MapleSim


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

plots

  

polygonplot3d

  

create a plot of one or more polygons

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

polygonplot3d(L, options)

polygonplot3d(A, options)

polygonplot3d(v1, v2, v3, options)

Parameters

L

-

list of polygon vertices, each given as a 3-element list

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 3d plot options, or useunits

Description

• 

The polygonplot3d command is used to create a 3-D plot of a polygon. The polygon's vertices are provided as the list L, the Matrix A, or the Vectors v1 and v2.

• 

The list L must contain 3-element lists or Vectors [x, y, z], each representing the numeric x-, y- and z-coordinates of a vertex, optionally with units.

• 

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 vertex, optionally with units. 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, again optionally with units, can have any length, but all must have the same length.

• 

The option useunits=[ux, uy, uz] specifies the units to be used on the x-, y-, and z-axis, respectively. 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.

• 

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.

• 

Multiple polygons can be plotted by providing a list containing polygons in the list or Matrix form, as described above. In this case, the color option value can be a list of n colors, where n is the number of polygons.

Examples

withplots:

polygonplot3dMatrix0,1,1,1,1,2,3,0,5,1,1,1,datatype=float,color=Indigo,axes=boxed

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

polygonplot3danother_poly

list_polysseqseqT10,S20,sinTS20,T=0..20,S=1..4:

polygonplot3dlist_polys,color=Blue,Purple,HotPink,Pink

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

v42Unitm,3Unitft,4Unitdm

v42m3ft4dm

(1)

v5200Units,2Unitmin,0.1Unith

v5200s2min0.1h

(2)

v60.1Unitkg,8Unitoz,0.8Unitlb

v60.1kg8oz0.8lb

(3)

polygonplot3dv4,v5,v6

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

polygonplot3dv4,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.

polygonplot3dv4,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.

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

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

See Also

Matrix

plot/color

plot3d

plot3d/option

plots/polygonplot