pointplot - Maple Help

Online Help

All Products    Maple    MapleSim


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

plots

  

pointplot

  

create a 2-D point plot

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

pointplot(L, options)

pointplot(A, options)

pointplot(v1, v2, options)

Parameters

L

-

set or list of two-dimensional points

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 one of connect, symbol, useunits, or color

Description

• 

The pointplot function is used to create a two-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 and v2.

• 

The list can be either a list of points p, where p is a list or Vector containing two numbers, or a flat list with an even number of values.

• 

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 point. 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 y-coordinates respectively, can have any length, but both must have the same length.

• 

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.

• 

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

• 

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 plot/option help page for a list of available symbols.

• 

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

Examples

withplots:

pointplotMatrix0,1,1,1,3,0,4,3,datatype=float,axes=boxed

pointplot0,1,1,1,3,0,4,3,color=red,green,black,blue,axes=boxed

pointplotseqn,sinn10,n=0..30

pointsseqT2,T,T=0..40:

pointplotpoints

pointplotpoints,coords=polar,color=red

The following constructions are equivalent.

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

A1123354759

(1)

pointplotA,color=blue,symbol=diamond

v11,2,3,4,5

v112345

(2)

v21,3,5,7,9

v213579

(3)

pointplotv1,v2,color=blue,symbol=diamond

The default units for this input are meters and seconds.

v32Unitm,3Unitft,4Unitdm

v32m3ft4dm

(4)

v4200Units,2Unitmin,0.1Unith

v4200s2min0.1h

(5)

pointplotv3,v4

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

pointplotv3,v4,useunits=Unitft,Unitmin

If we are fine with meters on the horizontal axis but want minutes on the vertical axis, we can use this.

pointplotv3,v4,useunits=default,Unitmin

If we try to specify the horizontal axis as kilograms and the vertical axis as newtons, an error is issued.

pointplotv3,v4,useunits=Unitkg,UnitN

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

It is also possible to add annotations to point plots.

plots:-pointplotMatrix26,2,rand1.0..10.,symbol=soliddiamond,symbolsize=20,colorscheme=ygradient,Yellow,Red,annotations=Arrayseqa..z

See Also

Matrix

plot

plot/color

plot/option

plots[pointplot3d]

Statistics[PointPlot]

Vector