aspace (version 4.0.1)

plot_sdd: Plot the Standard Distance Deviation (Standard Distance)

Description

This function plots the SDD as a circle with radius (standard distance), centred on a mean/weighted-mean/user-defined centre of a set of point observations.

Usage

plot_sdd(datin=NULL, plotnew=TRUE, plothv=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)", sdd.col='black', sdd.lwd=2, jpeg=FALSE, ...)

Value

This function returns a plot in the graphics device.

Arguments

datin

Input data object; the result from calc_sdd()

plotnew

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

plothv

Boolean: Set to TRUE if the orthogonal N-S, E-W axes are to be plotted through the centre

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

sdd.col

Specify a line colour for the SDD circle

sdd.lwd

Specify a line width for the SDD circle

jpeg

Boolean: Set to TRUE if the plot should be saved in JPEG format

...

Arguments to be passed to graphical parameters

Author

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

Details

The element FORPLOTTING containe 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.

See Also

plot_sde, plot_box

Examples

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

# plot_sdd() BY DEFAULT, TAKES AS INPUT THE RESULT PRODUCED BY calc_sdd()