plotSurveySumm {DIGSS}

Plot Survey Summaries

Description

Plots the different results from surveySim()

Usage

plotSurveySumm(summaryList, plot = "sites.found", labels = NULL)

Arguments

summaryList

a list of survey summaries, the output of surveySim()

plot

what variable to plot. Options are:

• sites.found - plots frequency of sites found

• survey.hits - plots frequency of surveys that hit a site

• success.rate.index - plots the success rate of surveys, i.e. the ratio of successful surveys over total surveys

• sites.found.arti - plots frequency of sites found based on artifacts present in sites

• survey.hits.arti - plots frequency of surveys that found at least one artifact

labels

vector with name of each item in list, to be added to the legend. If NULL, names will be taken from list

Details

This function will plot the results of the surveySim() simulations using Kernel Density plots. All the grids that are to be compared should be grouped into 1 list (list(a,b,c,etc...)) The plot function allows you to choose different parts of the survey summaries produced by surveySim() you want to plot.

Examples

 
 #create 3 Simulations with sites of different sizes:
 small.sites<-parametersExample
 small.sites$site.area=500

 medium.sites<-parametersExample
 medium.sites$site.area=1000

 large.sites<-parametersExample
 large.sites$site.area=2000

 #run the 3 simulations
 small.survey<-surveySim(small.sites)
 medium.survey<-surveySim(medium.sites)
 large.survey<-surveySim(large.sites)

 #create the comparative plot.
 #note that the results go into a list. If labels are not given, legend is built on list names
 plotSurveySumm(
       list(small.survey,medium.survey,large.survey),
       plot="sites.found",
       labels=c("Small sites","Medium sites","Large sites"))