ads (version 1.4)

plot.vads: Plot local density values

Description

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

Usage

## S3 method for class 'vads':
plot(x, main, opt, select, chars, cols, maxsize, char0, col0, legend, csize, \dots)

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 coulour 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 coulour 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/o

Value

• none.

encoding

latin1

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:

• ifclass(x)=c("vads","dval"), the plotted values are first-order local densities and argumentopt="dval"by default, but is potentially one ofc("dval","cval")returned bydval.
• ifclass(x)=c("vads","kval")orclass(x)=c("vads","k12val"), the plotted values are univariate or bivariate second-order local neighbour densities. Argumentopt="lval"by default, but is potentially one ofc("lval","kval","nval","gval")returned bykvalandk12val.

See Also

dval, kval, k12val.

Examples

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