Disponible con una licencia de Network Analyst.
Resumen
Construye un archivo de matriz de ponderaciones espaciales (.swm) mediante un dataset de red, que define las relaciones espaciales de la entidad en términos de la estructura de red subyacente.
Heredado:
Esta es una herramienta obsoleta. Hemos creado una herramienta nueva con mejoras y funcionalidad nueva, incluida la admisión de redes de servicios de portal. Consulte la herramienta actualizada Generar matriz de ponderaciones espaciales de red.
Ilustración
Uso
-
La salida de esta herramienta es un archivo de matriz de ponderaciones espaciales (.swm). Las herramientas que requieren que especifique la opción Conceptualización de relaciones espaciales admitirán 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 completa del archivo de ponderaciones espaciales que se creó con esta herramienta.
-
Esta herramienta se diseñó para trabajar solo con datos de Clase de entidad de entrada de punto.
-
Una matriz de ponderaciones espaciales cuantifica las relaciones espaciales que existen entre las entidades del dataset. Muchas herramientas de la caja de herramientas Estadística espacial evalúan cada entidad en el contexto de las entidades vecinas. El archivo de matriz de ponderaciones espaciales define esas relaciones de vecino. Para esta herramienta, las relaciones de vecino se basan en el tiempo o la distancia que existe entre las entidades, en el caso en que el recorrido se limita a una red. Para obtener más información acerca de las ponderaciones espaciales y los archivos de matriz de ponderaciones espaciales, consulte Ponderaciones espaciales.
-
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 agregando un nuevo campo de tipo entero (Agregar campo) a la tabla de clases de entidad y calculando los valores de campo de modo que sean iguales al campo FID o OBJECTID (Calcular campo). Dado que los valores de los campos FID y OBJECTID pueden cambiar al copiar o editar una clase de entidad, estos campos no se pueden usar directamente para el parámetro Id. único.
-
El parámetro Cantidad máxima de vecinos especifica el número exacto de vecinos que se asociarán con cada entidad. El Valor límite de impedancia invalida el parámetro del número de vecinos, de modo que algunas entidades pueden tener menos vecinos si el número de vecinos especificado no se encuentra dentro del valor límite de la distancia o del tiempo.
-
Puede definir las relaciones espaciales mediante la jerarquía del dataset de red, si la posee, mediante el parámetro Utilizar jerarquía en el análisis. La jerarquía clasifica los ejes de la red en carreteras primarias, secundarias y locales. Cuando utiliza la jerarquía de la red para crear relaciones espaciales entre entidades, la preferencia será recorrer las carreteras primarias sobre las secundarias y las secundarias sobre las locales.
Si está utilizando datasets de red creados previamente desde Street Map Premium for ArcGIS que utilizan un modo de viaje, puede que algunas opciones de los parámetros estén rellenadas previamente y que no se puedan cambiar.
-
Esta herramienta no respeta la configuración de entorno del sistema de coordenadas de salida. Toda la geometría de entidad se proyecta para que coincida con la referencia espacial asociada con el dataset de red antes del análisis. El archivo de matriz de ponderaciones espaciales resultante que crea esta herramienta reflejará las relaciones espaciales definidas mediante la referencia espacial del Dataset de red. Al realizar un análisis con un archivo de matriz de ponderaciones espaciales de red, es recomendable proyectar la clase de entidad de entrada para que concuerde con el sistema de coordenadas del dataset de red que se utilizó para crear el SWM de la red.
Sugerencia:
Muchas organizaciones mantienen sus propios datasets de red de calles a los que puede que ya tenga acceso. Como alternativa, Street Map Premium for ArcGIS incorpora datasets de red predefinidos en formato SDC que incluyen Norteamérica, Latinoamérica, Europa, Medio Oriente, África, Japón, Australia y Nueva Zelanda. Estos datasets de red se pueden utilizar directamente mediante 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. En algunos casos, los nulos se almacenan como valores negativos muy grandes en shapefiles. Esto puede ocasionar resultados inesperados. Consulte Cuestiones de geoprocesamiento para el shapefile de salida para obtener más información.
Sintaxis
arcpy.stats.GenerateNetworkSpatialWeights(Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Input_Network, Impedance_Attribute, {Impedance_Cutoff}, {Maximum_Number_of_Neighbors}, {Barriers}, {U-turn_Policy}, {Restrictions}, {Use_Hierarchy_in_Analysis}, {Search_Tolerance}, {Conceptualization_of_Spatial_Relationships}, {Exponent}, {Row_Standardization}, {Travel_Mode}, {Time_of_Day})
Parámetro | Explicación | Tipo de datos |
Input_Feature_Class | Clase de entidad de puntos para la cual se evaluarán las relaciones espaciales de red entre las entidades. | Feature Class |
Unique_ID_Field | Un campo de entero que contiene un valor diferente para cada entidad en la clase de entidad de entrada. Si no tiene un campo de Id. único, puede crear uno agregando un campo de tipo entero a la tabla de clases de entidad y calculando los valores de campo para que equivalgan a los campos FID o OBJECTID. | Field |
Output_Spatial_Weights_Matrix_File | Archivo de matriz de ponderaciones espaciales de salida (.swm). | File |
Input_Network | El dataset de red para el que se definirán las relaciones espaciales entre las entidades en la clase de entidad de entrada. La mayoría de las veces los datasets de red representan redes de calles, pero también pueden representar otras redes de transporte. El dataset de red debe tener al menos un atributo de coste basado en el tiempo y uno basado en la distancia. | Network Dataset Layer |
Impedance_Attribute | El tipo de unidades de coste que se utilizará como impedancia en el análisis. | String |
Impedance_Cutoff (Opcional) | Especifica un valor límite para las conceptualizaciones de relaciones espaciales INVERSE y FIXED. Introduzca este valor utilizando las unidades que se especifican en el parámetro Impedance_Attribute. Un valor de cero indica que no se aplica ningún 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 entrada y la cantidad de entidades. | Double |
Maximum_Number_of_Neighbors (Opcional) | Un entero que refleja la cantidad máxima de vecinos que se debe buscar para cada entidad. | Long |
Barriers (Opcional) | El nombre de una clase de entidad de puntos con entidades que representan intersecciones bloqueadas, cierres de carreteras, sitios de accidentes u otras ubicaciones donde el recorrido en la red está bloqueado. | Feature Layer |
U-turn_Policy (Opcional) | Especifica restricciones opcionales de cambios de sentido.
| String |
Restrictions [Restriction,...] (Opcional) | Una lista de restricciones. Marque las restricciones que se deben respetar en los cálculos de las relaciones espaciales. | String |
Use_Hierarchy_in_Analysis (Opcional) | Especifica si se utilizará una jerarquía en el análisis.
| Boolean |
Search_Tolerance (Opcional) | Umbral de búsqueda utilizado para ubicar entidades de la Input_Feature_Class en el dataset de red. Este parámetro incluye un valor de búsqueda y las unidades para la tolerancia. | Linear Unit |
Conceptualization_of_Spatial_Relationships (Opcional) | Determina el modo en que se especifica el peso asociado con cada relación espacial.
| String |
Exponent (Opcional) | Parámetro del cálculo de la INVERSE Conceptualization_of_Spatial_Relationships. Los valores típicos son 1 o 2. Los pesos caen más rápidamente con la distancia a medida que aumenta el valor del exponente. | Double |
Row_Standardization (Opcional) | Especifica si se aplica estandarización de filas. 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.
| Boolean |
Travel_Mode (Opcional) | El modo de transporte para el análisis. Personalizado siempre es una opción. Para que aparezcan otros modos de viaje, estos deben estar presentes en el dataset de red especificado en el parámetro Dataset de red. Un modo de viaje se define en un dataset de red y proporciona valores de invalidación para los parámetros que modelan coches, camiones, peatones u otros modos de viaje. | String |
Time_of_Day (Opcional) | Especifica si en los tiempos de viaje se debe tener en cuenta el estado del tráfico. El estado del tráfico, sobre todo en áreas urbanas, puede afectar considerablemente al área recorrida en un tiempo de viaje determinado. Si no se especifica ninguna fecha u hora, no se tendrá en cuenta el tráfico al calcular la distancia recorrida durante un determinado tiempo de viaje. | Date |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta GenerateNetworkSpatialWeights.
import arcpy
arcpy.env.workspace = "c:/data"
arpcy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID",
"network6Neighs.swm", "Streets_ND",
"MINUTES", 10, 6, "#", "ALLOW_UTURNS",
"#", "USE_HIERARCHY", "#", "INVERSE",
1, "ROW_STANDARDIZATION")
El siguiente script de Phython independiente muestra cómo utilizar la herramienta GenerateNetworkSpatialWeights.
# Create a Spatial Weights Matrix based on Network Data
# Import system modules
import arcpy
# Set the environment property to overwrite existing output
arcpy.env.overwriteOutput = True
# Check out the Extensión ArcGIS Network Analyst (required for the Generate Network Spatial Weights tool)
arcpy.CheckOutExtension("Network")
# Local variables...
workspace = r"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
# Create Spatial Weights Matrix based on Network Data
# Process: Generate Network Spatial Weights...
nwm = arcpy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID",
"network6Neighs.swm", "Streets_ND",
"MINUTES", 10, 6, "#", "ALLOW_UTURNS",
"#", "USE_HIERARCHY", "#", "INVERSE",
1, "ROW_STANDARDIZATION")
# Create Spatial Weights Matrix based on Euclidean Distance
# Process: Generate Spatial Weights Matrix...
swm = arcpy.GenerateSpatialWeightsMatrix_stats("Hospital.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS",
"#", "#", "#", 6)
# Calculate Moran's Index of Spatial Autocorrelation for
# average hospital visit times using Network Spatial Weights
# Process: Spatial Autocorrelation (Morans I)...
moransINet = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
"NO_REPORT", "GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE", "#",
"network6Neighs.swm")
# Calculate Moran's Index of Spatial Autocorrelation for
# average hospital visit times using Euclidean Spatial Weights
# Process: Spatial Autocorrelation (Morans I)...
moransIEuc = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
"NO_REPORT", "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()
Información de licenciamiento
- Basic: Requiere Network Analyst
- Standard: Requiere Network Analyst
- Advanced: Requiere Network Analyst