plot_centres: Plot centres

In aspace: Functions for Estimating Centrographic Statistics

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", ...)

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.

Details

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

Value

This function returns a plot in the graphics device.

Author(s)

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

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)

aspace documentation built on May 29, 2024, 2:04 a.m.