Genera tabla próxima (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.
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.
-
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 INPUT_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 de entrada y 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 un 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.
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,...] |
Las entidades próximas que se utilizan para buscar las entidades más cercanas a 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), 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. Puede especificar cualquier unidad de distancia si reemplaza la unidad predeterminada 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 and 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 se mide desde el eje x (eje horizontal) hacia la dirección de la línea que conecta una entidad de entrada a la entidad más cercana en las ubicaciones más cercanas, y varía entre 0 y 180 o entre 0 y -180 grados decimales.
| Boolean |
closest (Opcional) |
Determina si se ubican y se devuelven sólo las entidades más cercanas o si se devuelven 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 GenerarTablaPróxima 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. # Author: ESRI # import system modules import arcpy from arcpy import env # set workspace environment env.workspace = "C:/data/input/gnt.gdb" # set required parameters inFeatures = "campsites" nearFeatures = ["parks", "trails"] outTable = "near_parks_trails" # optional parameters searchRadius = '1500 Meters' location = 'NO_LOCATION' angle = 'NO_ANGLE' closest = 'ALL' closestCount = 3 # find crime locations within the search radius arcpy.GenerateNearTable_analysis(inFeatures, nearFeatures, outTable, searchRadius, location, angle, closest, closestCount)