observation: Observation model

In GMSE: Generalised Management Strategy Evaluation Simulator

Observation model

Description

A simulation of techniques (e.g., capture-mark-recapture) for estimating population size and poperties.

Usage

observation(
  RESOURCES = NULL,
  LAND = NULL,
  PARAS = NULL,
  AGENTS = NULL,
  inter_tabl = NULL,
  fixed_mark = 100,
  times_observe = 1,
  res_min_age = 0,
  agent_type = 0,
  type_cat = 1,
  observe_type = 0,
  res_move_obs = FALSE,
  model = "IBM"
)

Arguments

RESOURCES	The resources array produced by the resource function within GMSE
LAND	The landscape array on which interactions between resources and agents occur
PARAS	The vector of parameters that hold global and dynamic parameter values used by GMSE
AGENTS	The array of agents produced in the main gmse() function
inter_tabl	Interaction table indexing types with the INTERACT matrix
fixed_mark	Fixed number of individuals marked? (A number, or FALSE)
times_observe	Number of times that the observations are made (e.g., managers go out sampling n times in an area of the landscape)
res_min_age	Minimum age of the resource being sampled (default = 1)
agent_type	The type of agent doing the observing (default = 0)
type_cat	The category of agent type (first 4 columns) doing observing; this will almost always be 1, so type 0 agents (managers, of which there is always one by default) will perform the observations
observe_type	The type of method used to do the observing. For types of observation exist: (1) Density based observation, where observers count all of the resources within a subset of the landscape (the manager function can then later estimate total resource number from this estimate). (2) Mark-recapture based observation, where observers tag a fixed number of randomly sampled resources on the landscape some number of ‘times'; some of these resources marks are later interpreted as marks (’fixed_mark') while the rest are interpreted as recaptures. (3) Transect based observation, where observers sample a linear transect, observing all resources on the transect one row of landscape cells at a time, until all landscape cells are sampled; between samples, resources might move generating observation error. (4) Block based sampling, which is very similar to Transect based sampling; here observers instead sample square blocks of a landscape, counting resources one block at a time, until the whole landscape is sampled; between samples resources might move generating observation error.
res_move_obs	Defines whether or not resources move during observation (default = FALSE). Note that if this is FALSE, then observation methods (observe_type) 3 and 4 produce no observation error
model	The type of model being applied (Currently only individual-based – i.e., 'agent-based' – models are allowed)

Value

The observation function outputs an R list that includes three separate arrays, including (1) an new OBSERVATION array that holds observed resources and their traits with additional columns indicating when the resources were observed (relevant, e.g., for mark-recapture), (2) a new AGENTS array, and (3) a new PARAS array, each of which might be affected by the user function. The new arrays can then be read back into the broader GMSE function, thereby affecting the input into the management, user, and resource models.

Examples

## Not run: 
OBSERVATION_NEW <- observation(RESOURCES = RESOURCES, LAND = LANDSCAPE_r,
PARAS = paras, AGENTS = AGENTS, inter_tabl = interaction_tabl, fixed_mark = fxo,
times_observe = tmo, res_min_age = rma, agent_type = 0, type_cat   = 1, observe_type = obt,
res_move_obs   = rmo);

## End(Not run)

GMSE documentation built on June 16, 2022, 9:05 a.m.