Recalcula la extensión de clase de entidad

Resumen

Recalcula las propiedades de las extensiones XY, Z y M de una clase de entidad según las entidades de esa clase de entidad.

Una clase de entidad tiene una extensión espacial que está basada en todas las coordenadas de la clase de entidad. Esta extensión espacial se utiliza cuando se agrega una clase de entidad a un mapa para volver a centrar y mostrar todas las entidades. En lugar de examinar cada entidad de la clase de entidad cada vez que esta se agrega a un mapa (un proceso que podría durar mucho), una clase de entidad tiene una propiedad de extensión que contiene la última extensión espacial conocida. No obstante, esta propiedad de extensión no siempre está actualizada cuando se editan las entidades de la clase de entidad. Significa que los valores de la propiedad de extensión podrían no contener la extensión espacial real de las entidades. Al ejecutar esta herramienta se leen todas las entidades y se actualiza la propiedad de extensión.

Nota:

Las extensiones XY, Z y M no son las mismas que los dominios de referencia espacial. Los dominios XY, Z y M de una referencia espacial definen el rango válido de valores de coordenadas que se pueden almacenar en una clase de entidad. Las extensiones de la clase de entidad reflejan el rango real de valores de coordenadas que existen dentro de la clase de entidad. Estas extensiones no pueden ser más grandes que los dominios.

Uso

• La herramienta Recalcular la extensión de clase de entidad actualiza las clases de entidad o shapefiles de la geodatabase (punto, multipunto, línea o polígono).

• En una geodatabase corporativa, la extensión es una propiedad del esquema de la clase de entidad y requiere un bloqueo de esquema exclusivo para ejecutarla.

• Cuando se utiliza esta herramienta con una clase de entidad de geodatabase corporativa como entrada, la extensión se calcula basándose en las entidades que existen en esa clase de entidad en todas las versiones. La extensión no se reducirá ni expandirá salvo que se ejecute esta herramienta una vez comprimida la base de datos.

• Esta herramienta fallará si no tiene los permisos para editar la clase de entidad.

• La acción de recalcular la extensión de la clase de entidad no se puede deshacer.

• La función extent de la propiedad arcpy.Describe devuelve los valores de la extensión.

• Esta herramienta realiza la misma operación que abrir las Propiedades de clase de entidad en ArcCatalog o la ventana Catálogo en ArcMap, elegir la pestaña Extensión de entidad y hacer clic en Recalcular en la sección de Extensión adecuada.

Precaución:

Esta herramienta modifica los datos de entrada. Vea Herramientas sin salidas para ver más información y estrategias para evitar cambios de datos no deseados.

Sintaxis

arcpy.management.RecalculateFeatureClassExtent(in_features)

Parámetro	Explicación	Tipo de datos
in_features	La clase de entidad de geodatabase o shapefile que se actualizará.	Feature Layer

Salida derivada

Nombre	Explicación	Tipo de datos
out_features	La clase de entidad actualizada.	Clase de entidad

Muestra de código

Ejemplo de RecalculateFeatureClassExtent (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta RecalculateFeatureClassExtent en el modo inmediato. Recalcula las extensiones XY, M o Z de una clase de entidad.

import arcpy
feature_class = r"C:\Data\europe.gdb\norway_cities"
arcpy.RecalculateFeatureClassExtent_management(feature_class)

Entornos

• Espacio de trabajo actual
• Espacio de trabajo temporal

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí