AdjacencyForWinBUGS.zip

To install:

1. Save the file: AdjacencyForWinBUGS.zip to your local hard drive
2. Extract contents
3. Double click AdjacencyForWinBUGS.esriAddIn file
4. Open ArcMap 10
5. Click on the Customize menu and the Customize Mode… item
6. On the Customize dialog click the Commands tab
7. Scroll down and click on Fox Tools in the Categories list
8. Drag the Adjacency For WinBUGS button to a toolbar on the ArcMap 10 interface

To use:

1. Click the AdjacencyForWinBUGS button to open the Adjacency For WinBUGS dialog (Figure 1).
2. Choose an editable polygon shapefile.
3. Click the Browse button and identify the output directory.
4. Click OK button.
5. Program execution:
   1. The folder specified by the user in the Output Directory textbox is created.
      1. The folder’s name will have the following structure:  User identified directory + Layer Name + “_Adjacency_“ + Iterative Number.
      2. Characters within the new folder’s name that are problematic to ArcMap will be replaced with underscore characters.
      3. Problematic characters include ~`!”@#$%^&*()+=[]{}:;,.’<>?/\ and blank spaces.
   2. The field Adj_ID is deleted if it already exists in the specified polygon theme.
   3. The field Adj_ID is added to the selected polygon theme. Each polygon is then number sequentially as they occur in the polygon theme. Polygons are indentified by this value in the output files.
   4. Polygons are iteratively processed
   5. The program creates four comma delimited text files in the newly created folder, Raw.txt, Adj.txt, Num.txt, and SumNumNeigh.txt (Figure 2). The values within Raw.txt, Adj.txt, and Num.txt are synchronized with the order of input polygons (i.e. the first line of each file refers to the input polygon Adj_ID = 1, the second line refers to input polygon Adj_ID = 2, etc).
      1. Raw.txt: each line in the output file contains a list of numbers. The first number in the list is the Adj_ID of the input polygon; all subsequent numbers in the list are the Adj_ID values of polygons adjacent to the input polygon. Only the input polygon’s Adj_ID will be listed if it has no adjacent neighbors.
      2. Adj.txt: is identical to the Raw.txt file with one exception, the leading Adj_ID value of the input polygon is omitted.  If the input polygon does not have any adjacent neighbors, then a blank line is entered.
      3. Num.txt: contains the number of neighbors for each input polygon.
      4. SumNumNeigh.txt: the sum of values contained in the Num.txt.

Figure 2. An example of a polygon input layer and its resulting output file.