Summary method for cost-effectiveness object

Summarize a ce object by producing confidence intervals for quality-adjusted life-years (QALYs) and each cost category with summary.ce() and format for pretty printing with format.summary.ce().

# S3 method for ce
summary(object, prob = 0.95, labels = NULL, ...)

# S3 method for summary.ce
format(
  x,
  digits_qalys = 2,
  digits_costs = 0,
  dr_qalys = NULL,
  dr_costs = NULL,
  pivot_from = "strategy",
  drop_grp = TRUE,
  pretty_names = TRUE,
  ...
)

Arguments

object: A ce object.
prob: A numeric scalar in the interval (0,1) giving the confidence interval. Default is 0.95 for a 95 percent interval.
labels: A list of named vectors containing the values and labels of variables. The elements of each vector are the values of a variable and the names are the labels. The names of the list are the names of the variables. See the output returned by get_labels() for an example.
...: Further arguments passed to or from other methods. Currently unused.
x: A summary.ce object.
digits_qalys: Number of digits to use to report QALYs.
digits_costs: Number of digits to use to report costs.
dr_qalys: Discount rate to subset to for quality-adjusted life-years (QALYs).
dr_costs: Discount rate to subset to for costs.
pivot_from: Character vector denoting a column or columns used to "widen" the data. Should either be "strategy", "grp", "outcome", or some combination of the three. There will be one column for each value of the variables in pivot_from. Default is to widen so there is a column for each treatment strategy. Set to NULL if you do not want to widen the table.
drop_grp: If TRUE, then the group column will be removed if there is only one subgroup; other it will be kept. If FALSE, then the grp column is never removed.
pretty_names: Logical. If TRUE, then the columns strategy, grp, outcome, dr, and value are renamed (if they exist) to Strategy, Group, Outcome, Discount rate, and Value.

Value

summary.ce() returns an object of class summary.ce that is a tidy data.table with the following columns:

dr: The discount rate.
strategy: The treatment strategy.
grp: The patient subgroup.
type: Either "QALYs" or "Costs".
category: Category is always "QALYs" when type == "QALYs"; otherwise, it is the cost category.
estimate: The point estimate computed as the average across the PSA samples.
lower: The lower limit of the confidence interval.
upper: The upper limit of the confidence interval.

format.summary.ce() formats the table according to the arguments passed.

Details

For an example, see IndivCtstm.