MoransI()
Summary
Computes statistics for Moran's I, a measure of spatial autocorrelation.
Changes
Added to Version 2017.
Syntax
array = MoransI(string layer_bar_set, string field_spec, array options)
| Argument | Contents |
|---|---|
| layer_bar_set | The layer|set of an area layer |
| field_spec | The full field spec of the field of interest |
| Options | Type | Contents |
|---|---|---|
| Clustering | String | A full field spec for Adjacency clustering |
| Adjacency | String | The type of adjacency: "Edge" (default), "Node" or "Island" |
| Matrix | String | The adjacency value needed: "Adjacency" (default), "Adjacency Level", "Common Border Length" or "Inter-centroid Distance" |
| Search Distance | Number | A numeric value, used for Island Adjacency, in User Units (default= 1 mile) |
| Temp | String | A path for temporary files (default is the current temporary path) |
Returns
Returns an options array with the Moran's I statistics:
| Option | Contents |
|---|---|
| Observations | The number of cells |
| S1 | The S1 statistic |
| S2 | The S2 statistic |
| Sum of Weights | The sum of the spatial weights |
| Moran's I | The measure of spatial autocorrelation |
| Expected Value | The expected value, E(I) = -1 / (N - 1) |
| Std Error | The standard error |
| 95% C.I. Upper | The upper bound of the 95% confidence interval |
| 95% C.I. Lower | The lower bound of the 95% confidence interval |
Notes
-
Moran's I is -1 for perfect dispersion (such as a checkerboard), 0 for a random arrangement, and close to 1 for high spatial autocorrelation.
-
The Clustering option is Group by the chosen field. For example, using the State field for Counties will compute adjacency based on their cluster (group) code.
-
In the Matrix option, "Common Border Length" is the sum of the lengths of the border in common between the two regions, and "Adjacency Level" is Common Border Length / Average Perimeter.
Example
a = MoransI("County|", "County.Population",)
Error Code
| Error Type | Meaning |
|---|---|
| Error | Inputs are not valid or could not generate the Moran's I value |