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

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

Вводит функцию Кэширование растра в качестве последнего шага цепочки функций набора данных мозаики.

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

• Функция Кэширование растра вводится в начало каждой последовательности функций, поэтому эта функция реализуется в цепочке в последнюю очередь.

• Если параметр Создать кэш не проверяется (в Python для generate_cache задано GENERATE_CACHE) при генерации кэша, для этого можно использовать инструмент Синхронизация набора данных мозаики.

• Кэш не будет перемещаться вместе с набором данных мозаики при размещении (публикации) на сервере. Если планируется построение кэша для набора данных мозаики, который публикуется как сервис изображений, рекомендуется применить этот инструмент к набору данных мозаики после публикации. Также, убедитесь в том, что путь к кэшу доступен для сервера. При построении кэша до публикации набора данных мозаики можно переместить кэш на сервер и обновить путь кэша, который хранится в наборе данных мозаики.

Параметры

Диалог

Подпись	Описание	Тип данных
Набор данных мозаики	Набор данных мозаики, для которого вы хотите применить функцию кэша.	Mosaic Layer
Определяющий запрос (Дополнительный)	SQL-выражение для выбора определенных растров в наборе данных мозаики, для которого вы хотите построить кэш элемента.	SQL Expression
Определить кэш (Дополнительный)	Включите редактирование в свойствах Кэша. Отмечено – функция Кэширование растра будет добавлена в выбранные элементы. Если элемент уже содержит эту функцию, повторное добавление функции не выполняется. Используется по умолчанию. Не отмечено – кэш растра не определяется.	Boolean
Построить кэш (Дополнительный)	Сформируйте файлы кэша на основе свойств, определенных в функции Кэширование растра, например, расположение и сжатие кэша. Отмечено – кэш будет создан. Используется по умолчанию. Не отмечено – кэш не будет создан.	Boolean
Путь кэша (Дополнительный)	Выберите перезапись положения по умолчанию для сохранения кэша. Если набор данных мозаики находится внутри файловой базы геоданных, кэш по умолчанию сохраняется в папке с тем же именем, что и база, но с расширением .cache. Если набор данных мозаики находится внутри многопользовательской базы геоданных, кэш по умолчанию сохраняется внутри базы геоданных. После создания кэш всегда хранится в одном месте. Чтобы сохранить кэш в другом местоположении, сначала воспользуйтесь инструментом Восстановить набор данных мозаики для указания нового местоположения, а затем снова запустите этот инструмент. После того, как кэш элемента создан, повторное его создание в другом расположении путем задания другого пути кэша и повторного запуска инструмента уже невозможно. Кэш элемента все равно будет создаваться в том расположении, где он был создан в первый раз. Однако можно удалить эту функцию и добавить новую, имеющую другой путь, или использовать инструмент Восстановление набора данных мозаики для изменения пути кэша, после чего запустить этот инструмент и создать кэш элемента в другом расположении.	Workspace
Метод сжатия (Дополнительный)	Выберите, как вы хотите сжать свои данные для более быстрой передачи. LOSSLESS— Сохранить значения всех пикселов при создании кэша. Сжатие Lossless имеет степень сжатия примерно 2:1. LOSSY— Подходит, если ваши изображения используются только в качестве фона. Lossy имеет самую высокую степень сжатия (20:1), но при его использовании группы пикселов с близкими значениями группируются, что и позволяет достичь высокой степени сжатия. NONE— Не сжимать изображения. Это сделает их передачу более медленной, зато отрисовка будет выполняться быстрее, поскольку в этом случае не требуется выполнять декомпрессию изображений.	String
Качество сжатия (Дополнительный)	Укажите качество сжатия при использования сжатия с потерями. Показатель качества сжатия – это значение в диапазоне от 1 до 100 процентов, где 100 соответствует минимальному сжатию.	Long
Максимальное количество строк (Дополнительный)	Ограничивает размер набора данных кэша числом строк. Если значение меньше числа строк набора данных, кэш не будет создан.	Long
Максимальное количество столбцов (Дополнительный)	Ограничивает размер набора данных кэша числом столбцов. Если значение меньше числа столбцов набора данных, кэш не будет создан.	Long
Тип размера запроса (Дополнительный)	Пересчитывает растр с помощью одного из двух методов: PIXEL_SIZE_FACTOR— Укажите масштабный коэффициент в соответствии с размером пиксела. Чтобы не пересчитывать кэш, выберите Коэффициент размера пиксела и установите для параметра Размер запроса значение 1. PIXEL_SIZE— Укажите размер пиксела кэшированного растра.	String
Размер запроса (Дополнительный)	Укажите значение, чтобы применить Тип размера запроса.	Double

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

Подпись	Описание	Тип данных
Обновленный набор данных мозаики	Обновленный набор данных мозаики.	Слой мозаики

Python

arcpy.management.BuildMosaicDatasetItemCache(in_mosaic_dataset, {where_clause}, {define_cache}, {generate_cache}, {item_cache_folder}, {compression_method}, {compression_quality}, {max_allowed_rows}, {max_allowed_columns}, {request_size_type}, {request_size})

Имя	Описание	Тип данных
in_mosaic_dataset	Набор данных мозаики, для которого вы хотите применить функцию кэша.	Mosaic Layer
where_clause (Дополнительный)	SQL-выражение для выбора определенных растров в наборе данных мозаики, для которого вы хотите построить кэш элемента.	SQL Expression
define_cache (Дополнительный)	Определите кэш для набора данных мозаики. Функция Кэширование растра будет добавлена в выбранные элементы. Если элемент уже содержит функцию Кэширование растра, повторное добавление функции не выполняется. DEFINE_CACHE—Функция Кэширование растра будет добавлена в выбранные элементы. Если элемент уже содержит эту функцию, повторное добавление функции не выполняется. Используется по умолчанию. NO_DEFINE_CACHE—Кэш растра не определяется.	Boolean
generate_cache (Дополнительный)	Сформируйте файлы кэша на основе свойств, определенных в функции Кэширование растра, например, расположение и сжатие кэша. GENERATE_CACHE—Кэш будет создан. Используется по умолчанию. NO_GENERATE_CACHE—Кэш не будет создан.	Boolean
item_cache_folder (Дополнительный)	Выберите перезапись положения по умолчанию для сохранения кэша. Если набор данных мозаики находится внутри файловой базы геоданных, кэш по умолчанию сохраняется в папке с тем же именем, что и база, но с расширением .cache. Если набор данных мозаики находится внутри многопользовательской базы геоданных, кэш по умолчанию сохраняется внутри базы геоданных. После создания кэш всегда хранится в одном месте. Чтобы сохранить кэш в другом местоположении, сначала воспользуйтесь инструментом Восстановить набор данных мозаики для указания нового местоположения, а затем снова запустите этот инструмент. После того, как кэш элемента создан, повторное его создание в другом расположении путем задания другого пути кэша и повторного запуска инструмента уже невозможно. Кэш элемента все равно будет создаваться в том расположении, где он был создан в первый раз. Однако можно удалить эту функцию и добавить новую, имеющую другой путь, или использовать инструмент Восстановление набора данных мозаики для изменения пути кэша, после чего запустить этот инструмент и создать кэш элемента в другом расположении.	Workspace
compression_method (Дополнительный)	Выберите, как вы хотите сжать свои данные для более быстрой передачи. LOSSLESS— Сохранить значения всех пикселов при создании кэша. Сжатие Lossless имеет степень сжатия примерно 2:1. LOSSY— Подходит, если ваши изображения используются только в качестве фона. Lossy имеет самую высокую степень сжатия (20:1), но при его использовании группы пикселов с близкими значениями группируются, что и позволяет достичь высокой степени сжатия. NONE— Не сжимать изображения. Это сделает их передачу более медленной, зато отрисовка будет выполняться быстрее, поскольку в этом случае не требуется выполнять декомпрессию изображений.	String
compression_quality (Дополнительный)	Укажите качество сжатия при использования сжатия с потерями. Показатель качества сжатия – это значение в диапазоне от 1 до 100 процентов, где 100 соответствует минимальному сжатию.	Long
max_allowed_rows (Дополнительный)	Ограничивает размер набора данных кэша числом строк. Если значение меньше числа строк набора данных, кэш не будет создан.	Long
max_allowed_columns (Дополнительный)	Ограничивает размер набора данных кэша числом столбцов. Если значение меньше числа столбцов набора данных, кэш не будет создан.	Long
request_size_type (Дополнительный)	Пересчитывает растр с помощью одного из двух методов: PIXEL_SIZE_FACTOR— Укажите масштабный коэффициент в соответствии с размером пиксела. Чтобы не пересчитывать кэш, выберите PIXEL_SIZE_FACTOR и установите для параметра request_size значение 1. PIXEL_SIZE— Укажите размер пиксела кэшированного растра.	String
request_size (Дополнительный)	Задайте значение, применяемое к request_size_type.	Double

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

Имя	Описание	Тип данных
out_mosaic_dataset	Обновленный набор данных мозаики.	Слой мозаики

Пример кода

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

Это пример скрипта Python для BuildMosaicDatasetItemCache.

import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
     "C:/Workspace/itemcache.gdb/md",  "#", "DEFINE_CACHE", 
     "NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY", 
     "80", "#", "#")

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

Это пример скрипта Python для BuildMosaicDatasetItemCache.

#Define mosaic dataset item cache without generating the cache file

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "itemcache.gdb/md"
query = "#"
definecache = "DEFINE_CACHE"
generatecache = "NO_GENERATE_CACHE"
cachepath = "C:/workspace/itemcache"
compression = "LOSSY"
compquality = "80"
maxrow = "#"
maxcolumn = "#"

arcpy.BuildMosaicDatasetItemCache_management(
     mdname, query, definecache, generatecache, cachepath, compression, 
     compquality, maxrow, maxcolumn)

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

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