clus_vus {ClusROC} | R Documentation |
Estimation of the covariate-specific VUS for clustered data.
Description
This function estimates the covariate-specific VUS of a continuous diagnostic test in the setting of clustered data as described in Xiong et al. (2018). This function allows to estimate covariate-specific VUS at multiple points for covariates.
Usage
clus_vus(out_clus_lme, newdata, ap_var = TRUE, subdivisions = 1000, ...)
Arguments
out_clus_lme |
an object of class "clus_lme", a result of |
newdata |
a data frame (containing specific value(s) of covariate(s)) in which to look for variables with which to estimate covariate-specific VUS. In absence of covariate, no values have to be specified. |
ap_var |
logical value. If set to |
subdivisions |
the maximum number of subintervals used to approximate integral. Default is 1000. |
... |
additional arguments to be passed to |
Details
This function implements a method in Xiong et al. (2018) for estimating covariate-specific VUS of a continuous diagnostic test in a clustered design with three ordinal groups. The estimator is based on results from clus_lme
, which uses the REML approach. The standard error of the estimated covariate-specific VUS is approximated through the Delta method.
Before performing estimation, a check for the monotone ordering assumption is performed. This means that, for the fixed values of covariates, three predicted mean values for test results in three diagnostic groups are compared. If the assumption is not meet, the covariate-specific VUS at the values of covariates are not estimated. In addition, this function also performs the statistical test, H_0: VUS = 1/6
versus an alternative of interest.
Value
clus_vus
returns an object of class "VUS" which is a list containing at least the following components:
call |
the matched call. |
vus_est |
a vector containing the estimated covariate-specific VUS. |
vus_se |
a vector containing the standard errors. |
mess_order |
a diagnostic message from checking the monontone ordering. |
newdata |
value(s) of covariate(s). |
n_p |
total number of regressors in the model. |
Generic functions such as print
is also used to show the results.
References
Xiong, C., Luo, J., Chen L., Gao, F., Liu, J., Wang, G., Bateman, R. and Morris, J. C. (2018) “Estimating diagnostic accuracy for clustered ordinal diagnostic groups in the three-class case – Application to the early diagnosis of Alzheimer disease”. Statistical Methods in Medical Research, 27, 3, 701-714.
Examples
data(data_3class)
## One covariate
out1 <- clus_lme(fixed_formula = Y ~ X1, name_class = "D",
name_clust = "id_Clus", data = data_3class)
### Estimate covariate-specific VUS at one value of one covariate
out_vus1 <- clus_vus(out1, newdata = data.frame(X1 = 0.5))
ci_clus_vus(out_vus1, ci_level = 0.95)
### Estimate covariate-specific VUS at multiple values of one covariate
out_vus2 <- clus_vus(out1, newdata = data.frame(X1 = c(-0.5, 0, 0.5)))
ci_clus_vus(out_vus2, ci_level = 0.95)
## Two covariates
out2 <- clus_lme(fixed_formula = Y ~ X1 + X2, name_class = "D",
name_clust = "id_Clus", data = data_3class)
### Estimate covariate-specific VUS at one point
out_vus3 <- clus_vus(out2, newdata = data.frame(X1 = 1.5, X2 = 1))
ci_clus_vus(out_vus3, ci_level = 0.95)
### Estimate covariate-specific VUS at three points
out_vus4 <- clus_vus(out2, newdata = data.frame(X1 = c(-0.5, 0.5, 0.5),
X2 = c(0, 0, 1)))
ci_clus_vus(out_vus4, ci_level = 0.95)