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

  • Esta herramienta actualiza las clases de entidades de la geodatabase o los shapefiles (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.

  • El parámetro Extensión de almacenamiento es compatible con tablas espaciales no registradas en una base de datos o geodatabase empresarial. Si el parámetro está activado, la nueva extensión se almacenará en los metadatos de la columna forma de la tabla subyacente. Si el parámetro está desactivado, la extensión se recalculará, pero el valor no se almacenará, lo que puede ser útil cuando los datos subyacentes se actualicen con frecuencia.

  • 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

EtiquetaExplicaciónTipo de datos
Clase de entidad de entrada

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 solamente está activo cuando la clase de entidad de entrada es una tabla espacial no registrada en una base de datos o geodatabase empresarial.

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

EtiquetaExplicaciónTipo de datos
Clase de entidad actualizada

La clase de entidad actualizada.

Feature Class

arcpy.management.RecalculateFeatureClassExtent(in_features, {store_extent})
NombreExplicaciónTipo 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. Este parámetro solamente se admite cuando la clase de entidad de entrada es una tabla espacial no registrada en una base de datos o geodatabase empresarial.

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_EXTENTLa extensión se almacenará para la clase de entidad de entrada.
  • DO_NOT_STORE_EXTENTLa extensión no se almacenará para la clase de entidad de entrada. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_features

La clase de entidad actualizada.

Feature Class

Muestra de código

Ejemplo de RecalculateFeatureClassExtent (ventana dePython)

La siguiente secuencia de comandos de la ventana de Python muestra 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)