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.
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, 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
arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})
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 |
Muestra de código
Ejemplo 1 de PointDistance (ventana de Python)
El siguiente script de la ventana interactiva de Python muestra 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")
Ejemplo 2 de PointDistance (script independiente)
El siguiente script de Python muestra cómo utilizar la función PointDistance en un script 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"
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí