Standardmäßige XY-Toleranz berechnen (Data Management)
Zusammenfassung
Berechnet durch das Untersuchen des Raumbezugs und der Ausdehnung der Feature-Class eine Standard-XY-Toleranz.
Bei Geodatabase-Feature-Classes entspricht der von diesem Werkzeug zurückgegebene Wert der XY-Toleranzeigenschaft einer Geodatabase-Feature-Class bzw. eines Geodatabase-Feature-Datasets oder der Cluster-Toleranz einer Topologie. Bei Feature-Classes, die nicht zur Geodatabase gehören, z. B. Coverage-Feature-Classes, Shapefiles oder CAD-Feature-Classes, basiert der Wert auf der Standardtoleranz des Raumbezugs der Feature-Class.
Veraltet:Die Begriffe "XY-Toleranz" und "Cluster-Toleranz" sind Synonyme. Sie sehen die Verwendung des Begriffs "Cluster-Toleranz" in der Topologie, im Pythonskript und in ArcGIS vor der Version 9.2. Der Name dieses Werkzeugs (in der Skripterstellung verwendet) lautet "CalculateDefaultClusterTolerance".
Die XY-Toleranz ist durch die Eigenschaft XYTolerance eines SpatialReference-Objekts auch für die Skripterstellung verfügbar. Ein SpatialReference-Objekt kann durch die Beschreibung einer Feature-Class erstellt werden.
Verwendung
Dieses Werkzeug kann nicht verwendet werden, um den Wert der Standard-XY-Toleranz zurückzusetzen; es kann nur den XY-Toleranzwert berechnen.
Das Ergebnis dieses Werkzeugs wird als Meldung vom Werkzeug zurückgegeben. Die Werte können im Geoverarbeitungsfenster Ergebnisse angezeigt werden. Der Wert kann auch bei der Skripterstellung durch Zugreifen auf das Objekt result der Werkzeugausführung einer Variablen zugewiesen werden.
-
Der standardmäßige XY-Toleranzwert entspricht 0,001 Meter, wobei der Wert von Feature-Classes, die nicht zur Geodatabase gehören, von diesem abhängig vom Raumbezug abweichen kann. Dieser Standardwert kann nicht geändert werden.
Die XY-Toleranz einer Geodatabase-Feature-Class kann angegeben werden, wenn eine neue Feature-Class (oder das zugehörige Feature-Dataset bzw. die zugehörige Topologie) in einer Geodatabase erstellt wird. Wenn Sie keine neue XY-Toleranz angeben, werden die Standardwerte der Feature-Classes verwendet, in der sie enthalten ist, normalerweise 0,001 Meter. Wenn die Feature-Class in einer Geodatabase-Topologie gespeichert wird, kann die XY-Toleranz mit dem Werkzeug Cluster-Toleranz festlegen zurückgesetzt werden. Weitere Informationen erhalten Sie, indem Sie mit der rechten Maustaste auf eine Feature-Class oder ein Feature-Dataset klicken und auf Eigenschaften klicken, anschließend die Registerkarte Toleranz auswählen und die Informationen im Hilfeabschnitt Info über das Festlegen von Toleranzen lesen.
-
Die meisten Werkzeuge, die neue Feature-Classes erstellen (z. B. Feature-Class erstellen oder Features kopieren) berücksichtigen die Umgebungseinstellung XY_Tolerance. Allerdings legen nur die Werkzeuge, die diese Umgebung verwenden, die XY-Toleranz für die Ausgabe-Feature-Class fest. Diese Umgebungseinstellung hat keine Auswirkung auf die Eingabe-XY-Toleranz.
Syntax
| Parameter | Erläuterung | Datentyp |
in_features |
Die Feature-Class, für die die Standard-XY-Toleranz berechnet wird. | Feature Layer |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion "Standardmäßige XY-Toleranz berechnen" im unmittelbaren Modus verwenden.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CalculateDefaultClusterTolerance_management("roads.shp")
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion "Standardmäßige XY-Toleranz berechnen" in einer Scripting-Umgebung verwenden.
# 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)