State probability object

An object of class stateprobs returned by sim_stateprobs() or from $sim_stateprobs() methods in model classes.

Components

A stateprobs object inherits from data.table and contains the following columns:

sample

A random sample from the PSA.

strategy_id

The treatment strategy ID.

patient_id

The patient ID.

grp_id

The subgroup ID.

state_id

The health state ID.

t

The time at which a state probability is computed.

prob

The probability of being in a given health state.

When simulating individual-level models, the patient_id column is not included as state probabilities are computed by averaging across patients.

In cohort models, the object also contains size and absorbing attributes. The size attribute is a numeric vector with the elements n_samples, n_strategies, n_patients, n_states, and n_times denoting the number of samples, treatment strategies, patients, health states, and times. The absorbing attribute is a numeric vector containing the absorbing health states (see the absorbing field of the CohortDtstmTrans class for more details).