observation | R Documentation |

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

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" )

`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) |

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.

## 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)

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.