Disponible con una licencia Advanced.
Resumen
Calcula la distancia punto a punto entre cada punto de una cobertura y todos los puntos de la misma cobertura o de otra dentro de un radio de búsqueda especificado.
Ilustración
Uso
La definición del elemento de distancia en el archivo INFO de salida será igual a la precisión superior de las dos entradas de cobertura de punto.
El radio de búsqueda es la distancia máxima al punto actual, en unidades de cobertura, a la que puede estar una entidad para su consideración. Si no se especifica {search_radius}, se utilizará como valor predeterminado el ancho diagonal del BND de la cobertura.
La distancia se establece en cero cuando no se encuentra ninguna coincidencia dentro del radio de búsqueda para un punto determinado. Si no se encuentra ningún punto concordante, la herramienta da un aviso y no se crea ninguna tabla de información de salida.
Distancia de punto no funcionará si cualquier cobertura contiene más de 130.000 puntos.
La tabla INFO se puede hacer muy grande cuando ambas coberturas contienen muchos puntos. Utilice un radio de búsqueda menor para limitar el número de combinaciones.
Si se utiliza Distancia de punto para calcular la distancia entre otros puntos de una única cobertura, el número de cobertura tendrá una A y una B anexadas al nombre del elemento.
Los archivos de proyección se contrastarán para buscar similitudes con el nivel de comparación que se especificó con la configuración de entorno Comparación de proyecciones. Para obtener más información, vea Comparar proyecciones.
Los resultados se registran en una tabla de salida que contiene los elementos para los números internos y la distancia. La entrada que tenga mayor precisión para la distancia es la que se utilizará para el campo de distancia INFO.
COLUMN ITEM NAME WIDTH OUTPUT TYPE N.DEC 1 <From coverage># 4 6 B - 5 <To coverage># 4 6 B - 9 DISTANCE 4 12 F 3 (single precision) Or 9 DISTANCE 8 18 F 5 (double precision)
Sintaxis
arcpy.arc.PointDistance(from_cover, to_cover, out_info_table, {search_radius})| Parámetro | Explicación | Tipo de datos |
from_cover | La cobertura de puntos para la que se calcularán las distancias a otros puntos de cobertura. | Coverage |
to_cover | La cobertura de puntos desde la que se van a medir las distancias de punto. Las distancias entre todos los puntos de la misma cobertura se pueden calcular especificando el mismo nombre de cobertura para los argumentos <from_cover> y <to_cover>. | Coverage |
out_info_table | La tabla de datos INFO creada por Distancia de punto, que contiene las medidas de distancia. El número de registros creados en <output Info table:> depende del radio de búsqueda utilizado, pero puede ser tan grande como el número de puntos de <from cover> multiplicado por el número de puntos de <to cover:>. | INFO Table |
search_radius (Opcional) | La distancia máxima desde el punto actual, en unidades de cobertura, a la que puede estar una cobertura para considerarla como la entidad más cercana. El valor predeterminado es el ancho diagonal del BND de la cobertura. | Double |
Muestra de código
Ejemplo de PointDistance (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente demuestra cómo calcular las distancias entre los puntos de dos coberturas.
# Name: PointDistance_Example.py
# Description: Calculates the distances between the points in two coverages
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
fromCover = "wells"
toCover = "trees"
outInfoTable = "C:/output/distance"
# Execute PointDistance
arcpy.PointDistance_arc(fromCover, toCover, outInfoTable, "")
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Requiere ArcInfo Workstation instalado