GMSE (version 1.0.0.2)

user: User model

Description

A model of user decisions for a single time step. These decisions result in stakeholder actions that can potentially affect resources and the landscape in a GMSE simulation.

Usage

user(
  RESOURCES = NULL,
  AGENTS = NULL,
  LAND = NULL,
  PARAS = NULL,
  COST = NULL,
  ACTION = NULL,
  INTERACT = NULL,
  inter_tabl = NULL,
  model = "IBM"
)

Arguments

RESOURCES

The resources array produced by the resource function within GMSE

AGENTS

The array of agents produced in the main gmse() function

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

COST

A three dimensional array of cost values for agent (manager and stakeholder) actions

ACTION

ACTION A three dimensional array of agent (manager and stakeholder) actions

INTERACT

An interaction (Jacobian) matrix of resources & landscape layer effects

inter_tabl

Interaction table indexing types with the INTERACT matrix

model

The type of model being applied (Currently only individual-based -- i.e., 'agent-based' -- models are allowed)

Value

The user function outputs an R list that includes five separate arrays, including (1) an new RESOURCES array, (2) a new AGENTS array, (3) a new LAND array, (4) a new ACTIONS array, and a new (5) COST 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 resource, observation, and management models.

Examples

# NOT RUN {
USERS <- user(RESOURCES = RESOURCES, AGENTS = AGENTS, LAND = LANDSCAPE_r,
PARAS = paras, COST = COST, ACTION = ACTION, INTERACT = Jacobian, 
inter_tabl = interaction_tabl, model = "IBM");
# }