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

Ilustración de Genera tabla próxima

Uso

Sintaxis

GenerateNearTable_analysis (in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count})
ParámetroExplicaciónTipo 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.

  • NO_LOCATIONespecifica que no se escribirán las coordenadas x e y de la ubicación más cercana. Ésta es la opción predeterminada.
  • LOCATIONespecifica que se escribirán las coordenadas x e y de la ubicación más cercana en los campos NEAR_X y NEAR_Y.
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.

  • NO_ANGLEespecifica que no se escribirán los valores del ángulo cercano. Ésta es la opción predeterminada.
  • ANGLEespecifica que se escribirán los valores del ángulo cercano en el campo NEAR_ANGLE.
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.

  • CLOSESTUbica y devuelve sólo las entidades más cercanas de las Entidades próximas a las Entidades de entrada dentro del radio de búsqueda. Ésta es la opción predeterminada.
  • ALLUbica y devuelve todas las entidades de las Entidades próximas a las Entidades de entrada 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

Ejemplo 1 de GenerarTablaPróxima (ventana de Python)

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")
Ejemplo 2 de GenerarTablaPróxima (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.
# 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)

Entornos

Temas relacionados

Información de licencia

ArcView: No
ArcEditor: No
ArcInfo: Sí

7/10/2012