surveyLoops {DIGSS}  R Documentation 
Perform multiple survey simulations changing values on one variable and plot the results
surveyLoops(surveyParameters, loopVariable, loopSequence, plotResult)
surveyParameters 
list of parameters (object class 
loopVariable 
variable to be looped. Can be any of the variables that exist in

loopSequence 
object with varying values, as defined above 
plotResult 
which results from the summary table will be plotted:

surveyLoops()
will run a series of simulations along one variable with values
provided by user. Through this function, the user can simulate and evaluate the changes
in efficiency and efficacy of specific variables, while holding every other value constant. The function
runs multiple instances of surveySim()
using values of surveyParameters
and replacing one of them with a sequence of values offered by the user.
A list with five objects:
surveysPerSim  A matrix with the number of survey pits done in each simulation. 
sitesFound  A matrix with the summary statistics about frequency of sites found in each simulation. 
sitesFoundOnArtifacts  A matrix with the summary statistics about frequency of sites detected based on artifacts found in survey pits in each simulation. 
artifactsPerSurver  A matrix with the summary statistics about artifacts found per survey pit in each simulation. 
succesRateIndex  A matrix with the summary statistics about success rate (number of succesful survey pits/total survey pits) in each simulation. 
#Loop the impact of increasing distances between survey rows
width.loop<surveyLoops(parametersExample,"col.width",c(50,75,100,125,150),"sitesFound")
#Loop the impact of different artifact distributions on surveys
distr.loop<surveyLoops(
parametersExample,
"obj.distribution",
c("uniform","linear","spherical","sinusoidal"),
"sitesFoundOnArtifacts")