arfimaMLM | R Documentation |
Estimates Arfima-MLM model for repeated cross-sectional data or pooled cross-sectional time-series data. For the variables specified by the user, the function automatically implements the aggregation and fractional differencing of time/level variables as well as the necessary procedures to remove deterministic components from the dependent as well as the major independent variables.
arfimaMLM(formula, data, timevar , d = "ML", arma = NULL , ecmformula = NULL, decm = "ML" , drop = 5, report.data = TRUE, ...)
formula |
An object of the class “ |
data |
Data frame containing the original variables named in |
timevar |
Name of the variable indicating different timepoints in |
d |
Call for a specific estimation method for the fractional differencing parameter in the |
arma |
List of variables for which AR and MA parameters are to be estimated (after fractional differencing) as well as a vector containing the respective orders of the model to fit. |
ecmformula |
Specification of the cointegration regression to receive the residuals for the error correction mechanism (ecm) included in |
decm |
Call for estimation method for the fractional differencing parameter (see |
drop |
Number of time points from the beginning of the series dropped from analysis. Default is 5. |
report.data |
Logical. |
... |
Further arguments passed to the estimation procedures used within the function (e.g. for |
The original variable names of data
used in formula
can be extended by adding three different suffixes: .fd
, .xdif
, and .ydif
. These suffixes select variables for transformations according to the Arfima-MLM framework before estimating the actual model.
The suffix .fd
allows the user to select variables which are supposed to be transformed to a fractionally differenced level-variable (by aggregating individuals over each time point prior to fractionally differencing the series), or variables which are already included as a level-variable in the original dataset and are just supposed to be fractionally differenced before the multilevel model is estimated.
If the suffix .xdif
is added to an independent variable, the variable is simply filtered through the timepoint averages:
x.star[it]=x[it]-X[t]
If the suffix .ydif
is added to the dependent variable (e.g. y[it]), the function will remove the temporal deterministic component from the individual level variable, such that it only consists of within-timepoint, as well as non-temporally autocorrelated between-timepoint variation:
y.star[it]=y[it]-(Y[t]-Δ[df]Y[t])
If formula
contains ecm
as one of the independent variables, and ecmformula
is correctly specified, the function will include the lag of the fractionally differenced residuals of the cointegration regression as an error correction mechanism in the multilevel model. The ECM does not have to be estimated prior to calling the function.
In order to prevent errors in the estimation procedure, none of the original variable names in data
should include “.ydif
”, “.xdif
” or “.fd
”.
The function returns a list of the class 'arfimaMLM' with the following items:
result |
Output of the multilevel model as specified in |
d |
Matrix of fractional differencing parameters estimated for the level variables ( |
arma |
List of |
ecm |
Output of the cointegration regression (returned if |
data.mean |
Data frame of variable means declared in |
data.fd |
Data frame of fractionally differenced level variables for each time point specified in |
data.merged |
Merged data frame used to estimate the multilevel model consisting of the original data, |
Patrick Kraft
Lebo, M. and Weber, C. 2015. “An Effective Approach to the Repeated Cross Sectional Design.” American Journal of Political Science 59(1): 242-258.
lme4
, fracdiff
, hurstSpec
, arfimaPrep
, fd
, and ArfimaMLM
for a package overview.
require(fracdiff) require(lme4) ### set basic parameters for simulation t = 100 # number of time points n = 500 # number of observations within time point N = t*n # total number of observations ### generate fractional ARIMA Time Series for y_t, x1_t, z1_t, z2_t set.seed(123) y_t <- fracdiff.sim(t, d=0.4, mu=10)$series x1_t <- fracdiff.sim(t, d=0.3, mu=5)$series z1_t <- fracdiff.sim(t, d=0.1, mu=2)$series z2_t <- fracdiff.sim(t, d=0.25, mu=3)$series ### simulate data data <- NULL; data$time <- rep(seq(1:t),each=n) data <- data.frame(data) data$x1 <- rnorm(N,rep(x1_t,each=n),2) data$x2 <- rnorm(N,0,40) data$z1 <- rnorm(N,rep(z1_t,each=n),3) data$z2 <- rep(z2_t,each=n) b1 <- 0.2+rep(rnorm(t,0,0.1),each=n) data$y <- (b1*data$x1-0.05*data$x2+0.3*rep(z1_t,each=n) +0*data$z2+rnorm(N,rep(y_t,each=n),1)) ### estimate models # basic example m1 <- arfimaMLM(y.ydif ~ x1.xdif + x2 + z1.fd + z2.fd + (1 | time) , data = data, timevar = "time") # model including error correction mechanism # change estimation method for differencing parameter for all variables m2 <- arfimaMLM(y.ydif ~ x1.xdif + x2 + z1.fd + z2.fd + ecm + (1 | time) , data = data, timevar = "time", d="ML" , ecmformula = y.mean ~ x1.mean , decm="Sperio") # vary estimation method for differencing parameter between variables # specify AR/MA models m3 <- arfimaMLM(y.ydif ~ x1.xdif + x2 + z1.fd + z2.fd + (1+x1.xdif|time) , data = data, timevar = "time" , d=list(y="ML", z1="Sperio", z2=0.25) , arma=list(y=c(1,0),z2=c(0,1))) # specify AR/MA models while holding AR[2] fixed for y m4 <- arfimaMLM(y.ydif ~ x1.xdif + x2 + z1.fd + z2.fd + (1+x1.xdif|time) , data = data, timevar = "time" , arma=list(y=list(c(1,3),0),z2=c(0,1))) m1 summary(m2) summary(m3$result) m4$arma
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.