ICEcolor {ICEinfer}R Documentation

Compute Preferences for Outcomes in a Bootstrap ICE Distribution that are within a Confidence Wedge

Description

Assuming ICEw is an object of class ICEwedge, ICEcolor uses the value of lambda given by lfact * (ICEw item lambda) and the ICE Preference Map with parameters beta and gamma to compute the Economic Preference value for each point within the Bootstrap Distribution of ICE Uncertainty that also lies within the ICEwedge.

Usage

 ICEcolor(ICEw, lfact = 1, beta = 1, gamma = 3 + 2 * sqrt(2)) 

Arguments

ICEw Required; Existing ICEwedge object.
lfact Required; Strictly positive multiplier for ICEw item lambda.
beta Required; Strictly positive Returns-to-Scale power parameter for the ICE Preference Map. beta = 1 implies linear (constant) Returns to Scale. beta > 0 and < 1 implies diminishing Returns to Scale. beta > 1 implies increasing Returns to Scale.
gamma Required; Strictly positive Directional power parameter. The smallest reasonable value for gamma is usually gamma = beta, which yields a (generalized) linear map. The largest reasonable value for gamma is usually gamma = beta*(3+2*sgrt(2)), which yields a map that satisfies the Cartesian Monotonicity Axiom and also yields finite WTP and WTA values greater than or equat to 0 but less than +Inf.

Details

Multiple calls to ICEcolor() are usually made for different lfact multipliers of x item lambda as well as different choices for the ICE Preference power parameters, beta and gamma. Calls to plot(x, alibi) for these alternative ICEcolor x-objects can be used to illustrate that Economic Uncertainty can literally SWAMP the Statistical Uncertainty within patient level data on the relative cost and effectiveness of two treatments.

Value

Object of class ICEcolor containing an output list with the following items:

df Saved value of the name of the data.frame input to ICEcolor.
lambda Saved positive value of lambda input to ICEcolor.
unit Saved value of unit, cost or effe, input to ICEcolor.
R Saved integer value for number of bootstrap replications input to ICEcolor.
trtm Saved name of the treatment indicator within the df data.frame.
xeffe Saved name of the treatment effectiveness variable within the df data.frame.
ycost Saved name of the treatment cost variable within the df data.frame.
effcst Saved value of the sorted 3-variable (trtm,effe,cost) data.frame.
t1 Observed value of (DeltaEffe, DeltaCost) when each patient is sampled exactly once.
t R x 2 matrix of values of (DeltaEffe, DeltaCost) computed from bootstrap resamples.
seed Saved value of the seed used to start pseudo random number generation.

Author(s)

Bob Obenchain <softrx@iquest.net>

References

Cook JR, Heyse JF. Use of an angular transformation for ratio estimation in cost-effectiveness analysis. Statistics in Medicine 2000; 19: 2989-3003.

Obenchain RL. ICE Preference Maps: Nonlinear Generalizations of Net Benefit and Acceptability. Lilly US Health Outcomes White Paper. 2007; 52 pages.

Obenchain RL. ICEinR.pdf ../R_HOME/library/ICEinfer 2007; 30 pages.

See Also

ICEwedge, plot.ICEcolor and print.ICEcolor

Examples

  data(dpwdg)
  dpcol <- ICEcolor(dpwdg)
  dpcol
  plot(dpcol)
  dpcolX <- ICEcolor(dpwdg, lfact=10)
  dpcolX
  plot(dpcolX)

[Package ICEinfer version 0.1-1 Index]