{smcl}
{hline}
{cmd:help: {helpb spweight}}{space 55} {cmd:dialog:} {bf:{dialog spweight}}
{hline}

{bf:{err:{dlgtab:Title}}}

{bf: spweight: Cross Section and Panel Spatial Weight Matrix}

{bf:{err:{dlgtab:Syntax}}}

{p 5 5 6}
{opt spweight} {varlist} (min=2 max=2) , {opt p:anel(numlist)} {opt t:ime(numlist)}{p_end} 
{p 7 5 6} 
{err: [} {opt m:atrix(weight_name)} {opt s:tand} {opt inv inv2} {opt e:igw(name)} {opt tab:el} {opt ptab:el} {err:]}{p_end}

{bf:{err:{dlgtab:Description}}}

{p 2 2 2}{cmd:spweight} creates or generates both Cross Section and Panel Spatial Weight Matrix among neighbor locations, for using in spatial regression analysis.{p_end}

{p 2 2 2}{cmd:spweight} also creates standardized Weight Matrix with both inverse and inverse squared form and Eigenvalues variable vector.{p_end}

{p 2 2 2} Raw data for neighbor locations units must be put as shown in the sample data file {cmd: (spweight.dta)}.{p_end}

{p 2 2 2}{cmd:spweight} is differnt from {helpb spweightcs} and  {helpb spweightxt}, in entering data, you dont have to enter data here in symmetric way (i,j) and (j,i).{p_end}

{p2colreset}{...}
{bf:{err:{dlgtab:Options}}}

{col 4}{opt p:anel}{col 15}Number of all locations units

{col 4}{opt t:ime}{col 15}Number of time series in each cross section (must be balanced)

{col 4}{opt m:atrix}{col 15}Specify name of spatial weight matrix, that will be created

{col 4}{opt s:tand}{col 15}Use row-standardized weight matrix.
		 standardized weight matrix has each row sum equals 1.
		 Default is Binary spatial weight matrix which each element is 0 or 1

{col 4}{opt inv}{col 15}Use Inverse Standardized Weight Matrix (1/W)

{col 4}{opt inv2}{col 15}Use Inverse Squared Standardized Weight Matrix (1/W^2)

{col 4}{opt e:igw(name)}{col 15}Set name of new eigenvalues variable vector 

{col 4}{opt tab:le}{col 15}Display Cross Section Spatial Weight Matrix Table

{col 4}{opt ptab:le}{col 15}Display Panel Spatial Weight Matrix Table

{bf:{err:{dlgtab:Saved Results}}}

{p 2 4 2 }{cmd:spweight} saves the following results in {cmd:e()}:

Matrixes
{col 4}{cmd:e(wcs)}{col 15}Cross Section Spatial Weight Matrix.
{col 4}{cmd:e(wxt)}{col 15}Panel Spatial Weight Matrix.

{col 4}{cmd:e(ewcs)}{col 15}Eigenvalues Cross Section.
{col 4}{cmd:e(ewxt)}{col 15}Eigenvalues Panel Data.

{bf:{err:{dlgtab:Example}}}

	{stata clear all}
	{stata sysuse spweight1.dta, clear}
	{stata list v1 v2}
	{stata spweight v1 v2 , panel(7) matrix(W) eigw table}

	{stata ereturn list}
	{stata matrix list e(ewcs)}
	{stata matrix list e(wcs)}

{hline}

	{stata clear all}
	{stata sysuse spweight2.dta, clear}
	{stata list v1 v2}
	{stata db spweight}
	{stata spweight v1 v2 , panel(4) time(1) matrix(W) eigw table}
	{stata ereturn list}
	{stata matrix list e(ewcs)}
	{stata matrix list e(wcs)}

	{stata spweight v1 v2 , panel(4) time(2) matrix(W) eigw table}
	{stata spweight v1 v2 , panel(4) time(4) matrix(W) stand eigw table}
	{stata spweight v1 v2 , panel(4) time(4) matrix(W) stand eigw inv table}
	{stata spweight v1 v2 , panel(4) time(4) matrix(W) stand eigw inv2 table}
	{stata spweight v1 v2 , panel(4) time(4) matrix(W) table}
	{stata spweight v1 v2 , panel(4) time(4) matrix(W) ptable}
	{stata spweight v1 v2 , panel(4) time(4) matrix(W) table ptable}

. list v1 v2
     +---------+
     | v1   v2 |
     |---------|
  1. |  1    2 |
  2. |  1    3 |
  3. |  1    4 |
  4. |  2    3 |
  5. |  3    4 |
     +---------+

{p 2 2 2} The final shape of cross section and panel spatial weight matrix will be as follows:{p_end}

    ------------------------------------------
     {bf:Name} |   {bf:c1}      {bf:c2}      {bf:c3}      {bf:c4}   {bf:Row}
    ------+-----------------------------------
       {bf:r1} |    0      {bf:{red:1}}      {bf:{red:1}}      {bf:{red:1}}      {bf:3} 
       {bf:r2} |    {bf:{red:1}}      0      {bf:{red:1}}      0      {bf:2} 
       {bf:r3} |    {bf:{red:1}}      {bf:{red:1}}      0      {bf:{red:1}}      {bf:3} 
       {bf:r4} |    {bf:{red:1}}      0      {bf:{red:1}}      0      {bf:2} 
    ------+-----------------------------------
      {bf:Col} |    {bf:3}      {bf:2}      {bf:3}      {bf:2}     {bf:10} 
    ------------------------------------------

            (1)               (2)               (3)               (4)         
    |-----------------|-----------------|-----------------|-----------------|
(1) |  0   0   0   0  |  {bf:{red:1}}   0   0   0  |  {bf:{red:1}}   0   0   0  |  {bf:{red:1}}   0   0   0  |
    |  0   0   0   0  |  0   {bf:{red:1}}   0   0  |  0   {bf:{red:1}}   0   0  |  0   {bf:{red:1}}   0   0  |
    |  0   0   0   0  |  0   0   {bf:{red:1}}   0  |  0   0   {bf:{red:1}}   0  |  0   0   {bf:{red:1}}   0  |
    |  0   0   0   0  |  0   0   0   {bf:{red:1}}  |  0   0   0   {bf:{red:1}}  |  0   0   0   {bf:{red:1}}  |
    |-----------------|-----------------|-----------------|-----------------|
(2) |  {bf:{red:1}}   0   0   0  |  0   0   0   0  |  {bf:{red:1}}   0   0   0  |  0   0   0   0  |
    |  0   {bf:{red:1}}   0   0  |  0   0   0   0  |  0   {bf:{red:1}}   0   0  |  0   0   0   0  |
    |  0   0   {bf:{red:1}}   0  |  0   0   0   0  |  0   0   {bf:{red:1}}   0  |  0   0   0   0  |
    |  0   0   0   {bf:{red:1}}  |  0   0   0   0  |  0   0   0   {bf:{red:1}}  |  0   0   0   0  |
    |-----------------|-----------------|-----------------|-----------------|
(3) |  {bf:{red:1}}   0   0   0  |  {bf:{red:1}}   0   0   0  |  0   0   0   0  |  {bf:{red:1}}   0   0   0  |
    |  0   {bf:{red:1}}   0   0  |  0   {bf:{red:1}}   0   0  |  0   0   0   0  |  0   {bf:{red:1}}   0   0  |
    |  0   0   {bf:{red:1}}   0  |  0   0   {bf:{red:1}}   0  |  0   0   0   0  |  0   0   {bf:{red:1}}   0  |
    |  0   0   0   {bf:{red:1}}  |  0   0   0   {bf:{red:1}}  |  0   0   0   0  |  0   0   0   {bf:{red:1}}  |
    |-----------------|-----------------|-----------------|-----------------|
(4) |  {bf:{red:1}}   0   0   0  |  0   0   0   0  |  {bf:{red:1}}   0   0   0  |  0   0   0   0  |
    |  0   {bf:{red:1}}   0   0  |  0   0   0   0  |  0   {bf:{red:1}}   0   0  |  0   0   0   0  |
    |  0   0   {bf:{red:1}}   0  |  0   0   0   0  |  0   0   {bf:{red:1}}   0  |  0   0   0   0  |
    |  0   0   0   {bf:{red:1}}  |  0   0   0   0  |  0   0   0   {bf:{red:1}}  |  0   0   0   0  |
    |-----------------|-----------------|-----------------|------------------

{hline}

{p 2 2 2}if any element has no neighbor with other locations, then you will set its number in both v1 and v2 variables.{p_end}

{p 2 2 2}for example here element (5) has no neighbor with other locations (1, 2, 3,4), then you will set it self number in both v1 and v2 variables.{p_end}

	{stata clear all}
	{stata sysuse spweight3.dta, clear}
	{stata list v1 v2}
	{stata spweight v1 v2 , panel(5) matrix(W) eigw table}

 list v1 v2

     +---------+
     | v1   v2 |
     |---------|
  1. |  1    2 |
  2. |  1    3 |
  3. |  1    4 |
  4. |  2    3 |
  5. |  3    4 |
     |---------|
  6. |  {bf:{red:5}}    {bf:{red:5}} |
     +---------+

+---------------------------------------+
|  Name |  c1   c2   c3   c4   c5 | Row |
|-------+-------------------------+-----|
|    r1 |   0    1    1    1    0 |   3 |
|    r2 |   1    0    1    0    0 |   2 |
|    r3 |   1    1    0    1    0 |   3 |
|    r4 |   1    0    1    0    0 |   2 |
|    r5 |   0    0    0    0    0 |   0 |
|-------+-------------------------+-----|
|   Col |   3    2    3    2    0 |  10 |
+---------------------------------------+
{hline}

{p 2 2 2} After creating cross section panel spatial weight matrix, you can use
{helpb spautoreg}, {helpb gs3sls}, {helpb spregcs}, {helpb spmstar} for cross section spatial regression,
or {helpb spregxt}, {helpb gs2slsxt}, {helpb spglsxt}, {helpb spmstarxt}, {helpb spxttobit} for panel spatial regression to generate eigenvalues vector and standardized weight matrix, and run regression analysis.{p_end}

{bf:{err:{dlgtab:Author}}}

  {hi:Emad Abd Elmessih Shehata}
  {hi:Assistant Professor}
  {hi:Agricultural Research Center - Agricultural Economics Research Institute - Egypt}
  {hi:Email:   {browse "mailto:emadstat@hotmail.com":emadstat@hotmail.com}}
  {hi:WebPage:{col 27}{browse "http://emadstat.110mb.com/stata.htm"}}
  {hi:WebPage at IDEAS:{col 27}{browse "http://ideas.repec.org/f/psh494.html"}}
  {hi:WebPage at EconPapers:{col 27}{browse "http://econpapers.repec.org/RAS/psh494.htm"}}

{bf:{err:{dlgtab:spweight Citation}}}

{phang}{cmd:Shehata, Emad Abd Elmessih (2011)}{p_end}
{phang}{cmd:SPWEIGHT: "Stata Module to Create Cross Section and Panel Spatial Weight Matrix"}{p_end}
	{browse "http://ideas.repec.org/c/boc/bocode/s457325.html"}

	{browse "http://econpapers.repec.org/software/bocbocode/s457325.htm"}

{title:Online Help:}

{p 3 3 2} {helpb gs2slsxt}, {helpb gs3sls}, {helpb spautoreg}, {helpb spcs2xt},
{helpb spglsxt}, {helpb spmstar}, {helpb spmstarxt}, {helpb spregcs}, {helpb spregxt},
{helpb spweight}, {helpb spweightcs}, {helpb spweightxt}, {helpb spxttobit},
{helpb xtidt}. {opt (if installed)}.{p_end}

{psee}
{p_end}