Generar matriz de ponderaciones espaciales (Estadística espacial)

Nivel de licencia:BasicStandardAdvanced

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

Ponderaciones espaciales basadas en una contigüidad de polígonos
Relaciones espaciales basadas en una contigüidad de polígonos, Caso de la Reina: bordes o nodos compartidos.

Uso

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}, {Date_Time_Field}, {Date_Time_Interval_Type}, {Date_Time_Interval_Value})
ParámetroExplicaciónTipo 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 las entidades.

  • INVERSE_DISTANCEEl impacto que una entidad tiene sobre otra disminuye con la distancia.
  • FIXED_DISTANCEEn 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_NEIGHBORSLas entidades k más cercanas se incluyen en este análisis; k es un parámetro numérico especificado.
  • CONTIGUITY_EDGES_ONLYLas entidades de polígono que comparten un límite son vecinas.
  • CONTIGUITY_EDGES_CORNERSLas entidades de polígono que comparten un límite o un nodo son vecinas.
  • DELAUNAY_TRIANGULATIONSe 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.
  • SPACE_TIME_WINDOWLas entidades dentro de una distancia crítica especificada y el cada intervalo de tiempo especificado de cada uno son vecinos.
  • CONVERT_TABLELas relaciones espaciales se definen en una tabla.

Nota: los métodos de Contigüidad de polígono solo están disponibles con una licencia ArcGIS for Desktop Advanced.

String
Distance_Method
(Opcional)

Especifica cómo se calculan las distancias desde cada entidad hasta las entidades vecinas.

  • EUCLIDIANOLa distancia en línea recta entre dos puntos
  • MANHATTANLa 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. Define el tamaño de la ventana Espacio para la conceptualización de la ventana de tiempo espacial de las relaciones espaciales.

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.

Long
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_STANDARDIZATIONLas ponderaciones espaciales son estandarizadas por fila. Cada ponderación se divide por la suma de sus filas.
  • NO_STANDARDIZATIONNo 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.

Table
Date_Time_Field
(Opcional)

Un campo de fecha con una marca de tiempo para cada entidad.

Field
Date_Time_Interval_Type
(Opcional)

Las unidades que se utilizan para medir el tiempo.

  • SEGUNDOSSegundos
  • MINUTOSMinutos
  • HORASHorario
  • DÍASDías
  • SEMANASSemanas
  • MESESMeses
  • AÑOSAños
String
Date_Time_Interval_Value
(Opcional)

Un entero que refleja la cantidad de unidades de tiempo que comprende la ventana de tiempo.

Por ejemplo, si selecciona HORAS para el tipo de intervalo fecha/hora y 3 para el valor del intervalo de fecha/hora, la ventana de tiempo será de 3 horas; las entidades dentro de la ventana espacial especificada y dentro de la ventana de tiempo especificada serán vecinos.

Long

Ejemplo de código

Ejemplo 1 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 2 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

Sistema de coordenadas de salida

La geometría de la entidad se proyecta al Sistema de coordenadas de salida antes del análisis. Por lo tanto, los valores introducidos para el parámetro Distancia de umbral deben coincidir con los que se especificaron en el Sistema de coordenadas de salida. Todos los cálculos matemáticos se basan en la referencia espacial del Sistema de coordenadas de salida. Cuando el entorno del Sistema de coordenadas de salida se basa en grados, minutos y segundos, las distancias geodésicas se calculan en metros mediante la distancia de cuerda.

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/10/2014