tpm: Build the transition probability matrix from unconstrained parameter vector
Description
Markov chains are parametrised in terms of a transition probability matrix \(\Gamma\), for which each row contains a conditional probability distribution of the next state given the current state.
Hence, each row has entries between 0 and 1 that need to sum to one.
For numerical optimisation, we parametrise in terms of unconstrained parameters, thus this function computes said matrix from an unconstrained parameter vector via the inverse multinomial logistic link (also known as softmax) applied to each row.
Usage
tpm(param, byrow = FALSE)
Value
Transition probability matrix of dimension c(N,N)
Arguments
param
unconstrained parameter vector of length N*(N-1) where N is the number of states of the Markov chain
byrow
logical indicating if the transition probability matrix should be filled by row
Defaults to FALSE, but should be set to TRUE if one wants to work with a matrix of beta parameters returned by popular HMM packages like moveHMM, momentuHMM, or hmmTMB.
See Also
Other transition probability matrix functions:
generator(),
tpm_cont(),
tpm_emb(),
tpm_emb_g(),
tpm_g(),
tpm_p()