gsynth: Generalized Synthetic Control Method

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/default.R

Description

Implements the generalized synthetic control method based on interactive fixed effect models.

Usage

1
2
3
4
5
6
7
8
gsynth(formula=NULL, data, Y, D, X = NULL, na.rm = FALSE, 
       index, weight = NULL, force = "unit", cl = NULL, r = 0, 
       lambda = NULL, nlambda = 10, CV = TRUE, criterion = "mspe",
       k = 5, EM = FALSE, estimator = "ife",
       se = FALSE, nboots = 200, 
       inference = "nonparametric", cov.ar = 1, parallel = TRUE, 
       cores = NULL, tol = 0.001, seed = NULL, min.T0 = 5, 
       alpha = 0.05, normalize = FALSE)  

Arguments

formula

an object of class "formula": a symbolic description of the model to be fitted.

data

a data frame (must be with a dichotomous treatment but balanced is not required).

Y

outcome.

D

treatment.

X

time-varying covariates.

na.rm

a logical flag indicating whether to list-wise delete missing data. The algorithm will report an error if missing data exist.

index

a two-element string vector specifying the unit (group) and time indicators. Must be of length 2.

weight

a string specifying the weighting variable(if any) to estimate the weighted average treatment effect. Default is weight = NULL.

force

a string indicating whether unit or time fixed effects will be imposed. Must be one of the following, "none", "unit", "time", or "two-way". The default is "unit".

cl

a string indicator the cluster variable. The default value is NULL. If cl = NULL, bootstrap will be blocked at unit level (only for non-parametric bootstrap).

r

an integer specifying the number of factors. If CV = TRUE, the cross validation procedure will select the optimal number of factors from r to 5.

lambda

a single or sequence of positive numbers specifying the hyper-parameter sequence for matrix completion method. If lambda is a sequence and CV = 1, cross-validation will be performed.

nlambda

an integer specifying the length of hyper-parameter sequence for matrix completion method. Default is nlambda = 10.

CV

a logical flag indicating whether cross-validation will be performed to select the optimal number of factors or hyper-parameter in matrix completion algorithm. If r is not specified, the procedure will search through r = 0 to 5.

criterion

a string specifying the criteria used for determining the number of factors. Choose from c("mspe", "pc"). "mspe" stands for the mean squared prediction error obtained through the loocv procedure, and "pc" stands for a kind of information criterion. If criterion = "pc", the number of factors that minimize "pc" will be selected. Default is criterion = "mspe".

k

a positive integer specifying cross-validation times for matrix completion algorithm. Default is k = 5.

EM

a logical flag indicating whether an Expectation Maximization algorithm will be used (Gobillon and Magnac 2016).

estimator

a string that controls the estimation method, either "ife" (interactive fixed effects) or "mc" (the matrix completion method).

se

a logical flag indicating whether uncertainty estimates will be produced.

nboots

an integer specifying the number of bootstrap runs. Ignored if se = FALSE.

inference

a string specifying which type of inferential method will be used, either "parametric" or "nonparametric". "parametric" is recommended when the number of treated units is small. parametric bootstrap is not valid for matrix completion method. Ignored if estimator = "mc".

cov.ar

an integer specifying order of the auto regression process that the residuals follow. Used for parametric bootstrap procedure when data is in the form of unbalanced panel. The default value is 1.

parallel

a logical flag indicating whether parallel computing will be used in bootstrapping and/or cross-validation. Ignored if se = FALSE.

cores

an integer indicating the number of cores to be used in parallel computing. If not specified, the algorithm will use the maximum number of logical cores of your computer (warning: this could prevent you from multi-tasking on your computer).

tol

a positive number indicating the tolerance level.

seed

an integer that sets the seed in random number generation. Ignored if se = FALSE and r is specified.

min.T0

an integer specifying the minimum value of pre-treatment periods. Treated units with pre-treatment periods less than that will be removed automatically. This item is important for unbalanced panels. If users want to perform cross validation procedure to select the optimal number of factors from (r.min, r.max), they should set min.T0 larger than (r.max+1) if no individual fixed effects or (r.max+2) otherwise. If there are too few pre-treatment periods among all treated units, a smaller value of r.max is recommended.

alpha

a positive number in the range of 0 and 1 specifying significant levels for uncertainty estimates. The default value is alpha = 0.05.

normalize

a logic flag indicating whether to scale outcome and covariates. Useful for accelerating computing speed when magnitude of data is large. The default is normalize=FALSE.

Details

gsynth implements the generalized synthetic control method. It imputes counterfactuals for each treated unit using control group information based on a linear interactive fixed effects model that incorporates unit-specific intercepts interacted with time-varying coefficients. It generalizes the synthetic control method to the case of multiple treated units and variable treatment periods, and improves efficiency and interpretability. It allows the treatment to be correlated with unobserved unit and time heterogeneities under reasonable modeling assumptions. With a built-in cross-validation procedure, it avoids specification searches and thus is easy to implement. Data must be with a dichotomous treatment.

Value

Y.dat

a matrix storing data of the outcome variable.

Y

name of the outcome variable.

D

name of the treatment variable.

X

name of the time-varying control variables.

index

name of the unit and time indicators.

id

a vector of unit IDs.

time

a vector of time periods.

obs.missing

a matrix storing status of each unit at each time point. 0 for missing, 1 for control group units, 2 for treat group units at pre-treatment period, 3 for treat group units at post-treatment period, and 4 for removed treated group units. Useful for unbalanced panel data.

id.tr

a vector of IDs for the treatment units.

id.co

a vector of IDs for the control units.

removed.id

a vector of IDs for units that are removed.

D.tr

a matrix of treatment indicator for the treated unit outcome.

I.tr

a matrix of observation indicator for the treated unit outcome.

Y.tr

data of the treated unit outcome.

Y.ct

predicted counterfactuals for the treated units.

Y.co

data of the control unit outcome.

eff

difference between actual outcome and predicted Y(0).

Y.bar

average values of Y.tr, Y.ct, and Y.co over time.

att

average treatment effect on the treated over time (it is averaged based on the timing of the treatment if it is different for each unit).

att.avg

average treatment effect on the treated.

force

user specified force option.

sameT0

TRUE if the timing of the treatment is the same.

T

the number of time periods.

N

the total number of units.

p

the number of time-varying observables.

Ntr

the number of treated units.

Nco

the number of control units.

T0

a vector that stores the timing of the treatment for balanced panel data.

tr

a vector indicating treatment status for each unit.

pre

a matrix indicating the pre-treatment/non-treatment status.

post

a matrix indicating the post-treatment status.

r.cv

the number of factors included in the model – either supplied by users or automatically chosen via cross-validation.

lambda.cv

the optimal hyper-parameter in matrix completion method chosen via cross-validation.

res.co

residuals of the control group units.

beta

coefficients of time-varying observables from the interactive fixed effect model.

sigma2

the mean squared error of interactive fixed effect model.

IC

the information criterion.

PC

the proposed criterion for determining factor numbers.

est.co

result of the interactive fixed effect model based on the control group data. An interFE object.

eff.cnt

difference between actual outcome and predicted Y(0); rearranged based on the timing of the treatment.

Y.tr.cnt

data of the treated unit outcome, rearranged based on the timing of the treatment.

Y.ct.cnt

data of the predicted Y(0), rearranged based on the timing of the treatment.

MSPE

mean squared prediction error of the cross-validated model.

CV.out

result of the cross-validation procedure.

niter

the number of iterations in the estimation of the interactive fixed effect model.

factor

estimated time-varying factors.

lambda.co

estimated loadings for the control group.

lambda.tr

estimated loadings for the treatment group.

wgt.implied

estimated weights of each of the control group unit for each of the treatment group unit.

mu

estimated ground mean.

xi

estimated time fixed effects.

alpha.tr

estimated unit fixed effects for the treated units.

alpha.co

estimated unit fixed effects for the control units.

validX

a logic value indicating if multicollinearity exists.

inference

a string indicating bootstrap procedure.

est.att

inference for att.

est.att.avg

inference for att.avg.

est.beta

inference for beta.

est.ind

inference for att of each treated unit.

att.avg.boot

bootstrap results for att.avg.

att.boot

bootstrap results for att.

beta.boot

bootstrap results for beta.

Author(s)

Yiqing Xu <yiqingxu@stanfprd.edu>, Stanford University

Licheng Liu <liulch@mit.edu>, M.I.T.

References

Laurent Gobillon and Thierry Magnac, 2016. "Regional Policy Evaluation: Interactive Fixed Effects and Synthetic Controls." The Review of Economics and Statistics, July 2016, Vol. 98, No. 3, pp. 535–551.

Yiqing Xu. 2017. "Generalized Synthetic Control Method: Causal Inference with Interactive Fixed Effects Models." Political Analysis, Vol. 25, Iss. 1, January 2017, pp. 57-76.

Athey S, Bayati M, Doudchenko N, et al. Matrix completion methods for causal panel data models[J]. arXiv preprint arXiv:1710.10251, 2017.

For more details, see https://yiqingxu.org/packages/gsynth/gsynth_examples.html.

For more details about the matrix completion method, see https://github.com/susanathey/MCPanel.

See Also

plot.gsynth and print.gsynth

Examples

1
2
3
4
5
6
library(gsynth)
data(gsynth)
out <- gsynth(Y ~ D + X1 + X2, data = simdata, parallel = FALSE, 
              index = c("id","time"), force = "two-way",
              CV = TRUE, r = c(0, 5), se = FALSE) 
print(out) 

Example output

Cross-validating ... 
 r = 0; sigma2 = 4.43251; IC = 1.48897; MSPE = 2.37280
 r = 1; sigma2 = 1.42977; IC = 0.75261; MSPE = 1.71737
 r = 2; sigma2 = 0.93928; IC = 0.71688; MSPE = 1.14525*
 r = 3; sigma2 = 0.88977; IC = 1.03647; MSPE = 1.15013
 r = 4; sigma2 = 0.83864; IC = 1.34035; MSPE = 1.21356
 r = 5; sigma2 = 0.79605; IC = 1.64062; MSPE = 1.23830

 r* = 2Call:
gsynth.formula(formula = Y ~ D + X1 + X2, data = simdata, index = c("id", 
    "time"), force = "two-way", r = c(0, 5), CV = TRUE, se = FALSE, 
    parallel = FALSE)

Average Treatment Effect on the Treated:
[1] 5.543

   ~ by Period (including Pre-treatment Periods):
 [1]  0.392362  0.276705 -0.274839  0.440915 -0.889404  0.593545  0.527967
 [8]  0.170937  0.611304  0.170545 -0.272413  0.094706 -0.651881  0.573748
[15] -0.469730 -0.077895 -0.141584 -0.156434 -0.914963 -0.003591  1.236193
[22]  1.629796  2.711476  3.466495  5.739896  5.280624  8.435863  7.839314
[29]  9.454987  9.638255

Coefficients for the Covariates:
    [,1]
X1 1.021
X2 3.052

Uncertainty estimates not available.
Call:
gsynth.formula(formula = Y ~ D + X1 + X2, data = simdata, index = c("id", 
    "time"), force = "two-way", r = c(0, 5), CV = TRUE, se = FALSE, 
    parallel = FALSE)

Average Treatment Effect on the Treated:
[1] 5.543

   ~ by Period (including Pre-treatment Periods):
 [1]  0.392362  0.276705 -0.274839  0.440915 -0.889404  0.593545  0.527967
 [8]  0.170937  0.611304  0.170545 -0.272413  0.094706 -0.651881  0.573748
[15] -0.469730 -0.077895 -0.141584 -0.156434 -0.914963 -0.003591  1.236193
[22]  1.629796  2.711476  3.466495  5.739896  5.280624  8.435863  7.839314
[29]  9.454987  9.638255

Coefficients for the Covariates:
    [,1]
X1 1.021
X2 3.052

Uncertainty estimates not available.

gsynth documentation built on Aug. 6, 2021, 9:07 a.m.