Calculer la tolérance XY par défaut (Gestion des données)
Récapitulatif
Calcule une tolérance XY par défaut en examinant la référence spatiale et l'étendue de la classe d'entités.
Avec les classes d'entités de géodatabase, la valeur renvoyée par cet outil est identique à la propriété de la tolérance XY sur un jeu de données ou une classe d'entités de géodatabase, ou la tolérance d'agrégat d'une topologie. Avec les classes d'entités non associées à la géodatabase (comme les classes d'entités de couverture, les fichiers de formes ou les classes d'entités DAO), la valeur repose sur la tolérance par défaut de la référence spatiale de la classe d'entités.
Legacy :Les termes "tolérance XY" et "tolérance d'agrégat" sont synonymes. Vous étudierez les modalités d'utilisation de la tolérance d'agrégat dans la topologie, le script Python et ArcGIS (versions antérieures à 9.2). Le nom de cet outil (utilisé dans les scripts) est CalculateDefaultClusterTolerance.
La tolérance XY est également disponible dans les scripts via la propriété XYTolerance d'un objet SpatialReference. Il est possible de créer un objet SpatialReference en décrivant une classe d'entités.
Utilisation
Cet outil ne peut pas être utilisé pour rétablir la valeur de tolérance XY par défaut ; il ne peut calculer que la valeur de tolérance XY.
Le résultat de cet outil est renvoyé sous forme de message à partir de l'outil. Il est possible d'afficher les valeurs dans la fenêtre Résultats du géotraitement ou d'attribuer la valeur à une variable dans les scripts en accédant à l'objet result lors de l'exécution de l'outil.
-
Même si la tolérance XY par défaut de classes d'entités non associées à la géodatabase peut varier en fonction de la référence spatiale, sa valeur équivaut à 0,001 mètre. Cette valeur par défaut n'est pas modifiable.
Il est possible de spécifier la tolérance XY de classes d'entités de géodatabase lors de la création dans une géodatabase d'une classe d'entités, ou du jeu de données d'entité ou topologie qu'elle contient. Si vous ne spécifiez pas de nouvelle tolérance XY, ce sont les valeurs par défaut des classes d'entités contenues (qui équivalent généralement à 0,001 mètre) qui sont utilisées. Si la classe d'entités est enregistrée dans une topologie de géodatabase, il est alors possible de rétablir la tolérance XY à l'aide de l'outil Définir la tolérance d'agrégat. Pour plus d'informations, vous pouvez cliquer avec le bouton droit sur une classe d'entités ou un jeu de données, puis cliquer sur Propriétés, sélectionner l'onglet Tolérance et choisir l'aide A propos de la définition de la tolérance.
-
La plupart des outils qui permettent de créer des classes d'entités (comme Créer une classe d'entités ou Copier des entités) respectent le paramètre d'environnement XY_Tolerance. Seuls les outils qui utilisent cet environnement définissent toutefois la tolérance XY sur la classe d'entités en sortie. La tolérance XY en entrée n'est pas concernée par ce paramètre d'environnement.
Syntaxe
| Paramètre | Explication | Type de données |
in_features |
Classe d'entités pour laquelle la tolérance XY par défaut est calculée. | Feature Layer |
Exemple de code
Le script de fenêtre Python suivant illustre l'utilisation de la fonction Calculer la tolérance d'agrégat par défaut en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CalculateDefaultClusterTolerance_management("roads.shp")
Le script autonome suivant illustre l'utilisation de la fonction Calculer la tolérance d'agrégat par défaut dans un environnement de scripts.
# Name: CalculateDefaultClusterTolerance_Example.py
# Description: Calculate the default cluster tolerance of a shape file
# Author: ESRI
#Import the system modules
import arcpy
from arcpy import env
env.workspace = "C:/temp"
#Set local variables
shapefileName = "linefc.shp"
arcpy.CalculateDefaultClusterTolerance_management(shapefileName)