Generar matriz de ponderaciones espaciales (Estadística espacial)

Resumen

Construye un archivo de matriz de ponderaciones espaciales (.swm) para representar las relaciones espaciales entre entidades en un dataset.

Más información acerca de cómo funciona Generar matriz de ponderaciones espaciales

Ilustración

Spatial relationships based on polygon contiguity, Queen's case: shared edges or nodes.

Uso

• La salida de esta herramienta es un archivo de matriz de ponderaciones espaciales (.swm). Las herramientas que requieren que especifique una opción de Conceptualización de relaciones espaciales aceptan un archivo de matriz de ponderaciones espaciales; seleccione GET_SPATIAL_WEIGHTS_FROM_FILE para el parámetro Conceptualización de relaciones espaciales y, para el parámetro Archivo de matriz de ponderaciones, especifique la ruta de acceso completa al archivo de ponderaciones espaciales que se creó con esta herramienta.

• Esta herramienta también informa las características del archivo de matriz de ponderaciones espaciales resultante. número de entidades, conectividad, número mínimo, máximo y promedio de vecinos. Se puede acceder a este resumen en la ventana Resultados y se puede visualizar al hacer clic con el botón derecho del ratón en la entrada Mensajes de la ventana Resultados y seleccionar Ver. Al utilizar este resumen se asegura de que todas las entidades tengan como mínimo 1 vecino (lo ideal son 8 vecinos). En general, es conveniente un valor bajo para la conectividad de la entidad, especialmente con los datasets grandes.

• Cuando se utiliza una Conceptualización de relaciones espaciales basada en la distancia, los datos deben estar incluidos en un Sistema de coordenadas proyectadas (en lugar de en un Sistema de coordenadas geográficas).

• Los centroides de entidad se utilizan en los cálculos de distancia para las entidades de línea y polígono. Para multipuntos, polilíneas o polígonos con varias partes, el centroide se calcula utilizando el centro medio ponderado de todas las partes de entidad. La ponderación para las entidades de punto es 1, para las entidades de línea es longitud y para las entidades de polígono es área.

• El campo Id. único se vincula a las relaciones de entidad que derivan de la ejecución de esta herramienta. Por lo tanto, los valores de Id. único deben ser únicos para cada entidad y por lo general deben estar en un campo permanente que se mantiene con la clase de entidad. Si no tiene un campo de Id. único, puede crear uno fácilmente al agregar un nuevo campo de entero a la tabla de clase de entidad y calcular los valores del campo para que coincidan con el campo FID/OID. No puede utilizar el campo FID/OID directamente para el parámetro Id. único.

• Las opciones de contigüidad de polígono, CONTIGUITY_EDGES_ONLY y CONTIGUITY_EDGES_CORNERS, para el parámetro Conceptualización de relaciones espaciales sólo son válidas para las entidades de polígono. Estas opciones están disponibles sólo con la licencia ArcInfo.

• El parámetro Cantidad de vecinos puede invalidar el parámetro Distancia de umbral para las Conceptualizaciones de relaciones espaciales de distancia Inversa o Fija. Si especifica una distancia de umbral de 10 millas y de 3 para la cantidad de vecinos, todas las entidades recibirán un mínimo de 3 vecinos aún cuando se deba incrementar el umbral para buscarlos. La distancia de umbral sólo se incrementa en los casos en los que no se alcanza la cantidad mínima de vecinos.

• La opción CONVERT_TABLE para el parámetro Conceptualización de relaciones espaciales se puede utilizar para convertir un archivo de matriz de ponderaciones espaciales ASCII a un archivo de matriz de ponderaciones espaciales con formato .swm. En primer lugar, deberá introducir los pesos de ASCII en una tabla formateada (con Excel, por ejemplo).

  Precaución:

  Si la tabla incluye los pesos para el auto potencial, estos se omitirán del archivo de salida .swm y se utilizará el valor del auto potencial predeterminado en el análisis. El valor del auto potencial predeterminado para la herramienta Hot_Spot_Analysis es de uno, pero este valor se puede sobrescribir si se especifica un valor para el Campo auto potencial; para las demás herramientas, el valor del auto potencial predeterminado es cero.

• Para las entidades de polígono, casi siempre deseará elegir Fila para el parámetro Estandarización. La estandarización de filas reduce el sesgo cuando la cantidad de vecinos que posee cada entidad es una función del esquema de agregación o proceso de muestreo, en lugar de reflejar la distribución espacial real de la variable que está analizando.

• El tema de ayuda Modelado de relaciones espaciales ofrece información adicional sobre los parámetros de esta herramienta.

Precaución:

Al utilizar shapefiles tenga en cuenta que no pueden almacenar valores nulos. Las herramientas u otros procedimientos que crean shapefiles a partir de entradas sin shapefiles pueden almacenar o interpretar valores nulos como cero. Esto puede ocasionar resultados inesperados. Consulte también Consideraciones de geoprocesamiento para la salida de shapefiles.

Sintaxis

GenerateSpatialWeightsMatrix_stats (Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Conceptualization_of_Spatial_Relationships, Distance_Method, {Exponent}, {Threshold_Distance}, {Number_of_Neighbors}, {Row_Standardization}, {Input_Table})

Parámetro	Explicación	Tipo de datos
Input_Feature_Class	La clase de entidad para la cual se evaluarán las relaciones espaciales de las entidades.	Feature Class
Unique_ID_Field	Un campo entero que contiene un valor diferente para cada entidad en la Clase de entidad de entrada.	Field
Output_Spatial_Weights_Matrix_File	La ruta de acceso completa para el archivo de matriz de ponderaciones espaciales (.swm) que desea crear.	File
Conceptualization_of_Spatial_Relationships	Especifica cómo se conceptualizan las relaciones espaciales entre entidades. INVERSE_DISTANCE —El impacto que una entidad tiene sobre otra disminuye con la distancia. FIXED_DISTANCE —En el análisis, se incluye todo lo que está dentro de una distancia crítica especificada de cada entidad y se excluye todo lo que está fuera de la distancia crítica. K_NEAREST_NEIGHBORS —Las entidades "k" más cercanas se incluyen en este análisis; k es un parámetro numérico especificado. CONTIGUITY_EDGES_ONLY —Las entidades de polígono que comparten un límite son vecinas. CONTIGUITY_EDGES_CORNERS —Las entidades de polígono que comparten un límite o un nodo son vecinas. DELAUNAY_TRIANGULATION —Se crea una malla de triángulos no superpuestos a partir de los centroides de las entidades; las entidades asociadas con los nodos de triángulos que comparten aristas son vecinas. CONVERT_TABLE —Las relaciones espaciales se definen en una tabla. Nota: los métodos de Contigüidad de polígono sólo están disponibles con una licencia ArcInfo.	String
Distance_Method	Especifica cómo se calculan las distancias desde cada entidad hasta las entidades vecinas. EUCLIDEAN_DISTANCE —La distancia en línea recta entre dos puntos MANHATTAN_DISTANCE —La distancia entre dos puntos medida a lo largo de los ejes en ángulos rectos (manzana); se calcula al sumar la diferencia (absoluta) entre las coordenadas x e y	String
Exponent (Opcional)	Parámetro para calcular la distancia inversa. Los valores típicos son 1 o 2.	Double
Threshold_Distance (Opcional)	Especifica una distancia de valor límite para las conceptualizaciones de relaciones espaciales de distancia Inversa y Fija. Introduzca este valor utilizando las unidades que se especifican en el sistema de coordenadas de salida del entorno. Un valor de cero indica que no se aplica ninguna distancia de umbral. Cuando este parámetro queda en blanco, se calcula un valor de umbral predeterminado basado en la extensión de la clase de entidad de salida y la cantidad de entidades.	Double
Number_of_Neighbors (Opcional)	Un entero que refleja la cantidad mínima o la cantidad exacta de vecinos. Para los Vecinos más próximos K, cada entidad tendrá exactamente esta cantidad de vecinos especificada. Para la Distancia inversa o la Distancia fija cada entidad tendrá como mínimo esta cantidad de vecinos (si es necesario, la distancia de umbral se extenderá temporalmente para garantizar que haya esta cantidad de vecinos). Cuando existen polígonos de isla y se selecciona una de las Conceptualizaciones de relaciones espaciales de Contigüidad, esta cantidad especificada de polígonos más cercanos se asociará con esos polígonos de isla.	Integer
Row_Standardization (Opcional)	Se recomienda la estandarización de filas siempre que la distribución de entidades esté potencialmente influenciada debido al diseño de muestreo o a un esquema de agregación impuesto. ROW_STANDARDIZATION —Las ponderaciones espaciales son estandarizadas por fila. Cada ponderación se divide por la suma de sus filas. NO_STANDARDIZATION —No se aplica la estandarización de ponderaciones espaciales.	Boolean
Input_Table (Opcional)	Una tabla que contiene pesos numéricos que relacionan a cada entidad con las demás entidades en la clase de entidad de entrada. Los campos requeridos son: Id. único de la Clase de entidad de entrada, NID (Id. de vecino) y PESO.	File

Ejemplo de código

Ejemplo de GenerateSpatialWeightsMatrix (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta GenerateSpatialWeightsMatrix.

import arcpy arcpy.env.workspace = "C:/data" arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID","euclidean6Neighs.swm","K_NEAREST_NEIGHBORS","#", "#", "#", 6,"NO_STANDARDIZATION") 

Ejemplo de GenerateSpatialWeightsMatrix (secuencia de comandos de Python independiente)

La siguiente secuencia de comandos de Python independiente muestra cómo utilizar la herramienta GenerateSpatialWeightsMatrix.

 # Analyze the spatial distribution of 911 calls in a metropolitan area # using the Hot-Spot Analysis Tool (Local Gi*)  # Import system modules import arcpy  # Set geoprocessor object property to overwrite existing output, by default arcpy.gp.overwriteOutput = True  # Local variables... workspace = "C:/Data"  try:     # Set the current workspace (to avoid having to specify the full path to the feature classes each time)     arcpy.env.workspace = workspace      # Copy the input feature class and integrate the points to snap     # together at 500 feet     # Process: Copy Features and Integrate     cf = arcpy.CopyFeatures_management("911Calls.shp", "911Copied.shp",                          "#", 0, 0, 0)      integrate = arcpy.Integrate_management("911Copied.shp #", "500 Feet")      # Use Collect Events to count the number of calls at each location     # Process: Collect Events     ce = arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")      # Add a unique ID field to the count feature class     # Process: Add Field and Calculate Field     af = arcpy.AddField_management("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",                      "NON_NULLABLE", "NON_REQUIRED", "#",                      "911Count.shp")          cf = arcpy.CalculateField_management("911Count.shp", "MyID", "[FID]", "VB")      # Create Spatial Weights Matrix for Calculations     # Process: Generate Spatial Weights Matrix...      swm = arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID",                         "euclidean6Neighs.swm",                         "K_NEAREST_NEIGHBORS",                         "#", "#", "#", 6,                         "NO_STANDARDIZATION")       # Hot Spot Analysis of 911 Calls     # Process: Hot Spot Analysis (Getis-Ord Gi*)     hs = arcpy.HotSpots_stats("911Count.shp", "ICOUNT", "911HotSpots.shp",                       "GET_SPATIAL_WEIGHTS_FROM_FILE",                      "EUCLIDEAN_DISTANCE", "NONE",                      "#", "#", "euclidean6Neighs.swm")  except:     # If an error occurred when running the tool, print out the error message.     print arcpy.GetMessages() 

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal, Sistema de coordenadas de salida

Sistema de coordenadas de salida

La geometría de entidades se proyecta al sistema de coordenadas de salida antes del análisis.

Información de licencia

ArcView: Sí

ArcEditor: Sí

ArcInfo: Sí