Simulate health state transitions in a cohort discrete time state transition model.
An R6::R6Class object.
params
Parameters for simulating health state transitions. Supports objects of class tparams_transprobs or params_mlogit.
input_data
An object of class input_mats.
cycle_length
The length of a model cycle in terms of years.
The default is 1
meaning that model cycles are 1 year long.
start_stateprobs
A non-negative vector with length equal to the number of
health states containing the probability that the cohort is in each health
state at the start of the simulation. For example,
if there were three states and the cohort began the simulation in state 1,
then start_stateprobs = c(1, 0, 0)
. Automatically normalized to sum to 1.
If NULL
, then a vector with the first element equal to 1 and
all remaining elements equal to 0.
trans_mat
A transition matrix describing the states and transitions
in a discrete-time multi-state model. Only required if the model is
parameterized using multinomial logistic regression. The (i,j)
element
represents a transition from state i
to state j
. Each possible transition
from row i
should be based on a separate multinomial logistic regression
and ordered from 0
to K - 1
where K
is the number of
possible transitions. Transitions that are not possible should be NA
.
and the reference category for each row should be 0
.
new()
Create a new CohortDtstmTrans
object.
CohortDtstmTrans$new( params, input_data = NULL, trans_mat = NULL, start_stateprobs = NULL, cycle_length = 1 )
params
The params
field.
input_data
The input_data
field.
trans_mat
The trans_mat
field.
start_stateprobs
The start_stateprobs
field.
cycle_length
The cycle_length
field.
A new CohortDtstmTrans
object.
sim_stateprobs()
Simulate probability of being in each health state during each model cycle.
CohortDtstmTrans$sim_stateprobs(n_cycles)
n_cycles
The number of model cycles to simulate the model for.
An object of class stateprobs.
clone()
The objects of this class are cloneable with this method.
CohortDtstmTrans$clone(deep = FALSE)
deep
Whether to make a deep clone.