Learn R Programming

BCEA: Bayesian cost-effectiveness analysis

Perform Bayesian Cost-Effectiveness Analysis in R.

:rocket: Version 2.4.7 in development now! Check out the release notes here.

Contents

Overview

Given the results of a Bayesian model (possibly based on MCMC) in the form of simulations from the posterior distributions of suitable variables of costs and clinical benefits for two or more interventions, produces a health economic evaluation. Compares one of the interventions (the "reference") to the others ("comparators").

Features

Main features of BCEA include:

  • Cost-effectiveness analysis plots, such as CE planes and CEAC
  • Summary statistics and tables
  • EVPPI calculations and plots

Installation

Install the released version from CRAN with

install.packages("BCEA")

The stable version (which can be updated more quickly) can be installed using this GitHub repository. On Windows machines, you need to install a few dependencies, including Rtools first, e.g. by running

pkgs <- c("MASS", "Rtools", "remotes")
repos <- "https://cran.rstudio.com"
install.packages(pkgs, repos = repos, dependencies = "Depends")

before installing the package using remotes:

remotes::install_github("giabaio/BCEA")

Under Linux or MacOS, it is sufficient to install the package via remotes:

install.packages("remotes")
remotes::install_github("giabaio/BCEA")

Articles

Examples of using specific functions and their different arguments are given in these articles:

Further details

The pkgdown site is here. More details on BCEA are available in our book Bayesian Cost-Effectiveness Analysis with the R Package BCEA (published in the UseR! Springer series). Also, details about the package, including some references and links to a pdf presentation and some posts on my own blog) are given here.

License

Contributing

Please submit contributions through Pull Requests, following the contributing guidelines. To report issues and/or seek support, please file a new ticket in the issue tracker.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Copy Link

Version

Install

install.packages('BCEA')

Monthly Downloads

705

Version

2.4.7

License

GPL-3

Issues

13

Pull Requests

0

Stars

42

Forks

16

Maintainer

Gianluca Baio

Last Published

January 14th, 2025

Functions in BCEA (2.4.7)

ceaf.plot.pairwise

Cost-Effectiveness Acceptability Frontier (CEAF) plot
ceplane_geom_params

Extract Separate Parameter Sets
compute_U

Compute U Statistic
compute_ICER

Compute Incremental Cost-Effectiveness Ratio
compute_p_best_interv

Compute Probability Best Intervention
compute_ceaf

Compute Cost-Effectiveness Acceptability Frontier
ceplane_ggplot_params

CE-plane ggplot Parameters
compute_eib_cri

Calculate Credible Intervals
compute_Ubar

Compute NB for mixture of interventions
compute_Ustar

Compute Ustar Statistic
ceplane_plot_graph

Cost-Effectiveness Plane Plot By Graph Device
comp_names_from_

Comparison Names From
compute_IB

Compute Incremental Benefit
compute_EVI

Compute Expected Value of Information
eib_plot_graph

Expected Incremental Benefit Plot By Graph Device
compute_vi

Compute Value of Information
convert_pts_to_mm

Use from Base R to ggplot
eib_params_base

EIB parameters specific to base R plot
compute_CEAC

Compute Cost-Effectiveness Acceptability Curve
compute_kstar

Compute k^*
compute_EIB

Compute Expected Incremental Benefit
diag.evppi

Diagnostic Plots For The Results Of The EVPPI
evi.plot.bcea

Expected Value of Information (EVI) Plot
eib.plot.bcea

Expected Incremental Benefit (EIB) Plot
compute_ol

Compute Opportunity Loss
ib_plot_base

IB plot base R version
eib_params_cri

EIB Parameters CrI
contour_graph

Contour Cost-Effectiveness Plane
contour_ggplot_params

Contour ggplot Parameters
get_fitted_

Get fitted values from evppi object
contour.bcea

Contour Plots for the Cost-Effectiveness Plane
kstar_vlines

Prepare K-star vertical lines
ib.plot.bcea

Incremental Benefit (IB) Distribution Plot
line_labels

Create Labels for Plot
contour2.bcea

Specialised CE-plane Contour Plot
quiet

Allow disabling of the cat messages
plot.bcea

Summary Plot of the Health Economic Analysis
evppi

Expected Value of Perfect Partial Information (EVPPI) for Selected Parameters
make_legend_plotly

Legend Positioning
plot.CEriskav

Plots EIB and EVPI for the Risk Aversion Case
createInputs.default

Create Inputs for EVPI Calculation
evi.plot.mixedAn

EVI Plot of the Health Economic Analysis For Mixed Analysis
evppi_qq_plot

Q-Q Plot
info.rank.bcea

Information-Rank Plot for bcea Class
evppi_residual_plot

Residual Plot
geom_cri

Credible interval ggplot geom
select_plot_type

Choose Graphical Engine
mce.plot

Plots the probability that each intervention is the most cost-effective
evppi_plot_graph

Plot Expected Value of Partial Information With Respect to a Set of Parameters
evi_plot_graph

Expected Value of Information Plot By Graph Device
setComparisons

Set Comparisons Group
theme_bcea

bcea theme ggplot2
setComparisons_assign

Set Comparison Group
info_rank_graph

Info Rank Plot By Graph Device
mixedAn<-

Cost-Effectiveness Analysis When Multiple (Possibly Non-Cost-Effective) Interventions are Present on the Market
validate_bcea

Validate bcea
inforank_params

Prepare Info Rank plot parameters
plot.evppi

Plot Expected Value of Partial Information With Respect to a Set of Parameters
multi.ce

Cost-effectiveness Analysis With Multiple Comparison
print.bcea

bcea Print Method
loo_rank

Leave-one-out ranking
plot_eib_cri

Plot Credible Intervals
setKmax_assign

Set Maximum Willingness to Pay
is.bcea

Check bcea Class
geom_quad_txt

Geom Quadrant Text
setReferenceGroup_assign

Set Reference Group
validate_eib_params

Validate EIB parameters
summary.pairwise

Summary Method for Objects of Class pairwise
is.rel

Reports whether x is a rel object Copied from ggplot2
tabulate_means

Calculate Dataset For ICERs From bcea Object
new_bcea

Constructor for bcea
quadrant_params

Quadrant Parameters requires just a single comparison group
make.report

Make Report
prep_eib_params

Prepare EIB plot parameters
multiplot

Plot Multiple bcea Graphs
struct.psa

Structural Probability Sensitivity Analysis
sim_table

Table of Simulation Statistics for the Health Economic Model
prep_contour_params

Prepare contour plot parameters Additional to ceplane parameters
num_lines

Get number of lines
prep_frontier_data

Prepare frontier data
openPDF

Automatically open pdf output using default pdf viewer
prep_ceplane_params

Prepare CE-plane Parameters
summary.bcea

Summary Method for Objects of Class bcea
summary.mixedAn

Summary Methods For Objects in the Class mixedAn (Mixed Analysis)
add_contour_quadrants

Add Contour Quadrants
CEriskav_plot_graph

Cost-effectiveness Plot Including a Parameter of Risk Aversion
CEriskav_assign

Cost-effectiveness Analysis Including a Parameter of Risk Aversion
BCEA-deprecated

Deprecated functions in package BCEA.
Vaccine

Data set for the Bayesian model for the cost-effectiveness of influenza vaccination
Smoking

Data set for the Bayesian model for the cost-effectiveness of smoking cessation interventions
bcea

Create Bayesian Cost-Effectiveness Analysis Object
BCEA-package

BCEA: Bayesian Cost Effectiveness Analysis
GrassmannOptim

GrassmannOptim
best_interv_given_k

Optimal intervention
ceef_plot_graph

Cost-effectiveness Efficiency Frontier Plot By Graph Device
ceef.plot.bcea

Cost-Effectiveness Efficiency Frontier (CEEF) Plot
add_contours

Add Contours to Base R Plot
ceplane.plot.bcea

Cost-effectiveness Plane Plot
ceac.plot.bcea

Cost-Effectiveness Acceptability Curve (CEAC) Plot
ce_table

Cost-effectiveness summary statistics table
ceef.summary

Summary table for CEEF
ceac_matplot

CEAC Matrix Plot
ceac_plot_graph

Cost-Effectiveness Acceptability Curve (CEAC) Plot By Graph Device