aspace (version 4.1.1)

plot_centres: Plot centres

Description

This function plots various centre of a set of point observations.

Usage

plot_centres(datin=NULL, plotnew=FALSE, plotSDE=FALSE,
xaxis="Easting (m)", yaxis="Northing (m)", plotweightedpts=FALSE,
weightedpts.col='black', weightedpts.pch=19, plotpoints=TRUE,
points.col='black', points.pch=1, plotcentre=FALSE, centre.col='black',
centre.pch=19, plotcentral=FALSE, central.col='green', central.pch=19, 
plotCF2PTS=FALSE, CF2PTS.col='orange', CF2PTS.pch=19, plotmedian=FALSE, 
median.col='blue', median.pch=17, plotCMD=FALSE, CMD.col='red',
CMD.pch=17, TITLE="Title", ...)

Value

This function returns a plot in the graphics device.

Arguments

datin

List object of all calc_ function objects that you wish to plot.

plotnew

Boolean: Set to TRUE to create a new plot. Set to FALSE to overlay current plot.

plotSDE

Boolean: Set to TRUE if the centres for the SDE are to be plotted.

xaxis

A string to label the x-axis of the plot.

yaxis

A string to label the y-axis of the plot.

plotweightedpts

Boolean: Set to TRUE if the weighted point observations are to be plotted.

weightedpts.col

Specify a colour for the weighted point observations.

weightedpts.pch

Specify a plotting symbol for the weighted point observations.

plotpoints

Boolean: Set to TRUE if the point observations are to be plotted.

points.col

Specify a colour for the point observations.

points.pch

Specify a plotting symbol for the point observations.

plotcentre

Boolean: Set to TRUE if the mean/weighted/user-defined centre is to be plotted.

centre.col

Specify a colour for the centre.

centre.pch

Specify a plotting symbol for the centre.

plotcentral

Boolean: Set to TRUE if the central feature is to be highlighted

central.col

Specify a colour for the central feature.

central.pch

Specify a plotting symbol for the central feature.

plotCF2PTS

Boolean: Set to TRUE if the central feature between 2 point patterns is to be highlighted.

CF2PTS.col

Specify a colour for the central feature.

CF2PTS.pch

Specify a plotting symbol for the central feature.

plotmedian

Boolean: Set to TRUE if the median centre is to be plotted.

median.col

Specify a colour for the median centre.

median.pch

Specify a plotting symbol for the median centre.

plotCMD

Boolean: Set to TRUE if the centre of minimum distance is to be plotted.

CMD.col

Specify a colour for the centre of minimum distance.

CMD.pch

Specify a plotting symbol for the centre of minimum distance.

TITLE

A character string with the title for your plot.

...

Arguments to be passed to graphical parameters.

Author

Tarmo K. Remmel, Randy Bui, Ron N. Buliung

Details

The element FORPLOTTING contained within any of the calc function output lists is required as an argument for datin.

See Also

plot_box, plot_sdd, plot_sde

Examples

# MNC (BLACK CIRCLE)
a <- calc_mnc(points=activities)

# MDC (BLUE TRIANGLE)
b <- calc_mdc(points=activities)

# CF (GREEN CIRCLE)
d <- calc_cf(points=activities)

# CMD (RED TRIANGLE)
e <- calc_cmd(points=activities)

# CF2PTS (ORANGE CIRCLE)
f <- calc_cf2pts(points1=activities, points2=activities2)

# BUILD LIST OF OBJECTS TO PASS AS THE datin ARGUMENT
robjects <- list(a,b,d,e,f)
# CALL THE PLOT FUNCTION
plot_centres(datin=robjects, plotnew=TRUE, plotcentre=TRUE, plotmedian=TRUE)

# A FULL CALL COULD LOOK LIKE THE FOLLOWING
plot_centres(datin=robjects, plotnew=TRUE, plotcentre=TRUE,
plotmedian=TRUE, plotcentral=TRUE, plotCMD=TRUE, plotCF2PTS=TRUE)