Simulate values (i.e., utility or costs) associated with health states in a state transition or partitioned survival model.

Public fields

params

Parameters for simulating state values. Currently supports objects of class tparams_mean or params_lm.

input_data

An object of class input_mats. Only used for params_lm objects.

method

The method used to simulate costs and quality-adjusted life-years (QALYs) as a function of state values. If wlos, then costs and QALYs are simulated by weighting state values by the length of stay in a health state. If starting, then state values represent a one-time value that occurs when a patient enters a health state. When starting is used in a cohort model, the state values only accrue at time 0; in contrast, in an individual-level model, state values accrue each time a patient enters a new state and are discounted based on time of entrance into that state.

time_reset

If FALSE then time intervals are based on time since the start of the simulation. If TRUE, then time intervals reset each time a patient enters a new health state. This is relevant if, for example, costs vary over time within health states. Only used if method = wlos.

Methods

Public methods


Method new()

Create a new StateVals object.

Usage

StateVals$new(
  params,
  input_data = NULL,
  method = c("wlos", "starting"),
  time_reset = FALSE
)

Arguments

params

The params field.

input_data

The input_data field.

method

The method field.

time_reset

The time_reset field.

Returns

A new StateVals object.


Method sim()

Simulate state values with either predicted means or random samples by treatment strategy, patient, health state, and time t.

Usage

StateVals$sim(t, type = c("predict", "random"))

Arguments

t

A numeric vector of times.

type

"predict" for mean values or "random" for random samples.

Returns

A data.table of simulated state values with columns for sample, strategy_id, patient_id, state_id, time, and value.


Method check()

Input validation for class. Checks that fields are the correct type.

Usage

StateVals$check()


Method clone()

The objects of this class are cloneable with this method.

Usage

StateVals$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.