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, reemplazar teselas faltantes, sobrescribir teselas desactualizadas y eliminar teselas.

Uso

  • Al crear una caché de teselas con esta herramienta, si no se especificó un valor para el parámetro Área de interés, la caché se crea con la extensión completa del ráster o dataset de mosaico de origen o la extensión actual del archivo de mapa.

  • La extensión de la caché generada puede ser mayor que el valor del parámetro Área de interés. De ser este el caso, la herramienta divide los datos en áreas grandes, conocidas como superteselas, antes de recortarlas en teselas del tamaño que especificó. Si el valor del parámetro Fuente de datos de entrada se utiliza el antialiasing, la supertesela es de 2.048 x 2.048 píxeles; de lo contrario, es de 4.096 x 4.096. Si la entidad del Área de interés especificada 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 varias áreas de interés que cubren la mayor parte del valor del parámetro 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é, la capa ráster o la ruta a una caché de teselas existente.

Folder; Raster Layer
Administrar modo

Especifica el modo que se utilizará 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é multicapas.
  • 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á en 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 es necesario si el parámetro Administrar modo se ha definido como Eliminar teselas.

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)

Especifica el esquema de ordenamiento en teselas que se utilizará.

  • Esquema de ArcGIS OnlineSe utilizará el esquema de ordenamiento en teselas de ArcGIS Online predeterminado.
  • Importar esquemaSe importará y utilizará un esquema de ordenamiento en teselas existente.
  • Esquema de ordenamiento en teselas de elevaciónSe utilizará el esquema de ordenamiento en teselas de servicios de elevación.
  • Esquema de ordenamiento en teselas WGS84 versión 2Se utilizará el esquema de ordenamiento en teselas WGS84 versión 2.
  • Esquema de ordenamiento en teselas de elevación WGS84 versión 2Se utilizará el esquema de ordenamiento en teselas WGS84 versión 2 para crear una caché de teselas para los datos de elevación.
String
Importar esquema de ordenamiento en teselas
(Opcional)

La ruta de acceso a un archivo de esquema existente (.xml) o un esquema de ordenamiento en teselas 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 se crearán o eliminarán las teselas, en función del valor del parámetro Administrar modo. El tamaño de píxel se basa en la referencia espacial del esquema de ordenamiento en teselas.

  • De forma predeterminada, solo se utilizarán los valores para Escala mínima almacenada en caché y Escala máxima almacenada en caché.
  • 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 los valores de los parámetros Escala mínima almacenada en caché o Escala máxima almacenada en caché se ignorará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 previamente en caché algunas áreas y dejar sin almacenar en caché 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, se aplica lo siguiente:

  • Para los niveles de caché que se encuentran dentro de los rangos visibles 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 la visibilidad de la fuente de datos, la caché se generará a partir del nivel de caché anterior.

Si el valor es mayor que cero, se aplicará lo siguiente:

  • Para los niveles con tamaños de celda menores o iguales que el valor de Tamaño máximo de celda de origen (max_cell_size), la caché se generará a partir de la fuente de datos.
  • Para los niveles con tamaños de celda mayores que el valor Tamaño máximo de celda de origen (max_cell_size), la caché se generará 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 a la que se crearán teselas. Este valor no tiene por qué ser la escala más pequeña del esquema de ordenamiento en teselas. La escala mínima de memoria caché determinará las escalas que se usan al generar la memoria caché.

Double
Escala en caché máxima
(Opcional)

La escala máxima a la que se crearán teselas. No tiene por qué ser la escala más grande del 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é, la capa ráster o la ruta a una caché de teselas existente.

Folder; Raster Layer
manage_mode

Especifica el modo que se utilizará 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é multicapas.
  • 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á en 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 es obligatorio si el parámetro manage_mode se define como DELETE_TILES.

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)

Especifica el esquema de ordenamiento en teselas que se utilizará.

  • ARCGISONLINE_SCHEMESe utilizará el esquema de ordenamiento en teselas de ArcGIS Online predeterminado.
  • IMPORT_SCHEMESe importará y utilizará un esquema de ordenamiento en teselas existente.
  • ARCGISONLINE_ELEVATION_SCHEMESe utilizará el esquema de ordenamiento en teselas de servicios de elevación.
  • WGS84_V2_SCHEMESe utilizará el esquema de ordenamiento en teselas WGS84 versión 2.
  • WGS84_V2_ELEVATION_SCHEMESe utilizará el esquema de ordenamiento en teselas WGS84 versión 2 para crear una caché de teselas para los datos de elevación.
String
import_tiling_scheme
(Opcional)

La ruta de acceso a un archivo de esquema existente (.xml) o un esquema de ordenamiento en teselas 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 se crearán o eliminarán las teselas, en función del valor del parámetro manage_mode. El tamaño de píxel se basa en la referencia espacial del esquema de ordenamiento en teselas.

  • De forma predeterminada, solo se usarán los valores para 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 los valores de los parámetros min_cached_scale o max_cached_scale, se ignorarán 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 previamente en caché algunas áreas y dejar sin almacenar en caché 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, se aplica lo siguiente:

  • Para los niveles de caché que se encuentran dentro de los rangos visibles 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 la visibilidad de la fuente de datos, la caché se generará a partir del nivel de caché anterior.

Si el valor es mayor que cero, se aplicará lo siguiente:

  • Para los niveles con tamaños de celda menores o iguales que el valor de Tamaño máximo de celda de origen (max_cell_size), la caché se generará a partir de la fuente de datos.
  • Para los niveles con tamaños de celda mayores que el valor Tamaño máximo de celda de origen (max_cell_size), la caché se generará 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 a la que se crearán teselas. Este valor no tiene por qué ser la escala más pequeña del esquema de ordenamiento en teselas. La escala mínima de memoria caché determinará las escalas que se usan al generar la memoria caché.

Double
max_cached_scale
(Opcional)

La escala máxima a la que se crearán teselas. No tiene por qué ser la escala más grande del 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