Distancia de punto (Análisis)
Resumen
Determina las distancias de las entidades de punto de entrada a todos los puntos de las entidades cercanas dentro de un radio de búsqueda especificado.
Más información acerca del cálculo de la proximidad en las herramientas de geoprocesamiento
Ilustración
 |
Uso
-
La herramienta crea una tabla con distancias entre dos conjuntos de puntos. Si se utiliza el radio de búsqueda predeterminado, las distancias desde todos los puntos de entrada a todos los puntos cercanos se calculan. La tabla de resultados puede ser bastante grande. Por ejemplo, si tanto las entidades de entrada como las cercanas tienen 1.000 puntos cada una, la tabla de salida puede contener un millón de registros.
Utilice un radio de búsqueda significativo para limitar el tamaño de la salida y mejorar el rendimiento de la herramienta. La tabla de salida contiene solo esos registros que tienen casi un punto cercano dentro del radio de búsqueda.
-
Los resultados se registran en la tabla de salida, que contiene la siguiente información:
- INPUT_FID: el ID de entidad de las entidades de entrada.
- NEAR_FID: el ID de entidad de las entidades cercanas.
- DISTANCE: la distancia de la entidad de entrada a la cercana. El valor de este campo está en la unidad lineal del sistema de coordenadas de las entidades de entrada.
-
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 punto desde las que se calcularán las distancias a las entidades cercanas. | Feature Layer |
near_features |
Los puntos a los que se calcularán las distancias desde las entidades de entrada. Las distancias entre los puntos dentro de la misma clase de entidad o capa se pueden determinar especificando la misma clase de entidad o capa para la entrada y las entidades cercanas. | Feature Layer |
out_table |
La tabla que contiene la lista de entidades de entrada e información de casi todas las entidades cercanas dentro del radio de búsqueda. Si no se especifica un radio de búsqueda, se calculan las distancias de todas las entidades de entrada a todas las entidades cercanas. | 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 de radio de búsqueda se predetermina a las unidades 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 del campo de DISTANCIA de salida que se basan en las unidades del sistema de coordenadas de las entidades de entrada. | Linear unit |
Ejemplo de código
La siguiente secuencia de comandos de la ventana interactiva de Python demuestra cómo utilizar la función PointDistance en el modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
La siguiente secuencia de comandos Python demuestra cómo utilizar la función DistanciaPunto en una secuencia de comandos independiente.
# Description: Finds distance of each near point from each input point and outputs to a table.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
try:
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
print arcpy.GetMessages(0)
except arcpy.ExecuteError:
print arcpy.GetMessages(2)
except Exception as ex:
print ex.args[0]