case23plot: Plot results for transect-based sampling

In GMSE: Generalised Management Strategy Evaluation Simulator

Plot results for transect-based sampling

Description

Produce six panels on a plot showing resource distribution, owned land, resource dynamics and estimates, stake-holder yield, and action costs and actions made. This plot is run internally within the gmse function, and should not be used to plot results stored after running the gmse function (for this, use plot_gmse_results).

Usage

case23plot(res, obs, land1, land2, land3, agents, paras, COST, ACTION)

Arguments

res	The resources array produced by the resource function within GMSE
obs	The array of resource observations from the observation model, used to estimate abundance of resources
land1	The first layer of the 3D landscape array, which indicates values of terrain for plotting (as of now, terrain values have no effect on the simulation and only exist for display purposes)
land2	The full list showing all layers of the landscape in each time step of GMSE
land3	The third layer of the 3D landscape array, which indicates agent ownership of the land
agents	The array of agents produced in the main gmse() function
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	A three dimensional array of agent (manager and stakeholder) actions

Value

This function plots the dynamics of GMSE resource, observation, managemer, and user models in six separate sub-panels. (1) Upper left panel: Shows the locations of resources on the landscape (black dots); landscape terrain is also shown in brown, but at the moment, this is only cosmetic and does not reflect anything occurring in the model. (2) Upper right panel: Shows ownership of land by agents; land is divided proportional based on parameters set in gmse() and colours correspond with other subplots. If agent utilities and actions are restricted to land ('land_ownership' in the gmse() function), then this gives some idea of where actions are being performed and where resources are affecting the landscape. (3) Middle left panel: Shows the actual population abundance (black solid line) and the population abundance estimated by the manager (blue solid line) over time. The dotted red line shows the resource carrying capacity (death-based) and the dotted blue line shows the target for resource abundance as set in the gmse() function; the orange line shows the total percent yield of the landscape (i.e., 100 percent means that resources have not decreased yield at all, 0 percent means that resources have completely destroyed all yield). (4) Middle right panel: Shows the raw landscape yield for each stakeholder (can be ignored if 'land_ownership' is FALSE) over time; colours correspond to land ownership shown in the upper right panel. (5) Lower left panel: The cost of stakeholders performing actions over time, as set by the manager. (6) Lower right panel: The total number of actions performed by all stakeholders over time.

Examples

## Not run: 
case23plot(res = RESOURCE_REC, obs = OBSERVATION_REC, 
land1 = LANDSCAPE_r[,,1], land2 = LANDSCAPE_REC, land3  = LANDSCAPE_r[,,3], 
agents = AGENT_REC, COST = COST_REC, ACTION = ACTION_REC, paras  = paras);

## End(Not run)

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