Recalcular la extensión de clase de entidad (Administración de datos)

Resumen

Recalcula las propiedades de las extensiones yx, 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. La herramienta Recalcular la extensión de clase de entidad lee todas las entidades y 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.

Precaución:

Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Clase de entidad	La clase de entidad de geodatabase o shapefile que se actualizará.	Feature Layer
Almacenar extensión (Opcional)	Especifica si la extensión se almacenará para las clases de entidad que no están registradas. Este parámetro solo está activo si la clase de entidad de entrada es una tabla espacial no registrada. Si la clase de entidad de entrada se actualiza con frecuencia, puede optar por no almacenar el valor de extensión recalculado. Si opta por almacenar la extensión, esta no se recalculará cada vez que se agregue la clase de entidad a un mapa. Activado: la extensión se almacenará para la clase de entidad de entrada. Desactivado: la extensión no se almacenará para la clase de entidad de entrada. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad actualizada	La clase de entidad actualizada.	Feature Class

Python

arcpy.management.RecalculateFeatureClassExtent(in_features, {store_extent})

Nombre	Explicación	Tipo de datos
in_features	La clase de entidad de geodatabase o shapefile que se actualizará.	Feature Layer
store_extent (Opcional)	Especifica si la extensión se almacenará para las clases de entidad que no están registradas. Si la clase de entidad de entrada se actualiza con frecuencia, puede optar por no almacenar el valor de extensión recalculado. Si opta por almacenar la extensión, esta no se recalculará cada vez que se agregue la clase de entidad al mapa. STORE_EXTENT—La extensión se almacenará para la clase de entidad de entrada. DO_NOT_STORE_EXTENT—La extensión no se almacenará para la clase de entidad de entrada. Esta es la opción predeterminada.	Boolean

Salida derivada

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

Muestra de código

Ejemplo de RecalculateFeatureClassExtent (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función RecalculateFeatureClassExtent de 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.management.RecalculateFeatureClassExtent(feature_class)

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal