plot_sde: Plot the Standard Deviation Ellipse

In aspace: Functions for Estimating Centrographic Statistics

Plot the Standard Deviation Ellipse

Description

This function plots the SDE as an ellipse centred on the mean/weighted/user-defined centre of a set of point observations. The plot characterizes the dispersion of point observations along two orthogonal axes.

Usage

plot_sde(datin=NULL, plotnew=TRUE, plotSDEaxes=FALSE, plotweightedpts=FALSE,
weightedpts.col='black', weightedpts.pch=19, plotpoints=TRUE, 
points.col='black', points.pch=1, plotcentre=TRUE, centre.col='black', 
centre.pch=19, titletxt="Title", xaxis="Easting (m)", 
yaxis="Northing (m)", sde.col='black', sde.lwd=2, jpeg=FALSE, ...)

Arguments

datin	Input data object; the result from calc_sde()
plotnew	Boolean: Set to TRUE to create a new plot. Set to FALSE to overlay current plot.
plotSDEaxes	Boolean: Set to TRUE if the orthogonal axes through the centroid are to be plotted
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
titletxt	A string to indicate the title on the plot
xaxis	A string to label the x-axis of the plot
yaxis	A string to label the y-axis of the plot
sde.col	Specify a line colour for the SDE circle
sde.lwd	Specify a line width for the SDE circle
jpeg	Boolean: Set to TRUE if the plot should be saved in JPEG format
...	Arguments to be passed to graphical parameters

Details

The element FORPLOTTING contained within the calc_box() output object is required to plot an SD Box. Provide the whole plot_box() output object as the argment 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_sdd, plot_box

Examples

a <- calc_sde(points=activities)
plot_sde(datin=a, plotnew=TRUE, plotSDEaxes=FALSE, plotweightedpts=FALSE,
plotpoints=TRUE, plotcentre=TRUE, titletxt="Title", 
xaxis="Easting (m)", yaxis="Northing (m)")

# plot_sde() BY DEFAULT, TAKES AS INPUT THE RESULT PRODUCED BY calc_sde()

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