Resumen
Agrega un índice espacial a un shapefile, una geodatabase de archivos o una clase de entidad de geodatabase corporativa. Utilice esta herramienta para agregar un índice espacial a un shapefile o una clase de entidad que aún no tenga uno o para volver a crear un índice espacial existente.
Uso
ArcGIS utiliza índices espaciales para ubicar rápidamente entidades en clases de entidades. Identificar una entidad, seleccionar entidades haciéndoles clic o arrastrando un cuadro, y realizar un desplazamiento panorámico o un acercamiento requieren que ArcMap utilice el índice espacial para localizar las entidades. El índice espacial se define mediante el uso de un sistema de cuadrícula que abarca la extensión de las entidades en una clase de entidad, como la cuadrícula del localizador que encontrará en los mapas de ruta comunes.
Por defecto, ArcGIS crea y mantiene un índice espacial para clases de entidad de geodatabase. Para que una clase de entidad de geodatabase no tenga un índice espacial, debe quitarlo explícitamente con la herramienta Quitar índice espacial.
Los parámetros de la Cuadrícula espacial 1, 2 y 3 solo se aplican a las geodatabases de archivos y a ciertas clases de entidad de geodatabase corporativa (aquellas que utilizan almacenamiento binario de SQL Server, DB2, almacenamiento binario de Oracle o ST_Geometry de Oracle).
- Si no está familiarizado con la definición de tamaños de cuadrículas espaciales o no está seguro de los valores que debe utilizar, use los valores predeterminados: 0,0,0. Cuando se introducen los valores predeterminados, esta herramienta calcula un tamaño de cuadrícula óptimo mediante el examen de todas las entidades de entrada.
- Los shapefiles y ciertas clases de entidad de geodatabase corporativa (aquellas que utilizan Oracle Spatial, Informix y PostgreSQL) no utilizan índices espaciales basados en tamaños de cuadrícula; por lo tanto, no es necesario especificar valores de cuadrícula espacial.
- Las clases de entidad de geodatabase personales reciben un tamaño de cuadrícula del índice espacial basado en las propiedades de referencia espacial de la clase de entidad. Esta cuadrícula del índice no se puede invalidar, quitar ni modificar.
- Cuadrícula espacial 1 es el primer nivel, o el más bajo, de la cuadrícula y tiene el menor tamaño de celda. Las celdas son cuadradas y el valor de parámetro que introduce es la longitud de un lado. La unidad de medida es la de la referencia espacial de la clase de entidad (por ejemplo, metros). Cuadrícula espacial 2 debe ser por lo menos tres veces más grande que la Cuadrícula espacial 1, y la Cuadrícula espacial 3 debe ser por lo menos tres veces más grande que la Cuadrícula espacial 2.
Si las Entidades de entrada ya tienen un índice espacial, la Cuadrícula espacial 1, 2, 3 muestra los valores actuales de la cuadrícula del índice espacial. Si introduce 0,0,0 como los parámetros de la cuadrícula espacial y ejecuta esta herramienta, se calcula el tamaño óptimo de la cuadrícula y se reconstruye el índice. Puede ver el tamaño calculado de la cuadrícula al volver a abrir esta herramienta y volver a introducir la clase de entidad o capa (después hará clic en Cancelar ya que no necesita reconstruir el índice). También puede utilizar la herramienta Calcular índice de cuadrícula espacial predeterminado para calcular los tamaños óptimos de la cuadrícula.
El agregado de un índice espacial nuevo a una clase de entidad corporativa es una operación que exige esfuerzo al servidor. No debe realizarse en clases de entidad grandes cuando hay una gran cantidad de usuarios conectados al servidor.
Para clases de entidad SQL Server y Oracle, si el índice ya existe, este se suelta y se vuelve a crear. La caja de límite también se vuelve a calcular para las clases de entidad SQL Server.
- Para obtener más información sobre los índices espaciales, consulte las secciones siguientes:
Sintaxis
arcpy.management.AddSpatialIndex(in_features, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})| Parámetro | Explicación | Tipo de datos |
in_features | Clase de entidad corporativa, clase de entidad de geodatabase de archivos o shapefile al que se agrega un índice espacial o cuyo índice espacial se reconstruirá. | Feature Layer; Mosaic Layer; Raster Catalog Layer |
spatial_grid_1 (Opcional) | Los parámetros Cuadrícula espacial 1, 2 y 3 solo se aplican a la geodatabase de archivos y a ciertas clases de entidad de geodatabase corporativa. Si no está familiarizado con la configuración de los tamaños de cuadrícula, deje estas opciones como 0,0,0 y ArcGIS calculará por usted los tamaños óptimos. | Double |
spatial_grid_2 (Opcional) | Tamaño de celda de la segunda cuadrícula espacial. Deje el tamaño en 0 si sólo desea una cuadrícula. En caso contrario, establezca el tamaño en un valor al menos tres veces más alto que la Cuadrícula espacial 1. | Double |
spatial_grid_3 (Opcional) | Tamaño de celda de la tercera cuadrícula espacial. Deje el tamaño en 0 si sólo desea dos cuadrículas. En caso contrario, establezca el tamaño en un valor al menos tres veces más alto que la Cuadrícula espacial 2. | Double |
Muestra de código
Ejemplo de AddSpatialIndex (Ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función AddSpatialIndex en el modo inmediato.
import arcpy
import arcpy.env as ENV
ENV.workspace = "Database Connections/Connection to esoracle.sde"
arcpy.AddSpatialIndex_management("LPI.Land/LPI.PLSSFirstDivision", 500)
Ejemplo 2 de AddSpatialIndex (secuencia de comandos de Python independiente)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función AddSpatialIndex en una secuencia de comandos independiente.
# Name: AddSpatialIndex_Example2.py
# Description: Add a spatial index to a SDE feature class.
# Import system modules
import arcpy
import arcpy.env as ENV
# Set workspace
ENV.workspace = "Database Connections/Connection to esoracle.sde"
# Set local variables
in_features = "LPI.Land/LPI.PLSSFirstDivision"
spatial_grid_1 = "500"
spatial_grid_2 = ""
spatial_grid_3 = ""
# Execute AddSpatialIndex
arcpy.AddSpatialIndex_management(in_features, spatial_grid_1)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí