PSweight (version 2.1.0)

PSmethod_SW: Fitting propensity score models with different methods in survey observational data

Description

The function PSmethod_SW is an internal function to estimate the propensity scores given a specified model through formula. It is built into function Sumstat_SW, PStrim_SW and PSweight_SW.

Usage

PSmethod_SW(
  ps.formula = ps.formula,
  method = "glm",
  data = data,
  survey.weight = survey.weight,
  ncate = ncate,
  ps.control = list()
)

Value

e.h

a data frame of estimated propensity scores.

ps.fitObjects

the fitted propensity model details

beta.h

estimated coefficient of the propensity model when method = "glm".

Arguments

ps.formula

an object of class formula (or one that can be coerced to that class): a symbolic description of the propensity score model to be fitted. Additional details of model specification are given under "Details". This argument is optional if ps.estimate is not NULL.

method

a character to specify the method for estimating propensity scores. "glm" is default, and "gbm" and "SuperLearner" are also allowed.

data

an optional data frame containing the variables in the propensity score model.

survey.weight

an numeric vector specifying survey weights for each observation.

ncate

a numeric to specify the number of treatment groups present in the given data.

ps.control

a list to specify additional options when method is set to "gbm" or "SuperLearner".

Details

A typical form for ps.formula is treatment ~ terms where treatment is the treatment variable and terms is a series of terms which specifies a linear predictor. ps.formula by default specifies generalized linear models given the default argument method = "glm". It fits the logistic regression when ncate = 2,and multinomial logistic regression when ncate > 2. The argument method allows user to choose model other than glm to fit the propensity score models. We have included gbm and SuperLearner as two alternative machine learning methods. Additional arguments of the machine learning estimators can be supplied through the ... argument. Note that SuperLearner does not handle multiple groups and the current version of multinomial logistic regression is not supported by gbm. We suggest user to use them with extra caution. Please refer to the user manual of the gbm and SuperLearner packages for all the allowed arguments.

Examples

data("psdata")
data("psdata_bin_prospective_fp")
data("psdata_bin_retrospective_fp")

# the propensity model
ps.formula <- trt~cov1+cov2+cov3+cov4+cov5+cov6
survey.weight <- psdata_bin_retrospective_fp$survey_weight
psfit <- PSmethod_SW(ps.formula = ps.formula,
                     data = psdata_bin_retrospective_fp, 
                     survey.weight = survey.weight, ncate=2)