Disponible avec une licence Advanced.
Résumé
Calcule la distance entre chaque point d'une couverture et l'arc, le point ou le noeud les plus proches d'une autre couverture.
Illustration
Utilisation
Le rayon de recherche représente la distance maximale exprimée en unités de couverture à laquelle peut se situer une entité par rapport au point actuel pour être considérée comme l'entité la plus proche. La valeur par défaut correspond à la largeur ou à la hauteur de la limite (BND) des couvertures de proximité divisée par 100 (en conservant la valeur la plus grande des deux).
Les résultats sont enregistrés dans la table attributaire de points de la couverture en sortie (PAT). Les attributs DISTANCE et le numéro interne de l'entité la plus proche sont ajoutés ou mis à jour ; les attributs des coordonnées x et y sont ajoutés si la case Enregistrer les coordonnées x,y de l'entité la plus proche est cochée. Toutes les valeurs attributaires sont définies avec la valeur zéro si aucune entité n'est détectée dans le rayon de recherche.
Les valeurs de distance sont recalculées si cet attribut existe déjà dans la couverture en entrée. Si l'attribut DISTANCE est ajouté, son niveau de précision est identique à celui de la couverture.
L'outil PROCHE permet de générer les attributs suivants :
Ces attributs sont ajoutés à la table attributaire de points de la couverture en entrée. Si un attribut nommé DISTANCE existe déjà, les valeurs sont recalculées. Si l'attribut DISTANCE est ajouté, son niveau de précision est identique à celui de la couverture. Les valeurs des deux attributs sont égales à zéro si aucune correspondance n'est trouvée dans le rayon de recherche pour un point de couverture en entrée particulier.
La distance calculée entre un point et l'arc correspond à la distance entre le point et l'emplacement le plus proche le long de l'arc. La distance calculée entre un point et un noeud correspond à la distance entre les emplacements de noeud les plus proches sur les arcs.
La distance et le numéro interne de l'entité la plus proche sont enregistrés comme nouveaux attributs dans la table attributaire d'entités de la couverture en entrée.
Pour gagner du temps, l'outil PROCHE ignore les numéros de noeud en double.
La précision des coordonnées de la couverture en entrée n'est pas affectée par l'outil PROCHE.
L'outil PROCHE s'avère utile pour affecter des attributs de point aux arcs les plus proches, ou réciproquement. Cette opération est utile pour affecter des plages d'adresses aux arcs, associer des attributs de point aux noeuds, tels que les numéros de noeud DIME, ou encore trouver la ligne disponible la plus proche dans un réseau (par exemple, identifier le collecteur d'égout auquel une propriété peut se raccorder).
Avec l'outil Proche, vous pouvez :
- affecter des attributs de point aux arcs les plus proches, ou visa versa,
- affecter des plages d'adresses aux arcs,
- associer des attributs de point aux noeuds, tels que les numéros de noeud DIME,
- trouver la ligne disponible la plus proche dans un réseau.
Syntaxe
arcpy.arc.Near(in_cover, near_cover, out_cover, {feature_type}, {search_radius}, {location})| Paramètre | Explication | Type de données |
in_cover | Couverture contenant les points à partir desquels sont calculées les distances vers chaque arc, point ou nœud les plus proches dans la couverture de proximité. | Coverage |
near_cover | Couverture de lignes ou de points dont les entités servent à calculer les distances à partir de chaque point de la couverture en entrée. Cette couverture doit être différente de la couverture en entrée. | Coverage |
out_cover | Couverture à créer. La couverture en entrée est copiée dans la couverture en sortie, puis l'outil PROCHE est exécuté sur la couverture en sortie. | Coverage |
feature_type (Facultatif) | Type d'entité recherché à partir des points pour localiser l'entité la plus proche et calculer la distance entre les deux.
| String |
search_radius (Facultatif) | Distance maximale en unités de couverture entre les entités de couverture en entrée et les entités de couverture de proximité pour lesquelles la distance et le numéro interne de couverture de proximité seront déterminés. Si aucune entité de couverture de proximité ne se trouve dans le rayon de recherche d'une ligne ou d'un point de couverture en entrée donné(e), la valeur du numéro interne et de la distance obtenue par l'outil PROCHE est égale à zéro. Le rayon de recherche par défaut correspond à la largeur et à la hauteur de la limite (BND) des couvertures de proximité divisée par 100 (en conservant la valeur la plus grande des deux). Ce rayon de recherche par défaut est utilisé chaque fois que l'argument de rayon de recherche est défini avec la valeur zéro ou qu'il est ignoré. | Double |
location (Facultatif) | Détermine si les coordonnées x,y du "point le plus proche" de l'arc, du point ou du nœud les plus proches doivent être enregistrés, tout comme le numéro de couverture et la distance. Les nouveaux attributs sont COORD. X et COORD. Y.
| Boolean |
Exemple de code
Exemple d'utilisation de l'outil Proche (script autonome)
Le script autonome suivant montre comment calculer les distances entre des puits et des routes appartenant à des couvertures différentes.
# 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)
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Requiert ArcInfo Workstation installé