Resumen
Calcula una tolerancia XY predeterminada al examinar la referencia espacial y la extensión de la clase de entidad.
Con las clases de entidades de geodatabase, el valor que devuelve esta herramienta será idéntico a la Propiedad de tolerancia XY en una clase o dataset de entidades de geodatabase, o la tolerancia cluster de una topología. Con las clases de entidades que no son de geodatabase, como las clases de entidad de cobertura, los archivos de forma o las clases de entidad de CAD, el valor se basará en la tolerancia predeterminada de la referencia espacial de la clase de entidad.
La tolerancia XY también está disponible en la secuencia de comandos a través de la propiedad XYTolerance de un objeto SpatialReference. Se puede crear un objeto SpatialReference describiendo una clase de entidad.
Uso
Esta herramienta no se puede utilizar para restablecer el valor de tolerancia XY predeterminada; solo puede calcular el valor de tolerancia XY.
El resultado de esta herramienta se devolverá como un mensaje desde la herramienta. Los valores se pueden visualizar en la ventana Resultados de geoprocesamiento o el valor se puede asignar a una variable en la secuencia de comandos al acceder al objeto resultado de la ejecución de la herramienta.
Aunque la tolerancia XY predeterminada de las clases de entidad que no son de geodatabase puede ser diferente según la referencia espacial, el valor es equivalente a 0,001 metros. No se puede cambiar este valor predeterminado.
La tolerancia XY de una clase de entidad de geodatabase se puede especificar cuando se crea en una geodatabase una nueva clase de entidad, o su dataset de entidad contenedor o topología. Si no especifica una nueva tolerancia XY, se utilizan los valores predeterminados de las clases de entidad contenedoras, que por lo general son equivalentes a 0,001 metro. Si la clase de entidad se guarda en una topología de una geodatabase, la tolerancia XY se puede restablecer con la herramienta Establecer tolerancia cluster. Para obtener más información, puede hacer clic con el botón derecho en cualquier clase de entidad o dataset y en Propiedades; después, seleccione la pestaña Tolerancia y, a continuación, consulte la ayuda Acerca de la configuración de tolerancia.
La mayoría de las herramientas que crean nuevas clases de entidades (como Crear clase de entidad o Copiar entidades) respetan la configuración del entorno Tolerancia XY. Sin embargo, solo aquellas herramientas que utilizan este entorno establecen la tolerancia XY en la clase de entidad de salida. La tolerancia XY de entrada no se ve afectada por esta configuración del entorno.
Sintaxis
arcpy.management.CalculateDefaultClusterTolerance(in_features)
| Parámetro | Explicación | Tipo de datos |
in_features | Una clase de entidad para la que se calcula la tolerancia XY predeterminada. | Feature Layer |
Muestra de código
Ejemplo de Calcular Tolerancia XY predeterminada (ventana Python)
La siguiente secuencia de comandos de la ventana Python demuestra cómo utilizar la función Calcular tolerancia cluster predeterminada en el modo inmediato.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CalculateDefaultClusterTolerance_management("roads.shp")
Ejemplo 2 de Calcular Tolerancia XY predeterminada (secuencia de comandos independiente)
La siguiente secuencia de comandos de la ventana Python demuestra cómo utilizar la función Calcular tolerancia cluster predeterminada en un entorno de secuencia de comandos.
# 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)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí