Resumen
Calcula distancias y otra información de proximidad entre entidades en una o varias capas o clases de entidad. A diferencia de la herramienta Cercano, que modifica la entrada, Generar tabla de cercanía escribe los resultados en una tabla independiente nueva y admite la búsqueda de más de una entidad cercana.
Más información sobre cómo se calcula la proximidad con las herramientas de geoprocesamiento
Ilustración
Uso
La tabla de salida contendrá los siguientes campos:
- IN_FID: el ObjectID de la entidad de entrada.
- NEAR_FID: el ObjectID de la entidad más próxima.
- NEAR_DIST: la distancia de la entidad de entrada a la entidad cercana. La unidad de distancia del valor de este campo es la unidad lineal del sistema de coordenadas de la entidad de entrada, o en Metros si el parámetro Método está establecido en Geodésico y la entrada está definida en un sistema de coordenadas geográficas.
- NEAR_FC: la ruta de catálogo a la clase de entidad que contiene la entidad cercana. Este campo solo se agrega a la tabla de salida si se especifican varios valores de Entidades cercanas.
- NEAR_RANK: valor entero que clasifica todas las entidades cercanas según su proximidad a una entidad de entrada individual. La entidad más cercana tendrá un valor de 1, la segunda más cercana un valor de 2, y así sucesivamente.
Los siguientes campos se agregarán a la tabla de salida si el parámetro Ubicación está activado (parámetro location establecido en LOCATION en Python). La unidad de los valores de los campos depende del método empleado en el parámetro Método. Si se utiliza Planar, la unidad del valor será la unidad lineal del sistema de coordenadas de la entidad de entrada. Si se utiliza Geodésico, la unidad del valor será el sistema de coordenadas geográficas asociado al sistema de coordenadas de la entidad de entrada.
- FROM_X: la coordenada x de la ubicación en la entidad de entrada más cercana a la entidad cercana
- FROM_Y: la coordenada y de la ubicación en la entidad próxima más cercana a la entidad de entrada.
- NEAR_X: la coordenada x de la ubicación en la entidad próxima más cercana a la entidad de entrada.
- NEAR_Y: la coordenada y de la ubicación en la entidad próxima más cercana a la entidad de entrada.
El siguiente campo se agregará a la tabla de salida si el parámetro Ángulo está activado (parámetro angle establecido en ANGLE en Python).
- NEAR_ANGLE: el ángulo de la línea en las ubicaciones FROM_X y FROM_Y que conecta las entidades de entrada con la entidad cercana.
Cuando la entidad de entrada y próxima intersecan, los siguientes valores se escribirán en la tabla de salida:
- NEAR_ANGLE y NEAR_DIST se establecerán en 0.0.
- FROM_X y FROM_Y serán idénticos a NEAR_X y NEAR_Y y serán una ubicación en la intersección de ambas entidades.
Los valores del campo NEAR_DIST estarán en la unidad lineal del sistema de coordenadas de las entidades de entrada. Si la entrada está en un sistema de coordenadas geográficas y el parámetro Método tiene el valor Geodésico, las unidades del campo NEAR_DIST serán metros.
La tabla de salida se puede unir de nuevo a las entidades de entrada mediante el campo IN_FID o a las entidades cercanas mediante el campo NEAR_FID.
Si se especifica el parámetro Radio de búsqueda y no se encuentra ninguna entidad cercana, no se generará ningún registro.
Si no se especifica el parámetro Radio de búsqueda, todas las entidades cercanas se considerarán candidatas.
Si el parámetro Radio de búsqueda no está especificado, el parámetro Buscar solo entidades más cercanas está desactivado y el parámetro Cantidad máxima de coincidencias más cercanas tiene el valor predeterminado (0 o vacío), la tabla de salida contendrá cálculos de distancia entre todas las entidades de entrada y todas las entidades cercanas. Este proceso puede tardar mucho tiempo y puede crear una tabla de salida grande. Por ejemplo, si tiene 1.000 entidades de entrada y 1.000 entidades próximas, la tabla de salida incluirá 1.000.000 de registros.
La misma capa o clase de entidad se puede usar tanto como entidades cercanas como de entrada. En esta situación, la entidad de entrada que se está evaluando se excluirá de los candidatos de entidad para evitar que todas las entidades estén próximas a ellas mismas.
Cuando utilice la opción Planar para el parámetro Método, utilice para las entidades de entrada una proyección adecuada para la medición de distancia, por ejemplo, una proyección equidistante.
Más información sobre los sistemas de coordenadas geográficas y proyectadas
Para visualizar los valores de los campos FROM_X, FROM_Y, NEAR_X y NEAR_Y, la tabla de salida se puede usar como entrada de las herramientas Crear capa de eventos XY o De XY a línea.
Sintaxis
arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method})| 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,...] | Una o más capas de la clase de entidad que contienen candidatos de entidades cercanas. Las entidades cercanas pueden ser poligonales, de punto, polilínea o multipunto. Si se especifican varias capas o clases de entidad, se agregará un campo NEAR_FC a la tabla de entrada que almacenará las rutas de la clase de entidad de origen que contiene la entidad más cercana encontrada. La misma capa o clase de entidad se puede usar tanto como entidades cercanas como de entrada. | Feature Layer |
out_table |
La tabla de salida contiene el resultado de los análisis. | Table |
search_radius (Opcional) | El radio que se utilizará para buscar entidades cercanas. Si no se especifica ningún valor, las entidades cercanas serán candidatas. Si se introduce una distancia, pero la unidad se deja en blanco o está definida como Desconocido, se utilizarán las unidades del sistema de coordenadas de las entidades de entrada. Si se utiliza la opción GEODESIC en el parámetro method, utilice una unidad lineal, como kilómetros o millas. | Linear Unit |
location (Opcional) | Especifica si las coordenadas x e y de la ubicación de la entidad de entrada y de la ubicación más cercana de la entidad cercana se escribirán en los campos FROM_X, FROM_Y, NEAR_X y NEAR_Y.
| Boolean |
angle (Opcional) | Especifica si el ángulo cercano se calculará y se escribirá en el campo NEAR_ANGLE en la tabla de salida. Un ángulo cercano mide la dirección de la línea que conecta una entidad de entrada con su entidad más cercana en sus ubicaciones más cercanas. Si se utiliza el método PLANAR para el parámetro method, el ángulo está dentro del rango de -180° a 180°, con 0° al este, 90° al norte, 180° (o -180°) al oeste y -90° al sur. Si se utiliza el método GEODESIC en el parámetro method, el ángulo se encuentra dentro del rango de -180° a 180°, con 0° al norte, 90° al este, 180° (o -180°) al sur y -90° al oeste.
| Boolean |
closest (Opcional) | Especifica si solo se escribirá en la tabla de salida la entidad más cercana.
| Boolean |
closest_count (Opcional) | Limita el número de entidades cercanas reportadas para cada entidad de entrada. Este parámetro no se tiene en cuenta si el parámetro closest tiene el valor CLOSEST. | Long |
method (Opcional) | Especifica si se utilizará un método de distancia de ruta más corta en un esferoide (geodésico) o en una tierra plana (planar). Se recomienda utilizar el método GEODESIC con datos almacenados en un sistema de coordenadas que no sea adecuado para mediciones de distancias (por ejemplo, Web Mercator y cualquier sistema de coordenadas geográficas) y para los datasets que abarquen un área geográfica extensa.
| String |
Muestra de código
Ejemplo 1 de GenerateNearTable (ventana de Python)
A continuación, se muestra 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")
Ejemplo 2 de GenerateNearTable (script independiente)
La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función GenerateNearTable 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
# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius,
location, angle, closest, closest_count)
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí