| data.org {mma} | R Documentation |
Data Organization and Identify Potential Mediators
Description
Do a preliminary data analysis to identify potential mediators and covariates. Each variable listed in jointm is forced in the final estimation model as a mediator. Also organize the data into a format that can be directly used for the mediation analysis functions.
Usage
data.org(x,y,pred,mediator=NULL,contmed=NULL,binmed=NULL,binref=NULL,catmed=NULL,
catref=NULL,jointm=NULL,refy=rep(NA,ncol(data.frame(y))),
family1=as.list(rep(NA,ncol(data.frame(y)))),
predref=rep(NA,ncol(data.frame(pred))),alpha=0.1,alpha2=0.1,
testtype=1, w=NULL,cova=NULL)
Arguments
x |
a data frame contains the predictor, all potential mediators and covariates. Note that x has to be a data frame. All varaibles in x that are not identified as potential mediators (by mediator, contmed, binmed, catmed, or jointm) are forced in mediation analysis as covariates. |
y |
the vector of outcome variable.The outcome can be binary, continuous, or of "Surv" class (see survival package for help). |
pred |
the column or matrix of predictor(s): the predictor is the exposure variable, it can be a binary or multi-categorical factor or one/a few contiuous variable(s). |
mediator |
the list of mediators (column numbers in x or by variable names). The mediators to be checked can be identified by "contmed", "binmed" and "catmed", or by this argument, "mediator", where binary and categorical mediators in x are identified as factors or characters, the reference group is the first level of the factor or factorized character. if a mediator has only two unique values, the mediator is identified as binary. If the reference groups need to be changed, the binary or categorical mediators can be listed in binmed or catmed, and the corresponding reference group in binref or catref. |
contmed |
a vector of variable names or column numbers that locate the potential continuous mediators in x. |
binmed |
a vector of column numbers that locate the potential binary mediators in x. |
binref |
the defined reference groups of the binary potential mediators in binmed. The first levels of the mediators if is null. |
catmed |
a vector of variable names or column numbers that locate the potential categorical mediators in x. The first levels of the mediators if is null. |
catref |
the defined reference groups of the categorical potential mediators in catmed. |
jointm |
a list that identifies the mediators that need to be considered jointly, where the first item indicates the number of groups of mediators to be considered jointly, and each of the following items identifies the variable names or column numbers of the mediators in x for each group of joint mediators. |
refy |
if y is binary, the reference group of y. The default is the first level of as.factor(y). y for the reference group is assigned as 0. |
family1 |
define the conditional distribution of y given x, and the linkage function that links the mean of y with the system component in generalized linear model. The default value of family1 is binomial(link = "logit") for binary y, and gaussian(link="identity") for continuous y. |
predref |
if the predictor is categorical, identify the reference group of the predictor. The default is the first level of the predictor. The value of the predictor is 0 for the reference group. |
alpha |
the significance level at which to test if the potential mediators (identified by contmed, binmed, and catmed) can be used as a covariate or mediator in estimating y when all variables in x are included in the model. The default value is alpha=0.1 |
alpha2 |
the significant level at which to test if a potential mediator is related with the predictor. The default value is alpha2=0.1. |
testtype |
if the testtype is 1 (by default), covariates/mediators are identified using full model; if the testtype is 2, covariates/mediators are tested one by one in models with the predictor only. |
w |
the weight for data analysis, by default is rep(1,length(y)). |
cova |
The data frame of covariates to be used to predict the mediator(s). The covariates in cova cannot be potential mediators. If the covariates are for some specific potential mediators, cova$for.m is the vector of names of potential mediators that use the covariates. Works for continuous predictors (pred) only, also the specified covariates should have no missing if only some mediators uses the covariates. |
Value
data.org returns a list with the organized data and identifiers of the potential mediators in the organized data set. The list has two components, bin.results if there is binary or categorical exposure(s), cont.results if there is continuous exposures.
x |
the organized data frame that include all potential mediators and covariates that should be used to estimate the outcome. |
dirx |
the vector/matrix of predictor(s)/exposure variable(s). |
contm |
the column numbers of x that locate the potential continuous mediators. |
binm |
when the predictor is continuous, binm gives the column numbers of x that locate the potential binary mediators. |
catm |
when the predictor is binary, catm gives the column numbers of x that locate the potential binary or categorical mediators; when the predictor is continuous, catm gives a list where the first item is the number of potential categorical mediators, and the following items give the column numbers of each binarized categorical mediator in x. |
jointm |
a list where the first item is the number of groups of joint mediators, and each of the following items identifies the column numbers of the mediators in the newly organized x for each group of joint mediators. |
y |
the vector/matrix of outcome(s). |
y_type |
the variable type of outcome(s): 1 is continuous, 2 is binary, 3 is reserved for multi-categorical (no 3 would show in y_type, since all categorical responses are binarized), and 4 is survival. |
fullmodel |
a list with each item the full linear model fitted with all potential mediators and covariates for each response. |
rela |
p-values of tests on the realtionship between the predictor(s) and each potiential mediator. |
P1 |
If testtype=2, P1 gives the p-value of the corresponding variables in predicting the outcome(s) when only the variable and predictor are covariates in the model. |
binpred |
The columne numbers of binary predictors in pred. |
contpred |
The columne numbers of continuous predictors in pred. |
catpred |
A list with each item includes the columne numbers of a categorical predictor in pred. |
Note
All other variables in x but not identified by mediator, contmed, binmed, or catmed are forced in the final model as covariates. Compared with data.org, joint mediators are considered in this function. Every variable in the jointm should be listed in contmed, binmed, or catmed, and these variables are forced to be included as mediators for further mediation analysis. A variables can be included in more than one groups of joint mediators in jointm.
Author(s)
Qingzhao Yu qyu@lsuhsc.edu
References
Baron, R.M., and Kenny, D.A. (1986) <doi:10.1037/0022-3514.51.6.1173>. The moderator-mediator variable distinction in social psychological research: conceptual, strategic, and statistical considerations. J. Pers Soc Psychol, 51(6), 1173-1182.
Yu, Q., Fan, Y., and Wu, X. (2014) <doi:10.4172/2155-6180.1000189>. "General Multiple Mediation Analysis With an Application to Explore Racial Disparity in Breast Cancer Survival," Journal of Biometrics & Biostatistics,5(2): 189.
Yu, Q., Scribner, R.A., Leonardi, C., Zhang, L., Park, C., Chen, L., and Simonsen, N.R. (2017) <doi:10.1016/j.sste.2017.02.001>. "Exploring racial disparity in obesity: a mediation analysis considering geo-coded environmental factors," Spatial and Spatio-temporal Epidemiology, 21, 13-23.
Yu, Q., and Li, B. (2017) <doi:10.5334/hors.160>. "mma: An r package for multiple mediation analysis," Journal of Open Research Software, 5(1), 11.
Yu, Q., Wu, X., Li, B., and Scribner, R. (2018). <doi:10.1002/sim.7977>. "Multiple Mediation Analysis with Survival Outcomes – With an Application to Explore Racial Disparity in Breast Cancer Survival," Statistics in Medicine.
Yu, Q., Medeiros, KL, Wu, X., and Jensen, R. (2018). <doi:10.1007/s11336-018-9612-2>. "Explore Ethnic Disparities in Anxiety and Depression Among Cancer Survivors Using Nonlinear Mediation Analysis," Psychometrika, 83(4), 991-1006.
See Also
"data.org" that does not consider joint mediators, which can be added freely in the mediation analysis functions later.
Examples
data("weight_behavior")
#binary predictor
#binary y
x=weight_behavior[,c(2,4:14)]
pred=weight_behavior[,3]
y=weight_behavior[,15]
data.b.b.2.1<-data.org(x,y,mediator=5:12,jointm=list(n=1,j1=c(5,7,9)),
pred=pred,predref="M", alpha=0.4,alpha2=0.4)
summary(data.b.b.2.1)
#Or you can specify the potential mediators and change the reference
#group for binary or categorical mediators. In the following code,
#potential continuous mediators are columns 8,9,10,12, and 13 of x,
#binary mediators are columns 7 and 11, and categorical mediator is
#column 6 of x with 1 to be the reference group for all categorical
#and binary mediators.
data.b.b.2<-data.org(x,y,pred=pred,contmed=c(7:9,11:12),binmed=c(6,10),
binref=c(1,1),catmed=5,catref=1,jointm=list(n=1,j1=c(5,7,9)),
predref="M",alpha=0.4,alpha2=0.4)
summary(data.b.b.2)
#use the mediator argument instead of contmet, binmed and catmed
#multivariate predictor
x=weight_behavior[,c(2:3,5:14)]
pred=weight_behavior[,4]
y=weight_behavior[,15]
data.b.b.2.3<-data.org(x,y,mediator=5:12,jointm=list(n=1,j1=c(5,7,9)),
pred=pred,predref="OTHER", alpha=0.4,alpha2=0.4)
summary(data.b.b.2.3)
#multivariate responses
x=weight_behavior[,c(2:3,5:14)]
pred=weight_behavior[,4]
y=weight_behavior[,c(1,15)]
data.b.b.2.4<-data.org(x,y,mediator=5:12,jointm=list(n=1,j1=c(5,7,9)),
pred=pred,predref="OTHER", alpha=0.4,alpha2=0.4)
summary(data.b.b.2.4)
#continuous y
x=weight_behavior[,c(2,4:14)]
pred=weight_behavior[,3]
y=weight_behavior[,1]
data.b.c.2<-data.org(x,y,pred=pred,mediator=5:12,jointm=list(n=1,j1=7:9),
predref="M",alpha=0.4,alpha2=0.4)
summary(data.b.c.2)
#continuous predictor
#binary y
x=weight_behavior[,3:14]
pred=weight_behavior[,2]
y=weight_behavior[,15]
data.c.b.2<-data.org(x,y,pred=pred,mediator=5:12,catref=1,
jointm=list(n=2,j1=7:9,j2=c(5,7)),alpha=0.4,alpha2=0.4)
summary(data.c.b.2)
#multivariate predictors
x=weight_behavior[,c(3:12,14)]
pred=weight_behavior[,c(2,13)]
y=weight_behavior[,15]
data.c.b.2.2<-data.org(x,y,pred=pred,mediator=5:11,catref=1,
jointm=list(n=2,j1=7:9,j2=c(5,7)),alpha=0.4,alpha2=0.4)
summary(data.c.b.2.2)
#continuous y
x=weight_behavior[,3:14]
pred=weight_behavior[,2]
y=weight_behavior[,1]
data.c.c.2<-data.org(x,y,pred=pred,contmed=c(7:9,11:12),binmed=c(6,10),
binref=c(1,1),catmed=5,catref=1,jointm=list(n=2,j1=7:9,j2=c(5,7)),
alpha=0.4,alpha2=0.4)
summary(data.c.c.2)
#multivariate responses
x=weight_behavior[,c(2:3,5:14)]
pred=weight_behavior[,4]
y=weight_behavior[,c(1,15)]
data.b.c.2.4<-data.org(x,y,mediator=5:12,jointm=list(n=1,j1=c(5,7,9)),
pred=pred,predref="OTHER", alpha=0.4,alpha2=0.4)
summary(data.b.c.2.4)
#
x=weight_behavior[,c(3:12,14)]
pred=weight_behavior[,c(2,13)]
y=weight_behavior[,c(1,15)]
data.c.c.2.2<-data.org(x,y,pred=pred,mediator=5:11,catref=1,
jointm=list(n=2,j1=7:9,j2=c(5,7)),alpha=0.4,alpha2=0.4)
summary(data.c.c.2.2)
#Surv class outcome (survival analysis)
data(cgd1) #a dataset in the survival package
x=cgd1[,c(4:5,7:12)]
pred=cgd1[,6]
status<-ifelse(is.na(cgd1$etime1),0,1)
y=Surv(cgd1$futime,status)
#for continuous predictor
#all other variables are considered as potential mediator
data.surv.contx<-data.org(x,y,pred=pred,mediator=(1:ncol(x)),
alpha=0.5,alpha2=0.5)
summary(data.surv.contx)
#for binary predictor
x=cgd1[,c(5:12)]
pred=cgd1[,4]
data.surv.binx<-data.org(x,y,pred=pred,mediator=(1:ncol(x)),
alpha=0.4,alpha2=0.4)
summary(data.surv.binx)