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 yo 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.
Sintaxis
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})| Parámetro | Explicación | Tipo 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é.
| 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.
| 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; MapServer; 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.
| 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
Si el valor es mayor que cero
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
| Nombre | Explicación | Tipo de datos |
| out_cache_location | El dataset de caché que se creará en la ubicación de la caché de salida. | Dataset ráster |
Muestra de código
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")Esta es una muestra del 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
- 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í