Generar tabla de cercanía (Análisis)

Resumen

Calcula las distancias y demás información de proximidad entre entidades en una o varias capas o clases de entidad. A diferencia de la herramienta Cerca, que modifica la entrada, Generar tabla de cercanía escribe los resultados en una tabla independiente nueva y permite la búsqueda de más de una entidad próxima.

Más información acerca del cálculo de la proximidad con las herramientas de geoprocesamiento

Ilustración

Uso

• La tabla de salida contendrá los siguientes campos:

  Nombre de campo	Descripción
  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 próxima. El valor de este campo está definido en la unidad línea del sistema de coordenadas de entidades de entrada, o en Metros cuando el parámetro Método está establecido en GEODESIC y la entrada está definida en un sistema de coordenadas geográficas.
  NEAR_FC	La ruta del catálogo de la clase de entidad que contiene la entidad próxima. Este campo solo se agrega a la tabla de salida si se especifican varias Entidades próximas.
  NEAR_RANK	Valor entero que clasifica todas las entidades próximas según su proximidad a una entidad de entrada individual. La entidad más próxima obtendrá un valor NEAR_RANK de 1, la segunda más próxima un valor NEAR_RANK de 2, y así sucesivamente.

  Los siguientes campos se agregarán a la tabla de salida si el parámetro Ubicación está marcado (parámetro location establecido en LOCATION en secuencias de comandos).

  Nombre de campo	Descripción
  FROM_X	Coordenada X de la ubicación en la entidad de entrada más cercana a la entidad próxima.
  FROM_Y	Coordenada Y de la ubicación en la entidad de entrada más cercana a la entidad próxima.
  NEAR_X	Coordenada X de la ubicación en la entidad próxima más cercana a la entidad de entrada.
  NEAR_Y	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á marcado (parámetro angle establecido en ANGLE en secuencias de comandos).

  Campo	Descripción
  NEAR_ANGLE	Ángulo de la línea en la ubicación FROM_X y FROM_Y que conecta las entidades de entrada en la entidad próxima.

• Cuando la entidad de entrada y próxima intersecan, los siguientes valores se escriben 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 dentro de la intersección de las dos entidades.

• Los valores en el campo NEAR_DIST está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 se establece en GEODESIC, las unidades NEAR_DIST estarán en metros.

• La tabla de salida puede unirse de nuevo a las entidades de entrada utilizando IN_FID o a las entidades próximas utilizando NEAR_FID.

• Si se especifica un Radio de búsqueda y no se encuentra ninguna entidad próxima, no habrá ningún registro en la salida.

• Si no se especifica ningún Radio de búsqueda, todas las entidades próximas se considerarán candidatos.

• Si no se especifica ningún Radio de búsqueda y Encontrar solo entidad más cercana no está marcado (closest establecido en ALL en la secuencia de comandos), y se deja el valor predeterminado para Cantidad máxima de coincidencias más cercanas (0 o en blanco), la tabla de salida contendrá cálculos de distancia entre todas las entidades de entrada y todas las entidades próximas. Este tipo de proceso puede tardar bastante y puede crear una tabla de salida muy 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 de entrada como entidades próximas. En esta situación, la entidad de entrada que se está evaluando se excluye de los candidatos de entidad para evitar que todas las entidades estén próximas a ellas mismas.

• Cuando se utiliza la opción PLANAR para el parámetro Método, las entidades de entrada deben encontrarse en una proyección que sea adecuada para la medición de la distancia, como las proyecciones equidistantes.

  Más información sobre los sistemas de coordenadas geográficas y proyectadas

• Para visualizar las ubicaciones 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 XY a línea.

Sintaxis

GenerateNearTable_analysis (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 próximas. Las entidades próximas pueden ser de tipo punto, polilínea, polígono o multipunto. Si se especifican varias capas o clases de entidades, se agrega un nuevo campo denominado NEAR_FC a la tabla de entrada que almacenará las rutas de la clase de entidad de origen que contiene las entidades más próximas detectadas. La misma capa o clase de entidad se puede usar tanto como entidades de entrada como entidades próximas.	Feature Layer
out_table	La tabla de salida contiene el resultado de los análisis.	Table
search_radius (Opcional)	El radio que se utiliza para buscar entidades próximas. Si no se especifica ningún valor, las entidades próximas serán candidatos. Si se introduce una distancia, pero la unidad se deja en blanco o está establecida en Desconocido, se utilizan las unidades del sistema de coordenadas de las entidades de entrada. Si la opción GEODESIC se utiliza en el parámetro Método, debería usarse una unidad lineal, como Kilómetros o Millas.	Linear unit
location (Opcional)	Especifica si se escribirán las coordenadas x e y de la ubicación de la entidad de entrada y de la ubicación más próxima de la entidad próxima en los campos FROM_X, FROM_Y, NEAR_X y NEAR_Y. NO_LOCATION — Las ubicaciones no se escribirán en la tabla de salida. Esta es la opción predeterminada. LOCATION — Las ubicaciones se escribirán en la tabla de salida.	Boolean
angle (Opcional)	Especifica si se calculará el ángulo cercano y si se escribirá en un campo nuevo NEAR_ANGLE en la tabla de salida. Un ángulo próximo mide la dirección de la línea que conecta una entidad de entrada a la entidad más próxima en las ubicaciones más cercanas. Cuando el método PLANAR se utiliza en el parámetro method, el ángulo se encuentra dentro del intervalo de -180° a 180°, con 0° al este, 90° al norte, 180° (o -180°) al oeste, y -90° al sur. Cuando se utiliza el método GEODESIC, el ángulo se encuentra dentro del intervalo de -180° a 180°, con 0° al norte, 90° al este, 180° (o -180°) al sur, y -90° al oeste. NO_ANGLE —NEAR_ANGLE no se agregará a la tabla de salida. Esta es la opción predeterminada. ANGLE —NEAR_ANGLE se agregará a la tabla de salida.	Boolean
closest (Opcional)	Especifica si solo se devuelve a las entidades más cercanas o a múltiples entidades. CLOSEST —Solo se escribirá la entidad próxima más cercana en la tabla de salida. Esta es la opción predeterminada. ALL —Se escribirán varias entidades próximas a la tabla de salida (se puede especificar un límite en el parámetro closest_count).	Boolean
closest_count (Opcional)	Limita el número de entidades próximas notificadas para cada entidad de entrada. Este parámetro se ignora si el parámetro closest está establecido en CLOSEST.	Long
method (Opcional)	Determina si se utiliza una ruta más corta en un esferoide (geodésico) o una tierra plana (planar). Se sugiere enfáticamente utilizar el método GEODESIC con datos almacenados en un sistema de coordenadas que no sea adecuado para las mediciones de distancias (por ejemplo, Web Mercator y cualquier sistema de coordenadas geográficas), o cualquier dataset que abarque una extensa área geográfica. PLANAR —Utiliza distancias planares entre las entidades. Esta es la opción predeterminada. GEODESIC —Utiliza distancias geodésicas entre las entidades. Este método tiene en cuenta la curvatura del esferoide y trata correctamente los datos cercanos a la línea de cambio de fecha y los polos.	String

Ejemplo de código

Ejemplo 1 de GenerateNearTable (ventana de Python)

La siguiente información 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")

Ejemplo 2 de GenerateNearTable (secuencia de comandos Python independiente)

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

# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius, 
                                 location, angle, closest, closest_count)

Entornos

Extensión, Espacio de trabajo actual, Espacio de trabajo temporal

Información sobre licencias

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: No

ArcGIS for Desktop Advanced: Sí