Сводка
Создает полистный кэш или обновляет листы в существующем полистном кэше. Этот инструмент используется для создания новых листов, замены недостающих листов, перезаписи устаревших листов и для их удаления.
Использование
Значением параметра Входной источник данных может быть карта, но документ не может содержать картографический сервис и сервис изображений.
При создании кэша листов с помощью этого инструмента, если параметр Область интереса не задан, кэш создается с полным экстентом растра и текущим экстентом документа карты.
Экстент созданного кэша может быть больше, чем Область интереса. Если это произошло, инструмент разделяет данные на области большего размера, известные как суперлисты, прежде чем разрезать их на листы запрашиваемого размера. Если параметр Входной источник данных использует сглаживание, суперлист имеет размер 2048 на 2048 пикселов, в противном случае, 4096 на 4096 пикселов. Когда определенный объект Области интереса пересекает границу суперлиста, весь этот суперлист будет создан. Это означает, что вам может потребоваться некоторое масштабирование, прежде чем кэширование по классу объектов начнет действительно экономить время или место на диске. Если у вас много областей интереса и они покрывают большую часть параметра Входной источник данных, вы можете не почувствовать преимущества кэширования по классу объектов, поскольку большая часть объектов пересечет суперлист.
Чтобы создать полистный кэш в пользовательской схеме разбивки на листы, убедитесь, что с помощью этого инструмента была определена схема разбивки на листы для вашего исходного набора данных. Вы можете создать схему разбивки на листы, используя инструмент Создать схему разбивки на листы полистного кэша.
Для создания кэша в схеме разбивки на листы ArcGIS Online укажите ARCGISONLINE_SCHEME для параметра Входная схема листов.
Этому инструменту может потребоваться много времени на запуск для кэшей, охватывающих большой географический экстент или очень крупные масштабы. Если этот инструмент будет отменен, создание листов будет прекращено, но существующие листы не будут удалены. Это означает, что вы в любое время можете отменить этот инструмент, и если вы позже запустите его на том же кэше, указав RECREATE_EMPTY_TILES для параметра Режим управления, то он продолжит работу с того места, где был остановлен.
Этот инструмент поддерживает настройку среды Параллельная обработка.
Синтаксис
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})
Параметр | Объяснение | Тип данных |
in_cache_location | Папка, в которой создаётся набор данных кэша, растровый слой или путь к существующему полистному кэшу. | Folder; Raster Layer |
manage_mode | Определяет режим, который будет использован при управлении кэша.
| String |
in_cache_name (Дополнительный) | Имя набора данных кэша, который будет создан в местоположении кэша. | String |
in_datasource (Дополнительный) | Набор растровых данных, набор данных мозаики или документ карты. Этот параметр не требуется, если для параметра manage_mode указано DELETE_TILES. Документ ArcMap (.mxd) не может содержать картографический сервис или сервис изображений. | ArcMap Document; Mosaic Layer; Raster Layer |
tiling_scheme (Дополнительный) | Определяет используемую схему листов.
| String |
import_tiling_scheme (Дополнительный) | Путь к существующему файлу схемы (.xml) или к схеме листов, импортированной из имеющегося сервиса изображений или картографического сервиса. | Image Service; Map Server; File |
scales [scale,...] (Дополнительный) | Уровни масштабирования, на которых создаются или удаляются листы, зависит от значения параметра manage_mode. Размер пикселов определяется на основе пространственной привязки схемы разбивки на листы.
| Double |
area_of_interest (Дополнительный) | Ограничивает ту область интереса, где листы будут созданы или удалены. Это может быть класс объектов или объект, заданный в интерактивном режиме. Этот параметр полезен, если вы хотите управлять листами для областей неправильной формы. Он также полезен, если вы хотите выполнить предварительное кэширование каких-то районов и оставить менее посещаемые области некэшированными. | Feature Set |
max_cell_size (Дополнительный) |
Значение, которое определяет видимость источника данных, для которого будет создаваться кэш. По умолчанию значение не заполнено. Если значение пустое, применяется следующее:
Если значение больше 0, применяется следующее:
Единицы значения Максимального размера ячейки источника и размер ячейки набора данных источника должны быть одинаковыми. | Double |
min_cached_scale (Дополнительный) | Минимальный масштаб, на котором создаются листы. Он необязательно должен быть наименьшим масштабом в схеме листов. Минимальный масштаб кэширования определяет, какие масштабы будут использоваться при создании кэша. | Double |
max_cached_scale (Дополнительный) | Максимальный масштаб, на котором создаются листы. Он необязательно должен быть наибольшим масштабом в схеме листов. Максимальный масштаб кэширования определяет, какие масштабы будут использоваться при создании кэша. | Double |
Производные выходные данные
Имя | Объяснение | Тип данных |
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")
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"
arcpy.ManageTileCache_management(
folder, mode, cacheName, dataSource, method, tilingScheme,
scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да