polygonplot - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : 2-D : plots/polygonplot

plots

  

polygonplot

  

create a plot of one or more polygons

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

polygonplot(L, options)

polygonplot(A, options)

polygonplot(v1, v2, options)

Parameters

L

-

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

A

-

n by 2 Matrix, where n is any positive integer

v1, v2

-

Vectors of the same length

options

-

(optional) equations of the form option=value, where option is any of the available plot options, or useunits

Description

• 

The polygonplot command is used to create a 2-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 2-element lists or Vectors [x, y], each representing the numeric x- and y-coordinates of a vertex, optionally with units.

• 

The Matrix must be n by 2, where n is any positive integer. Each row of the Matrix contains the x- and y-coordinates of a vertex, optionally with units. If a 2 by n Matrix is given, with n not equal to 2, then it will be automatically transposed. The Vectors, representing the x-coordinates and the y-coordinates of the vertices respectively, again optionally with units, can have any length, but both must have the same length.

• 

The option useunits=[ux, uy] specifies the units to be used on the horizontal and vertical 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 plot/options for the labels option.) If you want to specify the unit for one of the axes and let Maple pick the other, you can specify the one 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.

• 

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

• 

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 plot command, as described in plot 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:

ngonnseqcos2πin,sin2πin,i=1..n:

displaypolygonplotngon8,color=blue,textplot0,0,Octagon,axes=none

one_polyMatrix0,0,0,1,0.5,0.5,1,1,1,0.05,0.95,0.05,0.95,0,datatype=float:

polygonplotone_poly,axes=boxed,colour=Magenta,transparency=0.7,gridlines

The command to create the plot from the Plotting Guide is

poly0,1,0,2,0.5,2.75,1.25,3,2,2.75,2.5,2.25,1.75,1.5,2.5,0.75,2,0.25,1.25,0,0.5,0.25

poly0,1,0,2,0.5,2.75,1.25,3,2,2.75,2.5,2.25,1.75,1.5,2.5,0.75,2,0.25,1.25,0,0.5,0.25

(1)

polygonplotpoly,axes=boxed,color=DarkGreen,transparency=0.5

The style option controls how the polygon is drawn.  In the next example, the same polygon is drawn without the border.

polygonplotpoly,axes=boxed,color=DarkGreen,transparency=0.5,style=polygon

This example shows how you can use the useunits option. For investigating a refrigeration cycle, it can be useful to draw a quadrangle on a P-h-T chart. (See this analysis for more background.) The coordinates of this quadrangle would normally result from a command, so they may not be in the same units as the P-h-T chart.

point_data386461.5358UnitJkg,131876.9284UnitPa,451844.2441UnitJkg,1000000UnitPa,241499.5190UnitJkg,1000000UnitPa,241499.5190UnitJkg,131876.9284UnitPa:

pht_chartThermophysicalData:-PHTChartR134a,100UnitkPa..4100UnitkPa

quadranglepolygonplotpoint_data,color=DarkRed,thickness=5,style=line,useunits=kJkg,kPa

displaypht_chart,quadrangle

See Also

Matrix

plot

plot/color

plot/option

plot/style

plots/polygonplot3d

plots/polyhedraplot