Last data update: 2014.03.03

R: Equivariant Wedge-Shaped ICE Region with Confidence Level...
 ICEwedge R Documentation

Equivariant Wedge-Shaped ICE Region with Confidence Level from 0.50 to 0.99

Description

ICEwedge() uses the Bootstrap Distribution of ICE Uncertainty generated by ICEuncrt() to calculate and sort ICE Angle Order Statistics around a circle. ICEwedge() then counts outwards the same number of ICE Angle Order Statistics, floor(R*conf/2), both Counter-Clockwise and Clockwise from the so-called center Order Statistic (the one nearest to the Observed ICE Ratio) to define a pair of ICE Ray Endpoints at ICE Angle Order Statistics (reported as numbers jlo and kup, respectively) that subtend an ICE Polar Angle reported as being of subangle in degrees.

Usage

```ICEwedge(ICEu, lfact = 1, conf = 0.95)
```

Arguments

 `ICEu` Output list object of class ICEuncrt. `lfact` Either a strictly positive multiplicative factor for ICEu item lambda or else 0 to cause ICEwedge to compute the positive lfact and lambda values which transforms the alibi display so that it has an alias interpretation. `conf` Statistical Confidence Level within [0.50, 0.99].

Details

The plot() of an object of class ICEwedge displays the Bootstrap Distribution of ICE Uncertainty with a small, circular, colored dot (pch = 20). Outcomes outside the Wedge are displayed in black, while outcomes inside the Wedge are displayed in cyan. Upper and lower ICE Ray Limits are displayed as solid black lines, and the ICE Ray through the center ICE Angle Order Statistic is shown as a dashed black line.

Value

An object of class ICEwedge with the following output list:

 `ICEinp` Name of the ICEuncrt object input to ICEwedge(). `lambda` Positive value of lfact * ICEu item lambda `lfact` Positive Multiplier for the ICEu item lambda value input to ICEwedge(). `unit` Saved value of unit, cost or effe, input to ICEuncrt. `conf` Statistical Confidence Level within [0.50, 0.99] input to ICEwedge. `R` Saved integer value for number of bootstrap replications input to ICEuncrt. `axys` R x 4 data.frame with ICE Angle in column 1, bootstrap resampled values of (DeltaEffe, DeltaCost) in columns 2 and 3, and the binary flag with 0 => outcome outSide the Confidence Wedge and 1 => outcome inSide the Confidence Wedge in column 4. `t1` Observed value of (DeltaEffe, DeltaCost) when each patient is sampled exactly once. `ia1` The center ICE Angle closest to the Objerved ICE Ratio. `center` The largest value of j such that axys[j, 1] < ia1 <= axys[j+1, 1]. `jlo` Number of the ICE Angle Order Statistic defining the Clockwise or lower ICE Ray boundary of the Confidence Wedge. `kup` Number of the ICE Angle Order Statistic defining the Counter-Clockwise or upper ICE Ray boundary of the Confidence Wedge. `subangle` Subtended Polar ICE Angle between Order Statistics numbers jlo and kup. `xmax` Alias plots of ICEwedge have horizontal range [-xmax, +xmax]. `ymax` Alias plots of ICEwedge have vertical range [-ymax, +ymax]. `ab` ICE angle computation perspective of alibi or alias.

Author(s)

Bob Obenchain <wizbob@att.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. Resampling and multiplicity in cost-effectiveness inference. Journal of Biopharmaceutical Statistics 1999; 9(4): 563-582.

Obenchain RL. ICE Preference Maps: Nonlinear Generalizations of Net Benefit and Acceptability. Health Serv Outcomes Res Method 2008; 8: 31-56. DOI 10.1007/s10742-007-0027-2. Open Access.

Obenchain RL. ICEinR.pdf Vignette-like documentation for ICEinfer stored in the R library/ICEinfer/doc folder. 2009; 30 pages.

`ICEuncrt` and `ICEcolor`

Examples

```  data(dpunc)
# ICEwedge() calculations are rather slow
dpwdg <- ICEwedge(dpunc)
plot(dpwdg)
# ICE Angle computations using the alibi axes with an alias interpretation
dpwdg0 <- ICEwedge(dpunc, lfact=0)
plot(dpwdg0)
```

Results

```
R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(ICEinfer)
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/ICEinfer/ICEwedge.Rd_%03d_medium.png", width=480, height=480)
> ### Name: ICEwedge
> ### Title: Equivariant Wedge-Shaped ICE Region with Confidence Level from
> ###   0.50 to 0.99
> ### Aliases: ICEwedge
> ### Keywords: methods nonparametric robust
>
> ### ** Examples
>
>   data(dpunc)
>   # ICEwedge() calculations are rather slow
>   dpwdg <- ICEwedge(dpunc)
>   plot(dpwdg)
>   # ICE Angle computations using the alibi axes with an alias interpretation
>   dpwdg0 <- ICEwedge(dpunc, lfact=0)
>   plot(dpwdg0)
>
>
>
>
>
> dev.off()
null device
1
>

```