predict.rrreg is used to generate predicted probabilities from a multivariate regression object of survey data using randomized response methods.

# S3 method for rrreg
predict(object, given.y = FALSE, alpha = .05, n.sims =
1000, avg = FALSE, newdata = NULL, quasi.bayes = FALSE, keep.draws = FALSE,
...)

## Arguments

object An object of class "rrreg" generated by the rrreg() function. Indicator of whether to use "y" the response vector to calculate the posterior prediction of latent responses. Default is FALSE, which simply generates fitted values using the logistic regression. Confidence level for the hypothesis test to generate upper and lower confidence intervals. Default is  .05. Number of sampled draws for quasi-bayesian predicted probability estimation. Default is 1000. Whether to output the mean of the predicted probabilities and uncertainty estimates. Default is FALSE. Optional new data frame of covariates provided by the user. Otherwise, the original data frame from the "rreg" object is used. Option to use Monte Carlo simulations to generate uncertainty estimates for predicted probabilities. Default is FALSE. Option to return the Monte Carlos draws of the quantity of interest, for use in calculating differences for example. Further arguments to be passed to predict.rrreg() command.

## Value

predict.rrreg returns predicted probabilities either for each observation in the data frame or the average over all observations. The output is a list that contains the following components:

est

Predicted probabilities for the randomized response item generated either using fitted values, posterior predictions, or quasi-Bayesian simulations. If avg is set to TRUE, the output will only include the mean estimate.

se

Standard errors for the predicted probabilities of the randomized response item generated using Monte Carlo simulations. If quasi.bayes is set to FALSE, no standard errors will be outputted.

ci.lower

Estimates for the lower confidence interval. If quasi.bayes is set to FALSE, no confidence interval estimate will be outputted.

ci.upper

Estimates for the upper confidence interval. If quasi.bayes is set to FALSE, no confidence interval estimate will be outputted.

qoi.draws

Monte Carlos draws of the quantity of interest, returned only if keep.draws is set to TRUE.

## Details

This function allows users to generate predicted probabilities for the randomized response item given an object of class "rrreg" from the rrreg() function. Four standard designs are accepted by this function: mirrored question, forced response, disguised response, and unrelated question. The design, already specified in the "rrreg" object, is then directly inputted into this function.

## References

Blair, Graeme, Kosuke Imai and Yang-Yang Zhou. (2014) "Design and Analysis of the Randomized Response Technique." Working Paper. Available at http://imai.princeton.edu/research/randresp.html.

rrreg to conduct multivariate regression analyses in order to generate predicted probabilities for the randomized response item.

## Examples


# NOT RUN {
data(nigeria)

set.seed(1)

## Define design parameters
p <- 2/3  # probability of answering honestly in Forced Response Design
p1 <- 1/6 # probability of forced 'yes'
p0 <- 1/6 # probability of forced 'no'

## Fit linear regression on the randomized response item of
## whether citizen respondents had direct social contacts to armed groups

rr.q1.reg.obj <- rrreg(rr.q1 ~ cov.asset.index + cov.married + I(cov.age/10) +
I((cov.age/10)^2) + cov.education + cov.female,
data = nigeria, p = p, p1 = p1, p0 = p0,
design = "forced-known")

## Generate the mean predicted probability of having social contacts to
## armed groups across respondents using quasi-Bayesian simulations.

rr.q1.reg.pred <- predict(rr.q1.reg.obj, given.y = FALSE,
avg = TRUE, quasi.bayes = TRUE,
n.sims = 10000)

## Replicates Table 3 in Blair, Imai, and Zhou (2014)
# }