anecdotal: Anecdotal model

In GMSE: Generalised Management Strategy Evaluation Simulator

Anecdotal model

Description

A simulation of how many resources of a particular type are in the vicinity of each agent – this produces a kind of anecdotal evidence for each agent around their circle of view. It also potentially moves the agents during a time step.

Usage

anecdotal(
  RESOURCES = NULL,
  LAND = NULL,
  PARAS = NULL,
  AGENTS = NULL,
  res_type = 1,
  samp_age = 1,
  agent_type = 0,
  type_cat = 1,
  move_agents = 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
res_type	The type of resources being observed (default = 1)
samp_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 be affected
move_agents	Whether or not agents are moved during the run of anecodtal
model	The type of model being applied (Currently only individual-based – i.e., 'agent-based' – models are allowed)

Value

The anecdotal function outputs an R list that includes two separate arrays, including (1) a new AGENTS array and (3) a new PARAS array, each of which might be affected by the anecdotal function. The new arrays can then be read back into the broader GMSE function, thereby affecting the input into the management, user, resource, and observation models.

Examples

## Not run: 
AGENTS_NEW <- anecdotal(RESOURCES = RESOURCES, LAND = LANDSCAPE_r, 
PARAS = paras, AGENTS = AGENTS, res_type = 1, samp_age = rma, agent_type = -1,
type_cat = 1, move_agents = mva);

## End(Not run)

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