transitionMatrix: Define a state transition matrix

In SiMRiv: Simulating Multistate Movements in River/Heterogeneous Landscapes

Define a state transition matrix

Description

Defines a state transition matrix to be used when creating species.

Usage

  transitionMatrix(...)

Arguments

...	the probabilities that will form the matrix, see Details. If none given, returns a 1-element matrix (for one state only)

Details

The transition matrix (Markov matrix) is a square, non-symmetric matrix with all elements between 0 and 1, and whose rows must sum to 1 (but not columns). It defines the probability of the individual changing from each behavioral state to another, and this is tested in each time step of the simulation, hence probabilities should be small.

This function is just a helper to create such matrix. The arguments are probabilities given in the following order (example for 3 states):

Probability of changing from:

state 1 –> state 2

state 1 –> state 3

state 2 –> state 1

state 2 –> state 3

state 3 –> state 1

state 3 –> state 2

The diagonal (probablity of remaining in the same state) is computed so that rows sum to 1.

Value

A numeric matrix.

See Also

species.

Examples

## a 3-state transition matrix

transitionMatrix(0.01,0.02,0,0.03,0.0001,0)

SiMRiv documentation built on Sept. 15, 2023, 5:07 p.m.