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

Сводка

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

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

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

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

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

Синтаксис

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})
ParameterОбъяснениеТип данных
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

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

NameОбъяснениеТип данных
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)

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

  • Basic: Нет
  • Standard: Да
  • Advanced: Да

Связанные разделы