summary.ce {hesim}

Summary method for cost-effectiveness object

Description

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().

Usage

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

## S3 method for class '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.

Details

For an example, see IndivCtstm.

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.