Управление полистным кэшем (Управление данными)

Краткая информация

Создает полистный кэш или обновляет листы в существующем полистном кэше. Этот инструмент используется для создания новых листов, замены недостающих листов, перезаписи устаревших листов и для их удаления.

Использование

• При создании кэша листов с помощью этого инструмента, если не задан параметр Область интереса, кэш создается с полным экстентом исходного растра, набора данных мозаики или текущим экстентом файла карты.

• Экстент созданного кэша может быть больше, чем Область интереса. В этом случае инструмент разделяет данные на области большего размера, известные как суперлисты, прежде чем разрезать их на листы запрашиваемого размера. Если параметр Входной источник данных использует сглаживание, суперлист имеет размер 2048 на 2048 пикселов, в противном случае, 4096 на 4096 пикселов. Когда определенный объект Области интереса пересекает границу суперлиста, весь этот суперлист будет создан. Это означает, что вам может потребоваться некоторое масштабирование, прежде чем кэширование по классу объектов начнет действительно экономить время или место на диске. Если у вас много областей интереса и они покрывают большую часть параметра Входной источник данных, вы можете не почувствовать преимущества кэширования по классу объектов, поскольку большая часть объектов пересечет суперлист.

• Чтобы создать полистный кэш в пользовательской схеме разбивки на листы, убедитесь, что с помощью этого инструмента была определена схема разбивки на листы для вашего исходного набора данных. Вы можете создать схему разбивки на листы, используя инструмент Создать схему разбивки на листы полистного кэша.

• Для создания кэша в схеме разбивки на листы ArcGIS Online укажите схема ArcGIS Online для параметра Входная схема листов.

• Этому инструменту может потребоваться много времени на запуск для кэшей, охватывающих большой географический экстент или очень крупные масштабы. Если этот инструмент будет отменен, создание листов будет прекращено, но существующие листы не будут удалены. Это означает, что вы в любое время можете отменить этот инструмент, и если вы позже запустите его на том же кэше, указав Заново создать пустые листы для параметра Режим управления, то он продолжит работу с того места, где был остановлен.

• Этот инструмент поддерживает настройку среды Параллельная обработка.

• Если отмечен параметр Готовый для обслуживания формат, содержание кэша создается с использованием открытой спецификации пакета листов. Формат кэша — Compact V2, но схема кэша хранится в JSON вместо XML. Дополнительную информацию о формате см. в разделе Публикация слоя листов из набора данных кэша.

Параметры

Диалог

Подпись	Описание	Тип данных
Местоположение кэша	Папка, в которой будет создан набор данных кэша, растровый слой или путь к существующему полистному кэшу.	Folder; Raster Layer
Режим управления	Определяет режим, который будет использован при управлении кэша. Повторно создать все листы—Существующие листы будут заменены, а новые листы добавлены, если экстент изменился или были добавлены слои в многослойный кэш. Заново создать пустые листы—В этом случае создаются только пустые листы. Существующие листы останутся неизменными. Удалить листы—Листы будут удалены из кэша. Структура папки кэша не будет удалена.	String
Имя кэша (Дополнительный)	Имя набора данных кэша, который будет создан в местоположении кэша.	String
Входной источник данных (Дополнительный)	Набор растровых данных, набор данных мозаики или файл карты. Этот параметр необязателен, если в параметре Режим управления указано Удалить листы. Файл карты (.mapx) не может содержать картографический сервис или сервис изображений.	Mosaic Layer; Raster Layer; Map
Входная схема листов (Дополнительный)	Определяет используемую схему листов. Схема ArcGIS Online—Будет использована схема листов ArcGIS Online по умолчанию. Импорт схемы—Будет импортирована и использована существующая схема листов. Схема листов для высот—Будет использована схема листов сервиса высот. Схема листов WGS84 версия 2—Будет использована схема листов WGS84 версия 2 Схема листов высот WGS84 версия 2—Будет использована схема листов на основе WGS84 версия 2 для построения кэша для данных высот.	String
Импорт схемы листов (Дополнительный)	Путь к существующему файлу схемы (.xml) или к схеме листов, импортированной из имеющегося сервиса изображений или картографического сервиса.	Image Service; Map Server; File
Масштабы [Размер пиксела] (Предполагаемое дисковое пространство) (Дополнительный)	Уровни масштабирования, на которых создаются или удаляются листы, зависит от значения параметра Режим управления. Размер пикселов определяется на основе пространственной привязки схемы разбивки на листы. По умолчанию будут проверены только масштабы в пределах Минимального кэшируемого масштаба и Максимального кэшируемого масштаба. В случае изменения любого из параметров Минимальный кэшируемый масштаб или Максимальный кэшируемый масштаб соответствующие значения масштабов будут включены или отключены. Отмеченные, но не попадающие в диапазон Минимальный кэшируемый масштаб или Максимальный кэшируемый масштаб значения параметра будут проигнорированы при создании кэша.	Double
Область интереса (Дополнительный)	Область интереса, которая будет использоваться для хранения листов, которые будут созданы или удалены. Это может быть класс объектов или объект, заданный в интерактивном режиме. Этот параметр полезен, если вы хотите управлять листами для областей неправильной формы. Он также полезен, если вы хотите выполнить предварительное кэширование каких-то районов и оставить менее посещаемые области некэшированными.	Feature Set
Максимальный размер ячейки источника (Дополнительный)	Значение, которое определяет видимость источника данных, для которого будет создаваться кэш. По умолчанию значение не заполнено. Если значение пустое, применяется следующее: Для уровней кэша, находящихся в пределах видимости источника данных, кэш создается из данных источника. Для уровней кэша, выходящих за пределы видимости источника данных, кэш создается из данных предыдущего уровня кэша. Если значение больше 0, применяется следующее: Для уровней с размером ячеек меньше или равным этому значению параметра кэш создается из данных источника. Для уровней с размером ячеек больше этого значения параметра кэш создается из данных предыдущего уровня кэша. Единица измерения значения этого параметра должна совпадать с единицей измерения размера ячейки исходного набора данных.	Double
Минимальный масштаб кэширования (Дополнительный)	Минимальный масштаб, на котором создаются листы. Это значение необязательно должно быть наименьшим масштабом в схеме листов. Минимальный масштаб кэширования определяет, какие масштабы будут использоваться при создании кэша.	Double
Максимальный масштаб кэширования (Дополнительный)	Максимальный масштаб, на котором создаются листы. Это значение необязательно должно быть наибольшим масштабом в схеме листов. Максимальный масштаб кэширования определяет, какие масштабы будут использоваться при создании кэша.	Double
Готовый для обслуживания формат (Дополнительный)	Указывает, будет ли содержание кэша создаваться с использованием открытой спецификации пакета листов, а также указывает формат файла схемы кэша. Отмечен - содержание кэша будет создаваться с использованием открытой спецификации пакета листов. Пакет листов можно упаковать в zip-архив в виде пакета листов для автономных рабочих процессов. Формат кэша - Compact V2, а схема кэша хранится в формате JSON. Не выбран - содержание кэша будет сформировано с использованием схемы, сохраненной в формате XML. Это значение по умолчанию	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Имя кэша	Кэшированный набор данных, который будет создан в местоположении выходного кэша.	Raster Dataset

Python

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}, {ready_to_serve_format})

Имя	Описание	Тип данных
in_cache_location	Папка, в которой будет создан набор данных кэша, растровый слой или путь к существующему полистному кэшу.	Folder; Raster Layer
manage_mode	Определяет режим, который будет использован при управлении кэша. RECREATE_ALL_TILES—Существующие листы будут заменены, а новые листы добавлены, если экстент изменился или были добавлены слои в многослойный кэш. RECREATE_EMPTY_TILES—В этом случае создаются только пустые листы. Существующие листы останутся неизменными. DELETE_TILES—Листы будут удалены из кэша. Структура папки кэша не будет удалена.	String
in_cache_name (Дополнительный)	Имя набора данных кэша, который будет создан в местоположении кэша.	String
in_datasource (Дополнительный)	Набор растровых данных, набор данных мозаики или файл карты. Этот параметр необходим, если параметр manage_mode задан как DELETE_TILES. Файл карты (.mapx) не может содержать картографический сервис или сервис изображений.	Mosaic Layer; Raster Layer; Map
tiling_scheme (Дополнительный)	Определяет используемую схему листов. ARCGISONLINE_SCHEME—Будет использована схема листов ArcGIS Online по умолчанию. IMPORT_SCHEME—Будет импортирована и использована существующая схема листов. ARCGISONLINE_ELEVATION_SCHEME—Будет использована схема листов сервиса высот. WGS84_V2_SCHEME—Будет использована схема листов WGS84 версия 2 WGS84_V2_ELEVATION_SCHEME—Будет использована схема листов на основе WGS84 версия 2 для построения кэша для данных высот.	String
import_tiling_scheme (Дополнительный)	Путь к существующему файлу схемы (.xml) или к схеме листов, импортированной из имеющегося сервиса изображений или картографического сервиса.	Image Service; Map Server; File
scales [scale,...] (Дополнительный)	Уровни масштабирования, на которых создаются или удаляются листы, зависит от значения параметра manage_mode. Размер пикселов определяется на основе пространственной привязки схемы разбивки на листы. По умолчанию, при генерации кэша будут использоваться только значения в пределах min_cached_scale и max_cached_scale. В случае изменения параметров min_cached_scale или max_cached_scale будут также изменены и масштабы, используемые при создании кэша. Имеющиеся масштабы, не попадающие в диапазон min_cached_scale или max_cached_scale, будут игнорироваться при создании кэша.	Double
area_of_interest (Дополнительный)	Область интереса, которая будет использоваться для хранения листов, которые будут созданы или удалены. Это может быть класс объектов или объект, заданный в интерактивном режиме. Этот параметр полезен, если вы хотите управлять листами для областей неправильной формы. Он также полезен, если вы хотите выполнить предварительное кэширование каких-то районов и оставить менее посещаемые области некэшированными.	Feature Set
max_cell_size (Дополнительный)	Значение, которое определяет видимость источника данных, для которого будет создаваться кэш. По умолчанию значение не заполнено. Если значение пустое, применяется следующее: Для уровней кэша, находящихся в пределах видимости источника данных, кэш создается из данных источника. Для уровней кэша, выходящих за пределы видимости источника данных, кэш создается из данных предыдущего уровня кэша. Если значение больше 0, применяется следующее: Для уровней с размером ячеек меньше или равным этому значению параметра кэш создается из данных источника. Для уровней с размером ячеек больше этого значения параметра кэш создается из данных предыдущего уровня кэша. Единица измерения значения этого параметра должна совпадать с единицей измерения размера ячейки исходного набора данных.	Double
min_cached_scale (Дополнительный)	Минимальный масштаб, на котором создаются листы. Это значение необязательно должно быть наименьшим масштабом в схеме листов. Минимальный масштаб кэширования определяет, какие масштабы будут использоваться при создании кэша.	Double
max_cached_scale (Дополнительный)	Максимальный масштаб, на котором создаются листы. Это значение необязательно должно быть наибольшим масштабом в схеме листов. Максимальный масштаб кэширования определяет, какие масштабы будут использоваться при создании кэша.	Double
ready_to_serve_format (Дополнительный)	Указывает, будет ли содержание кэша создаваться с использованием открытой спецификации пакета листов, а также указывает формат файла схемы кэша. READY_TO_SERVE_FORMAT—Содержание кэша будет создаваться с использованием открытой спецификации пакета листов (https://github.com/Esri/tile-package-spec). Пакет листов можно упаковать в zip-архив в виде пакета листов для автономных рабочих процессов. Формат кэша - Compact V2, а схема кэша хранится в формате JSON. NON_READY_TO_SERVE_FORMAT—Содержание кэша будет сформировано с использованием схемы, сохраненной в формате XML. Это значение по умолчанию	Boolean

Производные выходные данные

Имя	Описание	Тип данных
out_cache_location	Кэшированный набор данных, который будет создан в местоположении выходного кэша.	Raster Dataset

Пример кода

ManageTileCache, пример 1 (окно Python)

Это пример Python для функции 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", "NON_READY_TO_SERVE_FORMAT")

ManageTileCache, пример 2 (автономный скрипт)

Это пример скрипта Python для функции 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"
ready_to_serve_format="NON_READY_TO_SERVE_FORMAT"

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

Параметры среды

Коэффициент параллельной обработки

Особые случаи

Коэффициент параллельной обработки

Если значение Коэффициента параллельной обработки не задано (пусто), то инструмент запустится со значением по умолчанию, которое равно 50% (одна вторая) доступных ядер.

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да