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

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

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

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

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

  • Если параметр Создать кэш не проверяется (в 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

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

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

Обновленный набор данных мозаики.

Слой мозаики

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)