Resumen
Agrega un índice espacial a un shapefile, una geodatabase de archivos o una clase de entidad de ArcSDE. Utilice esta herramienta para agregar un índice espacial a un shapefile o una clase de entidad que aún no tenga uno o para reconstruir 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 basado en cuadrícula que abarca la extensión de las entidades de una clase de entidad, como la cuadrícula del localizador que se puede encontrar en los mapas de carreteras comunes.
De manera predeterminada, 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 Cuadrícula espacial 1, 2 y 3 solo se usan en las geodatabases de archivos y en ciertas clases de entidad de geodatabase de ArcSDE (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 de ArcSDE (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). La cuadrícula espacial 2 debe ser al menos tres veces más grande que la cuadrícula espacial 1, y la cuadrícula espacial 3 debe ser al 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 de ArcSDE es una operación que exige esfuerzo al servidor. No debe realizarse en clases de entidad grandes cuando hay un gran número de usuarios conectados al servidor.
- Para obtener más información sobre los índices espaciales, consulte las secciones siguientes:
Sintaxis
AddSpatialIndex_management (in_features, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})| Parámetro | Explicación | Tipo de datos |
in_features | Clase de entidad de ArcSDE, 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 usan en la geodatabase de archivos y en ciertas clases de entidad de geodatabase de ArcSDE. 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 como al menos tres veces más grande que 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 como al menos tres veces más grande que Cuadrícula espacial 2. | Double |
Ejemplo 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 sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí