Disponible con una licencia Advanced.
Resumen
Calcula la distancia de cada punto de una cobertura al arco, punto o nodo más cercano de otra cobertura.
Ilustración
Uso
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 considerarla como la entidad más cercana. El valor predeterminado es el ancho o alto del BND de la cobertura cercana dividido por 100, lo que sea mayor.
Los resultados se registran en la tabla de atributos de puntos (PAT) de la cobertura de salida. Los elementos para DISTANCE y el número interno de la entidad más cercana se agregan o se actualizan; los elementos para las coordenadas x e y se agregan cuando se comprueban las coordenadas x, y de registro de la entidad más cercana. Todos los valores de elemento se establecen en cero si no se encuentra ninguna entidad dentro del radio de búsqueda.
Los valores de DISTANCE se recalculan si este elemento ya existe en la cobertura de entrada. Si se agrega el elemento DISTANCE, tendrá la misma precisión que la cobertura.
Los elementos de salida de NEAR son los siguientes:
Estos elementos se agregan a la PAT de la cobertura de entrada. Si ya existe un elemento denominado DISTANCE, los valores se recalculan. Si se agrega el elemento DISTANCE, tendrá la misma precisión que la cobertura. Los valores para ambos elementos serán cero si no se encuentra ninguna coincidencia dentro del valor de search_radius para un punto de cobertura de entrada determinado.
La distancia calculada del punto al arco será del punto a la ubicación más cercana a lo largo del arco. La distancia calculada del punto al nodo será entre las ubicaciones de nodo más cercanas en los arcos.
La distancia y el número interno de la entidad más cercana se guardan como nuevos elementos en la tabla de atributos de entidad de la cobertura de entrada.
NEAR omite los números de los nodos duplicados para aumentar el tiempo de operación.
La precisión de las coordenadas de la cobertura de entrada no se ve afectada por NEAR.
NEAR es útil para asignar atributos de punto a los arcos más cercanos o viceversa. Esta operación es útil para asignar rangos de direcciones a arcos; asociar atributos de punto a nodos, tales como números de nodo DIME; o buscar la línea disponible más cercana en una red (por ejemplo, determinar con qué línea de cloaca podría estar conectada una propiedad).
Los usos comunes para Cerca incluyen:
- Asignar atributos de punto a los arcos más cercanos o viceversa.
- Asignar rangos de direcciones a arcos.
- Asociar atributos de punto a nodos, tales como números de nodo DIME.
- Buscar la línea disponible más cercana en una red.
Sintaxis
arcpy.arc.Near(in_cover, near_cover, out_cover, {feature_type}, {search_radius}, {location})
Parámetro | Explicación | Tipo de datos |
in_cover | La cobertura que contiene los puntos desde los que se calculan las distancias a cada arco, punto o nodo más cercano de <near_cover:>. | Coverage |
near_cover | La cobertura de línea o punto cuyas entidades se utilizan para calcular las distancias desde cada punto de cobertura de entrada. Debe ser diferente de la cobertura de entrada. | Coverage |
out_cover | La cobertura que se va a crear. <input_cover> se copia en <output_cover:> y, a continuación, se ejecuta NEAR en <output_cover:>. | Coverage |
feature_type (Opcional) | El tipo de entidad en la que se buscarán los puntos desde los que encontrar la entidad más cercana y calcular la distancia entre ellos.
| String |
search_radius (Opcional) | La distancia máxima en unidades de cobertura entre entidades de cobertura de entrada y entidades de cobertura de salida para la que se determinará la distancia y el número interno de cobertura cercana. Si ninguna entidad de la cobertura cercana está dentro del radio de búsqueda de un punto o una línea de cobertura de entrada dados, tanto la salida de número interno como de distancia de NEAR serán cero. El radio de búsqueda predeterminado es el ancho o alto del BND de la cobertura cercana dividido por 100, lo que sea mayor. Este radio de búsqueda predeterminado se utiliza siempre que se establece en cero o se omite el argumento de radio de búsqueda. | Double |
location (Opcional) | Determina si se guardarán las coordenadas x, y del "punto más cercano" del arco, punto o nodo más cercano, así como el número de cobertura y la distancia. Los nuevos elementos son X-COORD e Y-COORD.
| Boolean |
Muestra de código
Ejemplo de Cerca (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente demuestra cómo calcular distancias entre pozos en una cobertura y entre caminos en otra.
# Name: Near_Example.py
# Description: Computes the distances between wells and roads
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inCover = "wells142"
nearCover = "road"
outCover = "C:/output/nearwells"
featureType = "LINE"
searchRadius = 12000
location = "LOCATION"
# #Execute Near
arcpy.Near_arc(inCover, nearCover, outCover, featureType,
searchRadius, location)
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Requiere ArcInfo Workstation instalado