Title
spagg - Creates aggregate source or target contagion spatial effect variable
Syntax
Aggregate source contagion
spagg lagvar [if] [in], weightvar(varname) source(varname) target(varname) form(source) link(options) [options]
Aggregate target contagion
spagg lagvar [if] [in], weightvar(varname) source(varname) target(varname) form(target) link(options) [options]
options Description ------------------------------------------------------------------------- time(varname) contains the numeric time variable norowst spatial effect variable not row-standardized nomerge no automatic merge of spatial effect variable into original dataset sename(name) name to be given to created spatial effect variable labelname(name) name of label given to spatial effect variable filename(name) name of file to which spatial effect variable saved -------------------------------------------------------------------------
Description
spagg generates an aggregate source or target contagion spatial effect variable for analysis of spatial dependence in directed dyad data. It can create spatial effect variables for spatial lag, spatial-x and spatial error models. See Neumayer and Plümper (2010) for an exposition of all possible forms of contagion in directed dyad data. See Plümper and Neumayer (2010) for a discussion of model specification in the analysis of spatial dependence. Users must have mmerge.ado already installed. If not, type net search mmerge.ado into the editor and install.
Additional information
See http://personal.lse.ac.uk/neumayer/spagg.htm.
Arguments
lagvar is the variable to be spatially lagged. It is the directed dyadic dependent variable in spatial lag models, a selected independent variable in spatial-x models and a saved regression residual in spatial error models.
weightvar(varname) is the weighting or connectivity variable linking source unit i with target unit j. It must be numeric and must not contain negative values. It may or may not be directed.
source(varname) is the identifying variable of source unit i. It can be a numeric or string variable.
target(varname) is the identifying variable of target unit j. It can be a numeric or string variable.
Options
form(source) or form(target) is required and requests either aggregate source or aggregate target contagion.
time(varname) is an optional argument. If users wish to generate a time-varying spatial effect variable, then the numeric time variable must be stated here.
link(options) is required. The following options are allowed for aggregate source contagion: ik, ki, im, mi. The following options are allowed for aggregate target contagion: jm, mj, jk, kj. Option ik requests that the virtually transformed weighting variable weightvar(varname) is to represent connectivity from source unit i to other source units k. Option ki requests connectivity from other source units k to source unit i. Option im requests connectivity from source unit i to target units m. Option mi requests connectivity from target units m to source unit i. Option jm requests connectivity from target unit j to other target units m. Option mj requests connectivity from other target units m to target unit j. Option jk requests connectivity from target unit j to source units k. Option kj requests connectivity from source units m to target unit j. Which of these options is appropriate depends on the specific hypothesis of spatial dependence to be tested.
norowst requests that the generated spatial effect variable is not row-standardized. See Plümper and Neumayer (2010) for an explanation and discussion of row-standardization. Row-standardization is the default option.
nomerge requests that the generated spatial effect variable is not automatically merged into the original data set.
sename(name) names the generated spatial effect variable. In the default option, if the weighting matrix is row-standardized, then this variable is called SE_var_ag_source_rowst for aggregate source and SE_var_ag_target_rowst for aggregate target contagion. If the weighting matrix is not row-standardized, then this variable is called SE_var_ag_source_norowst and SE_var_ag_target_norowst, respectively. Any previously existing variable with the same name will be replaced.
labelname(name) names the label of the generated spatial effect variable. The default label given is "Aggregate source contagion spatial effect variable" in case of source contagion and "Aggregate target contagion spatial effect variable" in case of target contagion.
filename(name) requests that a dataset containing the generated spatial effect variable is saved in the current working directory under the defined name. In the default option, if the weighting matrix is row-standardized, then a file is saved in the current working directory called SE_file_ag_source_rowst for aggregate source and SE_file_ag_target_rowst for aggregate target contagion. If the weighting matrix is not row-standardized, then the saved file is called SE_file_ag_source_norowst and SE_file_ag_target_norowst, respectively. Any previously existing file with the same name will be replaced.
References
Neumayer, Eric and Plümper, Thomas. 2010. Spatial Effects in Dyadic Data. International Organization 64 (1), pp. 145-165.
Plümper, Thomas and Eric Neumayer. 2010. Model Specification in the Analysis of Spatial Dependence. European Journal of Political Research 49 (3), pp. 418-442.
Examples
. spagg y, w(contiguity) s(source_country) t(target_country) form(source) link(ik) sename(ag_source) filename(ag_source_file)
. spagg y, w(exports) s(source_country) t(target_country) time(year) form(source) link(mi) norowst
. spagg y, w(exports) s(source_country) t(target_country) time(year) form(target) link(jm) nomerge
Authors
Eric Neumayer Department of Geography and Environment London School of Economics and Political Science (LSE) London WC2A 2AE, UK e.neumayer@lse.ac.uk http://personal.lse.ac.uk/neumayer
Thomas Plümper Department of Government University of Essex Wivenhoe Park Colchester CO4 3SQ, UK tpluem@essex.ac.uk http://www.polsci.org/pluemper/