Administrar caché de teselas (Administración de datos)

Resumen

Crea una caché de teselas o actualiza las teselas de una caché de teselas existente. Puede utilizar esta herramienta para crear teselas nuevas, reemplazar teselas faltantes, sobrescribir teselas desactualizadas y eliminar teselas.

Uso

  • Al crear una caché de teselas utilizando la herramienta Administrar caché de teselas, si no se ha definido un Área de interés, la caché se crea con la extensión completa del ráster de origen o el dataset de mosaico, o bien la extensión actual de un archivo de mapa.

  • Hay casos en los que la extensión de la caché generada es superior al Área de interés. Si esto ocurre, la herramienta Administrar caché de teselas divide los datos en áreas grandes, conocidas como superteselas, antes de recortarlas en teselas del tamaño que solicitó. Si en la Fuente de datos de entrada se utiliza el antialiasing, la supertesela tiene 2.048 x 2.048 píxeles; de lo contrario, tiene 4.096 x 4.096. Si la entidad del Área de interés definida interseca el límite de una supertesela, se creará toda la supertesela. Esto significa que puede que tenga que acercarla antes de que el almacenamiento en caché por clase de entidad pueda tener un efecto al ahorrar tiempo o espacio en disco. Si tiene muchas áreas de interés que cubren la mayor parte de la Fuente de datos de entrada, es posible que no obtenga mucho beneficio del almacenamiento en caché por clase de entidad porque la mayoría de sus entidades intersecarán una supertesela.

  • Para crear una caché en un esquema de ordenamiento en teselas personalizado, asegúrese de que cuenta con un esquema de ordenamiento en teselas definido para el dataset de origen antes de utilizar esta herramienta. Puede usar la herramienta Generar esquema de ordenamiento en teselas de caché de teselas para crear el esquema de ordenamiento en teselas.

  • Para crear una caché en un esquema de ordenamiento en teselas de ArcGIS Online, especifique Usar esquema de ArcGIS Online para el parámetro Esquema de ordenamiento en teselas de entrada (defina tiling_scheme como ARCGISONLINE_SCHEME en Python).

  • Esta herramienta puede tardar un tiempo considerable en ejecutarse para las cachés que cubren una extensión geográfica grande o escalas muy grandes. Si la herramienta se cancela, la creación de teselas se detiene, pero las teselas existentes no se eliminan. Esto significa que se puede cancelar la herramienta en cualquier momento y, si se vuelve a ejecutar más tarde en la misma caché y se especifica Volver a crear teselas vacías para el parámetro Administrar modo, continuará en el punto en el que se detuvo (defina manage_mode como RECREATE_EMPTY_TILES en Python).

  • Esta herramienta admite el parámetro de entorno Procesamiento en paralelo.

Parámetros

EtiquetaExplicaciónTipo de datos
Ubicación de caché

La carpeta en la que se crea el dataset de la caché o la ruta a una caché de teselas existente.

Folder; Raster Layer
Administrar modo

Modo para administrar la caché.

  • Volver a crear todas las teselasLas teselas existentes se reemplazarán y se agregarán teselas nuevas si la extensión cambió o si las capas se agregaron a una caché multicapa.
  • Volver a crear teselas vacíasSolo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios.
  • Eliminar teselasLas teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.
String
Nombre de caché
(Opcional)

El nombre del dataset de caché que se creará dentro de la ubicación de la caché.

String
Fuente de datos de entrada
(Opcional)

Un dataset ráster, un dataset de mosaico o un archivo de mapa.

Este parámetro no se necesita cuando se especifica Eliminar teselas en el parámetro Administrar modo.

Un archivo de mapa (.mapx) no puede contener un servicio de mapas ni un servicio de imágenes.

Mosaic Layer; Raster Layer; Map
Esquema de ordenamiento en teselas de entrada
(Opcional)

Un parámetro opcional para especificar el esquema de ordenamiento en teselas.

  • Esquema de ArcGIS OnlineUtilice el esquema de ordenamiento en teselas predeterminado de ArcGIS Online.
  • Importar esquemaImporte un esquema de ordenamiento en teselas existente.
  • Esquema de ordenamiento en teselas de elevaciónUtilice este esquema de ordenamiento en teselas para servicios de elevación.
  • Esquema de ordenamiento en teselas WGS84 versión 2Utilice este esquema de ordenamiento en teselas basado en WGS84, versión 2.
  • Esquema de ordenamiento en teselas de elevación WGS84 versión 2Utilice este esquema de ordenamiento en teselas basado en WGS84, versión 2, para crear una caché de teselas para datos de elevación.
String
Importar esquema de ordenamiento en teselas
(Opcional)

Ruta de acceso a un archivo de esquema existente (.xml) o importado desde un servicio de mapas o un servicio de imágenes existente.

Image Service; Map Server; File
Escalas [Tamaño de píxel] (Espacio en disco estimado)
(Opcional)

Los niveles de escala en los que creará o eliminará teselas cuando ejecute esta herramienta, dependiendo del valor del parámetro Administrar modo. El tamaño de píxel se representa en función de la referencia espacial del esquema de ordenamiento en teselas.

  • De forma predeterminada, solo se activarán las escalas dentro de Escala de caché mínima y Escala de caché máxima.
  • La alteración del valor de los parámetros Escala de caché mínima o Escala de caché máxima producirá la activación o desactivación de los valores de escala apropiados.
  • Las escalas activadas que no estén dentro del rango de Escala de caché mínima o Escala de caché máxima se omitirán al generar la caché.
Double
Área de interés
(Opcional)

Define un área de interés para restringir dónde se van a crear o eliminar las teselas.

Puede ser una clase de entidad o puede ser un conjunto de entidades que se defina de forma interactiva.

Este parámetro es útil si desea administrar teselas para áreas con formas irregulares. También es útil en situaciones donde desea almacenar en la caché algunas áreas y dejar sin almacenar las áreas menos visitadas.

Feature Set
Tamaño máximo de celda original
(Opcional)

El valor que define la visibilidad de la fuente de datos para la que se generará la caché. De manera predeterminada, el valor está vacío.

Si el valor está vacío

  • Para los niveles de caché que se encuentran dentro de los rangos de visibilidad de la fuente de datos, la caché se genera a partir de la fuente de datos.
  • Para los niveles de caché que se encuentran fuera de los rangos de visibilidad de la fuente de datos, la caché se genera a partir del nivel de caché anterior.

Si el valor es mayor que cero

  • Para los niveles con tamaños de celda menores o iguales que Tamaño máximo de celda de origen (max_cell_size), la caché se genera a partir de la fuente de datos.
  • Para los niveles con tamaños de celda mayores que Tamaño máximo de celda de origen (max_cell_size), la caché se genera a partir del nivel de caché anterior.

La unidad del valor de Tamaño máximo de celda de origen debe ser la misma que la unidad del tamaño de celda del dataset de origen.

Double
Escala de caché mínima
(Opcional)

La escala mínima en la que desea crear las teselas. No es necesario que sea la escala más pequeña en su esquema de ordenamiento en teselas. La escala mínima determinará las escalas que se usarán al generar la memoria caché.

Double
Escala en caché máxima
(Opcional)

La escala máxima en la que desea crear las teselas. No es necesario que sea la escala más grande en su esquema de ordenamiento en teselas. La escala máxima determinará las escalas que se usarán al generar la caché.

Double

Salida derivada

EtiquetaExplicaciónTipo de datos
Nombre de caché

El dataset de caché que se creará en la ubicación de la caché de salida.

Raster Dataset

arcpy.management.ManageTileCache(in_cache_location, manage_mode, {in_cache_name}, {in_datasource}, {tiling_scheme}, {import_tiling_scheme}, {scales}, {area_of_interest}, {max_cell_size}, {min_cached_scale}, {max_cached_scale})
NombreExplicaciónTipo de datos
in_cache_location

La carpeta en la que se crea el dataset de la caché o la ruta a una caché de teselas existente.

Folder; Raster Layer
manage_mode

Modo para administrar la caché.

  • RECREATE_ALL_TILESLas teselas existentes se reemplazarán y se agregarán teselas nuevas si la extensión cambió o si las capas se agregaron a una caché multicapa.
  • RECREATE_EMPTY_TILESSolo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios.
  • DELETE_TILESLas teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.
String
in_cache_name
(Opcional)

El nombre del dataset de caché que se creará dentro de la ubicación de la caché.

String
in_datasource
(Opcional)

Un dataset ráster, un dataset de mosaico o un archivo de mapa.

Este parámetro no se necesita cuando se especifica DELETE_TILES en el parámetro manage_mode.

Un archivo de mapa (.mapx) no puede contener un servicio de mapas ni un servicio de imágenes.

Mosaic Layer; Raster Layer; Map
tiling_scheme
(Opcional)

Un parámetro opcional para especificar el esquema de ordenamiento en teselas.

  • ARCGISONLINE_SCHEMEUtilice el esquema de ordenamiento en teselas predeterminado de ArcGIS Online.
  • IMPORT_SCHEMEImporte un esquema de ordenamiento en teselas existente.
  • ARCGISONLINE_ELEVATION_SCHEMEUtilice este esquema de ordenamiento en teselas para servicios de elevación.
  • WGS84_V2_SCHEMEUtilice este esquema de ordenamiento en teselas basado en WGS84, versión 2.
  • WGS84_V2_ELEVATION_SCHEMEUtilice este esquema de ordenamiento en teselas basado en WGS84, versión 2, para crear una caché de teselas para datos de elevación.
String
import_tiling_scheme
(Opcional)

Ruta de acceso a un archivo de esquema existente (.xml) o importado desde un servicio de mapas o un servicio de imágenes existente.

Image Service; Map Server; File
scales
[scale,...]
(Opcional)

Los niveles de escala en los que creará o eliminará teselas cuando ejecute esta herramienta, dependiendo del valor del parámetro manage_mode. El tamaño de píxel se representa en función de la referencia espacial del esquema de ordenamiento en teselas.

  • De forma predeterminada, solo se usarán las escalas dentro de min_cached_scale y max_cached_scale al generar la caché.
  • La alteración del valor de los parámetros min_cached_scale o max_cached_scale cambiará las escalas que se vayan a usar al generar la caché.
  • Las escalas que existen, pero no están dentro del rango de min_cached_scale o max_cached_scale, se omiten al generar la caché.
Double
area_of_interest
(Opcional)

Define un área de interés para restringir dónde se van a crear o eliminar las teselas.

Puede ser una clase de entidad o puede ser un conjunto de entidades que se defina de forma interactiva.

Este parámetro es útil si desea administrar teselas para áreas con formas irregulares. También es útil en situaciones donde desea almacenar en la caché algunas áreas y dejar sin almacenar las áreas menos visitadas.

Feature Set
max_cell_size
(Opcional)

El valor que define la visibilidad de la fuente de datos para la que se generará la caché. De manera predeterminada, el valor está vacío.

Si el valor está vacío

  • Para los niveles de caché que se encuentran dentro de los rangos de visibilidad de la fuente de datos, la caché se genera a partir de la fuente de datos.
  • Para los niveles de caché que se encuentran fuera de los rangos de visibilidad de la fuente de datos, la caché se genera a partir del nivel de caché anterior.

Si el valor es mayor que cero

  • Para los niveles con tamaños de celda menores o iguales que Tamaño máximo de celda de origen (max_cell_size), la caché se genera a partir de la fuente de datos.
  • Para los niveles con tamaños de celda mayores que Tamaño máximo de celda de origen (max_cell_size), la caché se genera a partir del nivel de caché anterior.

La unidad del valor de Tamaño máximo de celda de origen debe ser la misma que la unidad del tamaño de celda del dataset de origen.

Double
min_cached_scale
(Opcional)

La escala mínima en la que desea crear las teselas. No es necesario que sea la escala más pequeña en su esquema de ordenamiento en teselas. La escala mínima determinará las escalas que se usarán al generar la memoria caché.

Double
max_cached_scale
(Opcional)

La escala máxima en la que desea crear las teselas. No es necesario que sea la escala más grande en su esquema de ordenamiento en teselas. La escala máxima determinará las escalas que se usarán al generar la caché.

Double

Salida derivada

NombreExplicaciónTipo de datos
out_cache_location

El dataset de caché que se creará en la ubicación de la caché de salida.

Raster Dataset

Muestra de código

Ejemplo 1 de ManageTileCache (ventana de Python)

Esta es una muestra de Python para la herramienta ManageTileCache.

import arcpy
            
arcpy.ManageTileCache_management(
      "C:/CacheDatasets/Manage", "RECREATE_ALL_TILES", "Test",
      "C:/Data/Cache.gdb/Md", "IMPORT_SCHEME", "C:/Data/Cache.gdb/Md",
      "#", "#", "#", "40000", "2000")
Ejemplo 2 de ManageTileCache (script independiente)

Esta es una muestra de script de Python para la herramienta ManageTileCache.

#Generate tile cache for 3 out of 5 levels defined in tiling scheme

import arcpy

folder = "C:/Workspace/CacheDatasets/Manage"
mode = "RECREATE_ALL_TILES"
cacheName = "Test"
dataSource = "C:/Workspace/Cache.gdb/md"
method = "IMPORT_SCHEME"
tilingScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
scales = "16000;8000;4000;2000;1000"
areaofinterest = "#"
maxcellsize = "#"
mincachedscale = "8000"
maxcachedscale = "2000"

arcpy.ManageTileCache_management(
       folder, mode, cacheName, dataSource, method, tilingScheme,
       scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale)

Entornos

Casos especiales

Factor de procesamiento en paralelo

Si el valor del factor de procesamiento en paralelo está vacío (en blanco), la herramienta se ejecutará con un valor predeterminado del 50% (la mitad) de los núcleos disponibles.

Información de licenciamiento

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

Temas relacionados