Краткая информация
Добавляет в набор данных мозаики наборы растровых данных из многих источников, включая файлы, папки, таблицы и веб-сервисы.
Использование
Добавляемые растровые данные являются неуправляемыми; поэтому удаление или перемещение растровых данных будет влиять на набор данных мозаики.
Вы можете добавлять растры только в набор данных мозаики, находящийся в базе геоданных. Наборы данных мозаики, которые созданы вне базы геоданных, могут содержать лишь заранее созданные наборы данных мозаики.
Параметр Растровый тип служит для идентификации метаданных, требуемых для загрузки растров в набор данных мозаики.
Для более быстрого отображения и обработки, можно сгенерировать кэш пикселов набора данных мозаики, если выбрать опцию Включить кэш пикселов.
Синтаксис
AddRastersToMosaicDataset(in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description}, {force_spatial_reference}, {estimate_statistics}, {aux_inputs}, {enable_pixel_cache}, {cache_location})
Параметр | Объяснение | Тип данных |
in_mosaic_dataset | Путь или имя набора данных мозаики, к которому будут добавляться растровые данные. | Mosaic Layer |
raster_type | Растровый тип является специфичным для продуктов изображений. Он идентифицирует метаданные, например, пространственную привязку, дату приобретения и тип сенсора, а также формат растра. Список типов растров можно найти в разделе Перечень поддерживаемых форматов изображений и растровых данных. При использовании растровых типов LAS, Набор данных LAS или Terrain, необходимо применять файл .art, где указан размер ячейки. | Raster Type |
input_path [input_path,...] | Задает путь и имя файла, папки, набора растровых данных, набора данных мозаики, таблицы или сервиса. Не все типы входных данных будут доступны. Доступные варианты зависят от выбранного типа растра.
| File; Image Service; LAS Dataset Layer; Layer File; MapServer; Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (Дополнительный) | Задает возможность вычисления диапазонов размеров ячеек каждого растра в наборе данных мозаики. Эти значения записываются в таблицу атрибутов в полях minPS и maxPS.
| Boolean |
update_boundary (Дополнительный) | Задает, будет ли ограничивающий полигон набора данных мозаики сгенерирован или обновлен. По умолчанию объединяются все полигоны контуров для создания единой границы, представляющей экстент значащих пикселов.
| Boolean |
update_overviews (Дополнительный) | Задает, будет ли задаваться и генерироваться обзорные изображения набора данных мозаики.
| Boolean |
maximum_pyramid_levels (Дополнительный) | Максимальное количество уровней пирамидных слоев, которые будут использоваться в наборе данных мозаики. Например, при значении 2 будут использоваться только первые два пирамидных слоя из исходного растра. Если вы оставите этот параметр незаполненным или введете значение -1, пирамидные слои будут построены для всех уровней. Значение может влиять на отображение и количество создаваемых общих видов. | Long |
maximum_cell_size (Дополнительный) | Максимальный размер ячейки пирамидного слоя, который будет использоваться в наборе данных мозаики. | Double |
minimum_dimension (Дополнительный) | Минимальные измерения пирамидного слоя растра, который будет использоваться в наборе данных мозаики. | Long |
spatial_reference (Дополнительный) | Система пространственной привязки входных данных. Должна быть задана, если данные не имеют системы координат; в противном случае будет использоваться система координат набора данных мозаики. Также может использоваться для перезаписи системы координат входных данных. | Spatial Reference |
filter (Дополнительный) | Фильтр данных, добавляемых в набор данных мозаики. Для создания фильтра данных могут использоваться выражения SQL. Символ звездочки или другие подобные символы в составе фильтра могут приниматься за полный путь к входным данным. Следующее SQL выражение выберет строки, в которых совпадают следующие ID объектов:
Если необходимо добавить только изображение в формате TIFF, добавьте символ звездочки перед расширением файла.
Если необходимо добавить все изображения со словом "sensor" в составе пути файла или имени файла, поставьте символ звездочки как перед этим словом, так и после него.
Также для создания фильтра данных может использоваться синтаксис PERL.
Следующий синтаксис PERL с множественной языковой группировкой в качестве части выражения не поддерживается:
Вместо этого можно использовать следующий синтаксис:
| String |
sub_folder (Дополнительный) | Задает рекурсивный поиск данных во вложенных папках.
| Boolean |
duplicate_items_action (Дополнительный) | Задает способ обработки дублирующихся растров. Проверка будет выполнена, чтобы увидеть, были ли растры уже добавлены, с помощью исходного пути и имени файла. Выберите, какое действие выполнять, если найден одинаковый путь или имя файла.
| String |
build_pyramids (Дополнительный) | Построить пирамидные слои для каждого исходного растра.
| Boolean |
calculate_statistics (Дополнительный) | Задает вычисление статистики для каждого растра-источника.
| Boolean |
build_thumbnails (Дополнительный) | Задает построение обзорных изображений для каждого растра-источника.
| Boolean |
operation_description (Дополнительный) | Описание, характеризующее данную операцию добавления растровых данных. Оно будет добавлено в таблицу типов растра, и в дальнейшем сможет участвовать в поиске или служить справочной информацией. | String |
force_spatial_reference (Дополнительный) | Задает систему координат. Использует систему координат, указанную в параметре spatial_reference для всех растров при загрузке данных в набор данных мозаики.
| Boolean |
estimate_statistics (Дополнительный) | Задает вычисление статистики набора данных мозаики для более быстрого рендеринга и обработки на уровне набора данных мозаики.
| Boolean |
aux_inputs [aux_inputs,...] (Дополнительный) | Настройки типа растра, заданные на странице Свойства типа растра. Эти настройки параметра замещают настройки, заданные на странице Свойства типа растра. | Value Table |
enable_pixel_cache (Дополнительный) | Задает построение кэша пикселов для ускорения отображения и обработки набора данных мозаики.
| Boolean |
cache_location (Дополнительный) | Местоположение кэша пикселов. Если местоположение не указано, кэш записывается в C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\. Если местоположение указано, не нужно снова задавать путь при добавлении новых растров в набор данных мозаики. Вам необходимо только отметить параметр Включить кэш пикселов при добавлении новых данных. | String |
Производные выходные данные
Имя | Объяснение | Тип данных |
out_mosaic_dataset | Обновленный набор данных мозаики. | Слой мозаики |
Пример кода
AddRastersToMosaicDataset, пример 1 (окно Python)
Пример скрипта Python для инструмента AddRastersToMosaicDataset.
import arcpy
arcpy.AddRastersToMosaicDataset_management(
"c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+",
"c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
"UPDATE_OVERVIEWS", "2", "#", "#", "GCS_WGS_1984.prj",
"*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
"NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",
"Add Landsat L1G", "FORCE_SPATIAL_REFERENCE",
"NO_STATISTICS", "", "USE_PIXEL_CACHE",
r"C:\test\cachelocation")
AddRastersToMosaicDataset, пример 2 (автономный скрипт)
Это пример скрипта Python для инструмента AddRastersToMosaicDataset.
#Add Raster Dataset type Raster to FGDB Mosaic Dataset
#Calculate Cell Size Ranges and Build Boundary
#Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
#Apply TIFF file filter
#Build Pyramids for the source datasets
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "AddMD.gdb/md_rasds"
rastype = "Raster Dataset"
inpath = "c:/data/rasds"
updatecs = "UPDATE_CELL_SIZES"
updatebnd = "UPDATE_BOUNDARY"
updateovr = "UPDATE_OVERVIEWS"
maxlevel = "2"
maxcs = "#"
maxdim = "#"
spatialref = "#"
inputdatafilter = "*.tif"
subfolder = "NO_SUBFOLDERS"
duplicate = "EXCLUDE_DUPLICATES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildthumb = "NO_THUMBNAILS"
comments = "Add Raster Datasets"
forcesr = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
Параметры среды
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да