UPSaccum {USPS}R Documentation

Prepare for Accumulation of (Outcome,Treatment) Results in Unsupervised Propensity Scoring.

Description

Specify key result accumulation parameters: Treatment t-Factor, Outcome Y-variable, faclev setting, scedasticity assumption, and name of the UPSgraph() data accumulation object.

Usage

UPSaccum(hiclus, dframe, trtm, yvar, faclev=3, scedas="hete", accobj="UPSframe")

Arguments

hiclus Name of UPShclus() output object created using the diana, agnes or hclust method.
dframe Name of data.frame containing the X, t & Y variables.
trtm Name of treatment factor variable.
yvar Name of outcome Y variable.
faclev Maximum number of different numerical values an outcome variable can assume without automatically being converted into a "factor" variable; faclev=1 causes a binary indicator to be treated as a continuous variable determining an average or proportion.
scedas Scedasticity assumption: "homo" or "hete"
accobj Name of the object for accumulation of I-plots to be ultimately displayed using UPSgraph().

Details

The second phase in an Unsupervised Propensity Scoring analysis is to prepare to accumulate results over a wide range of values for "Number of Clusters." As the number of such clusters increases, individual clusters will tend to become smaller and smaller and, thus, more and more compact in covariate X-space.

Value

The output object will automaticlly be named UPSaccum.pars:

hiclus Name of a diana, agnes or hclust object created by UPShclus().
dframe Name of data.frame containing the X, t & Y variables.
trtm Name of treatment factor variable.
yvar Name of outcome Y variable.
faclev Maximum number of different numerical values an outcome variable can assume without automatically being converted into a "factor" variable; faclev=1 causes a binary indicator to be treated as a continuous variable determining a proportion.
scedas Scedasticity assumption: "homo" or "hete"
accobj Name of the object for accumulation of I-plots to be ultimately displayed using UPSgraph().
nnymax Maximum NN LTD Standard Error observed; Upper NN plot limit; initialized to zero.
nnxmin Minimum NN LTD observed; Left NN plot limit; initialized to zero.
nnxmax Maximum NN LTD observed; Right NN plot limit; initialized to zero.

Author(s)

Bob Obenchain <wizbob@att.net>

References

Obenchain RL. (2004) Unsupervised Propensity Scoring: NN and IV Plots. Proceedings of the American Statistical Association (on CD) 8 pages.

Obenchain RL. (2009) USPSinR.pdf ../R_HOME/library/USPS 40 pages.

See Also

UPSnnltd, UPSivadj and UPShclus.

Examples

  data(lindner)
  UPSxvars <- c("stent", "height", "female", "diabetic", "acutemi", "ejecfrac", "ves1proc")
  UPSharch <- UPShclus(lindner, UPSxvars)

  UPSaccum(UPSharch, lindner, abcix, lifepres, faclev=1, scedas="homo", accobj="ABClife")
  UPSaccum.pars
    
  lif001nn <- UPSnnltd(1)
  lif020nn <- UPSnnltd(20)
  lif070nn <- UPSnnltd(70)
  UPSgraph()

  ABClife

[Package USPS version 1.2-0 Index]