Produces a plot of the Expected Incremental Benefit (EIB) as a function of the willingness to pay
eib.plot(he, comparison = NULL, pos = c(1, 0), size = NULL,
plot.cri = NULL, graph = c("base", "ggplot2", "plotly"), ...)
A bcea
object containing the results of the Bayesian
modelling and the economic evaluation.
Selects the comparator, in case of more than two
interventions being analysed. Default as NULL
plots all the
comparisons together. Any subset of the possible comparisons can be selected
(e.g., comparison=c(1,3)
or comparison=2
).
Parameter to set the position of the legend; for a single
comparison plot, the ICER legend position. Can be given in form of a string
(bottom|top)(right|left)
for base graphics and
bottom|top|left|right
for ggplot2. It can be a two-elements vector,
which specifies the relative position on the x and y axis respectively, or
alternatively it can be in form of a logical variable, with FALSE
indicating to use the default position and TRUE
to place it on the
bottom of the plot. Default value is c(1,0)
, that is the bottomright
corner inside the plot area.
Value (in millimetres) of the size of the willingness to pay
label. Used only if graph="ggplot2"
, otherwise it will be ignored
with a message. If set to NA
, the break-even point line(s) and
label(s) are suppressed, with both base graphics and ggplot2.
Logical value. Should the credible intervals be plotted
along with the expected incremental benefit? Default as NULL
draws
the 95% credible intervals if only one comparison is selected, and does not
include them for multiple comparisons. Setting plot.cri=TRUE
or
plot.cri=FALSE
forces the function to add the intervals or not. The
level of the intervals can be also set, see … for more details.
A string used to select the graphical engine to use for
plotting. Should (partial-)match the three options "base"
,
"ggplot2"
or "plotly"
. Default value is "base"
.
If graph="ggplot2"
and a named theme object is supplied,
it will be added to the ggplot object. Additional arguments:
alpha
can be used to set the CrI level when plot.cri=TRUE
,
with a default value of alpha=0.05
.
cri.quantile
controls the the method of calculation of the credible
intervals. The default value cri.quantile=TRUE
defines the CrI as the
interval between the alpha/2
-th and 1-alpha/2
-th quantiles of
the IB distribution. Setting cri.quantile=FALSE
will use a normal
approximation on the IB distribution to calculate the intervals.
line_colors
: specifies the line colour(s) - all graph types.
line_types
: specifies the line type(s) as lty numeric values - all graph types.
area_include
: include area under the EIB curve - plotly only.
area_color
: specifies the AUC curve - plotly only.
If graph="ggplot2"
a ggplot object, or if graph="plotly"
a plotly object containing the requested plot. Nothing is returned when graph="base"
,
the default.
Baio, G., Dawid, A. P. (2011). Probabilistic Sensitivity Analysis in Health Economics. Statistical Methods in Medical Research doi:10.1177/0962280211419832.
Baio G. (2012). Bayesian Methods in Health Economics. CRC/Chapman Hall, London