Generar tabla de cercanía (Análisis)
Resumen
Determina las distancias de cada entidad de las entidades de entrada a una o más entidades cercanas de las entidades cercanas, dentro del radio de búsqueda. Los resultados se registran en la tabla de salida.
Más información acerca del cálculo de la proximidad con las herramientas de geoprocesamiento
Ilustración
 |
Uso
-
Esta herramienta se comporta igual que la herramienta Cerca. Sin embargo, en lugar de actualizar las entidades de entrada, crea una nueva tabla de salida. Además, puede encontrar tantas entidades cercanas como especifique el parámetro Cantidad máxima de coincidencias más cercanas.
La tabla de resultados contiene tres campos IN_FID, NEAR_FID y NEAR_DIST de forma predeterminada. A la salida se agregan campos adicionales en función de los parámetros opcionales seleccionados, tal y como se explica en la entrada de parámetro.
- IN_FID: almacena la ID de entidad de la entidad de entrada.
- NEAR_FID: almacena el Id. de entidad de la entidad más cercana.
- NEAR_DIST: almacena la distancia de una entidad de entrada a la entidad más cercana. El valor de este campo está en la unidad lineal del sistema de coordenadas de las entidades de entrada.
-
La tabla de salida puede unirse de nuevo a la clase de entidad de entrada o a una clase de entidad cercana utilizando los campos IN_FID o NEAR_FID.
-
Tanto las entidades de entrada como las entidades próximas pueden ser entidades de puntos, multipuntos, líneas o polígonos.
-
La opción predeterminada para esta herramienta es buscar la distancia de cada entidad de entrada a la entidad cercana más cercana. Elija la opción ALL; es decir, desactive el parámetro Encontrar solo entidad más cercana, para crear una tabla que contenga la distancia entre todas las entradas para todas las entidades cercanas.
-
Los valores para NEAR_FID y NEAR_DIST serán de -1 si no se encuentra una entidad dentro del radio de búsqueda.
-
Si no se especifica un Radio de búsqueda, se utiliza un radio lo suficientemente grande para que se puedan incorporar todas las entidades próximas en el cálculo de la distancia. Si se utiliza el radio de búsqueda predeterminado (no se especifica un radio), la tabla de salida puede resultar muy grande. Por ejemplo, calcular las distancias desde 1.000 puntos en una clase de entidad hasta 1.000 puntos en otra clase de entidad puede arrojar una tabla de salida que contenga 1 millón de registros. Utilice el radio de búsqueda para limitar el número de registros de salida.
-
Tanto las Entidades de entrada como las Entidades próximas pueden estar en el mismo dataset. En ese caso, cuando las entidades de entrada y las entidades próximas están en el mismo registro, el resultado se omitirá para no tener que informar que cada entidad está a 0 unidades de sí misma.
Las entidades de entrada pueden ser de una capa en la que realizó una selección. Las entidades seleccionadas se utilizarán y actualizarán durante la ejecución de la herramienta. Las entidades restantes tendrán valores de los campos creados recientemente (como NEAR_FID y NEAR_DIST) configurados en -1.
Las distancias calculadas por esta herramienta están en la unidad del sistema de coordenadas de las entidades de entrada. Si su entrada está en un sistema de coordenadas geográficas y desea que se midan las distancias de salida en una unidad lineal (a diferencia de los grados decimales), primero debe proyectar su entrada a un sistema de coordenadas proyectadas con la herramienta Proyectar. Para obtener mejores resultados, use una proyección equidistante o una proyección para su área de estudio (UTM, por ejemplo).
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_features |
Las entidades de entrada que pueden ser de tipo punto, polilínea, polígono o multipunto. | Feature Layer |
near_features [near_features,...] |
El valor que se utiliza para buscar las entidades más cercanas de las entidades de entrada. Puede haber una o más entradas de entidades próximas; cada entrada puede ser de tipo punto, polilínea, polígono o multipunto. Cuando se especifican varias entradas de entidades próximas, se agrega un nuevo campo, NEAR_FC, a la tabla de entrada para almacenar las rutas de la clase de entidad de origen que contiene las entidades más cercanas. | Feature Layer |
out_table |
La tabla de resultados que contendrá la información de proximidad, tal como IN_FID, NEAR_FID, NEAR_DIST y otro atributos, tales como la ubicación (NEAR_X, NEAR_Y) y el ángulo (NEAR_ANGLE) de la entidad cercana y NEAR_FC, si es necesario. | Table |
search_radius (Opcional) |
Especifica el radio que se utiliza para buscar entidades cercanas candidatas. Las entidades próximas dentro de este radio se consideran para calcular la entidad más cercana. Si no se especifica un valor, es decir que se utiliza el radio predeterminado (vacío), se consideran todas las entidades próximas para el cálculo. La unidad del radio de búsqueda predeterminado para las unidades del sistema de coordenadas de las entidades de entrada. Las unidades se pueden cambiar a cualquier otra unidad. Sin embargo, esto no tiene ningún impacto en las unidades de NEAR_DIST que se basan en las unidades del sistema de coordenadas de las entidades de entrada. | Linear unit |
location (Opcional) |
Especifica si se escribirán las coordenadas x e y de la ubicación más cercana de la entidad próxima en los nuevos campos NEAR_X y NEAR_Y, respectivamente.
| Boolean |
angle (Opcional) |
Especifica si se calcularán los valores del ángulo cercano en grados decimales y si se escribirán en un campo nuevo, NEAR_ANGLE. Un ángulo cercano mide del eje x (eje horizontal) hacia la dirección de la línea que conecta una entidad de entrada a su entidad más cercana en las ubicaciones más cercanas, y está dentro del rango de 0 a 180 o de 0 a -180 grados decimales, de 0 hacia el este, 90 al norte, 180 (-180°) al oeste, y -90 al sur.
| Boolean |
closest (Opcional) |
Determina si se ubican y se devuelven sólo las entidades más cercanas o todas las entidades dentro del radio de búsqueda.
| Boolean |
closest_count (Opcional) |
Buscar solo el número especificado de entidades más cercanas. Este parámetro no se utilizará si está activada la opción Encontrar sólo entidad más cercana. | Long |
Ejemplo de código
El siguiente miniprograma demuestra cómo utilizar la función GenerateNearTable en la ventana de Python.
import arcpy
arcpy.env.workspace = "C:/data/input/gnt.gdb"
arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
La siguiente secuencia de comandos Python demuestra cómo utilizar la función GenerarTablaPróxima en una secuencia de comandos independiente.
# Name: GenerateNearTable.py
# Description: Finds 3 nearest in the near feature class from the input feature class.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/input/gnt.gdb"
# set required parameters
in_features = "campsites"
near_features = ["parks", "trails"]
out_table = "near_parks_trails"
# optional parameters
search_radius = '1500 Meters'
location = 'NO_LOCATION'
angle = 'NO_ANGLE'
closest = 'ALL'
closest_count = 3
try:
# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius,
location, angle, closest, closest_count)
except:
print arcpy.GetMessages()