ads (version 1.5-5)

plot.vads: Plot local density values

Description

Plot local density estimates returned by functions dval, kval or k12val.

Usage

# S3 method for vads
plot(x, main, opt, select, chars, cols, maxsize, char0, col0, legend, csize, …)

Arguments

x

an object of class 'vads' (see Details).

main

by default, the value of argument x, otherwise a text to be displayed as a title of the plot. main=NULL displays no title.

opt

(optional) a character string to change the type of values to be plotted (see Details).

select

(optional) a vector of selected distances in x$r. By default, a multiple window displays all distances.

chars

one of c("circles","squares") plotting symbols with areas proportional to local density values. By default, circles are plotted.

cols

(optional) the colour used for the plotting symbols. Black colour is the default.

maxsize

(optional) maximum size of the circles/squares plotted. By default, maxsize is automatically adjusted to plot size.

char0

(optional) the plotting symbol used to represent null values. By default, null values are not plotted.

col0

(optional) the colour used for the null values plotting symbol. By default, the same as argument cols.

legend

If legend = TRUE (the default) a legend for the plotting values is displayed.

csize

scaling factor for font size so that actual font size is par("cex")*csize. By default csize = 1.

…

extra arguments that will be passed to the plotting functions plot.swin, plot.default, symbols and/or points.

Value

none.

Details

Function plot.vads displays a map of first-order local density or second-order local neighbour density values as symbols with areas proportional to the values estimated at the plotted points. Positive values are represented by coloured symbols, while negative values are represented by open symbols. The plotted function values depend upon the type of 'vads' object:

• if class(x)=c("vads","dval"), the plotted values are first-order local densities and argument opt="dval" by default, but is potentially one of c("dval","cval") returned by dval.

• if class(x)=c("vads","kval") or class(x)=c("vads","k12val"), the plotted values are univariate or bivariate second-order local neighbour densities. Argument opt="lval" by default, but is potentially one of c("lval","kval","nval","gval") returned by kval and k12val.

See Also

dval, kval, k12val.

Examples

# NOT RUN {
  data(BPoirier)
  BP <- BPoirier
  
# }
# NOT RUN {
local density in a rectangle sampling window
# }
# NOT RUN {
  dswr <- dval(spp(BP$trees, win=BP$rect), 25, 1, 11, 9)
  plot(dswr)
  
# }
# NOT RUN {
display only distance r from 5 to 10 with null symbols as red crosses
# }
# NOT RUN {
  plot(dswr, select=c(5:10), char0=3, col0="red")
  
  
# }
# NOT RUN {
local L(r) values in a circular sampling window
# }
# NOT RUN {
  lvswc <- kval(spp(BP$trees, win=c(55,45,45)), 25, 0.5)
  plot(lvswc)
  
# }
# NOT RUN {
display square symbols in blue for selected values of r and remove title
# }
# NOT RUN {
  plot(lvswc, chars="squares", cols="blue", select=c(5,7.5,10,12.5,15), main=NULL)
  
  
# }
# NOT RUN {
local K12(r) values (1="beech", 2="oak") in a complex sampling window
# }
# NOT RUN {
  k12swrt <- k12val(spp(BP$trees, win=BP$rect, tri=BP$tri1, marks=BP$species), 25, 1)
  plot(k12swrt, opt="kval")
# }