Добавить растры в набор данных мозаики (Управление данными (Data Management))

Уровень лицензии:BasicStandardAdvanced

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

Добавляет в набор данных мозаики наборы растровых данных из многих источников, включая файлы, папки, каталоги растров, таблицы и веб-сервисы.

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

Синтаксис

AddRastersToMosaicDataset_management (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})
ПараметрОбъяснениеТип данных
in_mosaic_dataset

Путь или имя набора данных мозаики, к которому будут добавляться растровые данные.

Image Service; Mosaic Layer; String
raster_type

Тип растра – это особенность продукта спутниковых снимков. Он идентифицирует метаданные, например, пространственную привязку, дату приобретения и тип сенсора, а также формат растра. Список типов растров можно найти в разделе Перечень поддерживаемых форматов изображений и растровых данных.

При использовании типов растров LAS, Набор данных LAS или Terrain, необходимо использовать файл *.ART, где указан размер ячейки.

Raster Type
input_path
[input_path,...]

Путь и имя файла, папки, набора растровых данных, каталога растров, набора данных мозаики, таблицы или сервиса.

Не все варианты ввода будут доступны. Доступные варианты зависят от выбранного типа растра.

  • Набор данныхПозволяет выбирать набор географических данных ArcGIS, например растр, каталог растров или набор данных мозаики в базе геоданных или в таблице.
  • Рабочая областьПозволяет выбирать папку, содержащую несколько наборов растровых данных. Она также может иметь вложенные папки.К папкам применимы параметры Включить вложенные папки (Include Sub Folders) и Фильтр входных данных (Input Data Filter).
  • ФайлыПозволяет выбирать один или несколько наборов растровых данных, хранящихся в папке на диске, а также файл определения сервиса изображений (.ISDef) и файл определения обработки растра (.RPDef). Также обработчик списка файлов будет игнорировать все файлы, которые не соответствуют добавляемому типу растров. Не предназначен для использования с форматами файлов, которые являются наборами растровых данных, например, с файлами TIFF или MrSID – используйте параметр Набор данных (Dataset).
  • СервисПозволяет выбирать сервис WCS, картографический сервис или сервис изображений, либо файл слоя веб-сервиса.
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.

  • UPDATE_CELL_SIZESДиапазоны размера ячейки будут вычисляться для всех растров набора данных мозаики. Это значение используется по умолчанию.
  • NO_CELL_SIZESДиапазоны размера ячейки не будут вычисляться.
Boolean
update_boundary
(дополнительно)

Создает и обновляет ограничивающий полигон набора данных мозаики. По умолчанию, объединяются все полигоны контуров для создания единой границы, представляющей экстент значащих пикселов.

  • UPDATE_BOUNDARYГраница будет построена или обновлена. Это значение используется по умолчанию.
  • NO_BOUNDARYГраница не будет построена или обновлена.
Boolean
update_overviews
(дополнительно)

Определяет и строит обзорные изображения для набора данных мозаики.

  • UPDATE_OVERVIEWSБудут определены или созданы обзорные изображения.
  • NO_OVERVIEWSНе произойдет ни определения, ни создания обзорных изображений. Это значение используется по умолчанию.
Boolean
maximum_pyramid_levels
(дополнительно)

Определяет максимальное количество уровней пирамидных слоев, которые будут использоваться в наборе данных мозаики. Например, при значении 2 будут использоваться только первые два пирамидных слоя из исходного растра. Если вы оставите этот параметр незаполненным или введете значение -1, пирамидные слои будут построены для всех уровней.

Значение может влиять на отображение и количество создаваемых общих видов.

Long
maximum_cell_size
(дополнительно)

Определяет максимальный размер ячейки пирамидного слоя, который будет использоваться в наборе данных мозаики.

Double
minimum_dimension
(дополнительно)

Определяет минимальные измерения пирамидного слоя растра, который будет использоваться в наборе данных мозаики.

Long
spatial_reference
(дополнительно)

Система пространственной привязки входных данных.

Должна быть задана, если данные не имеют системы координат; в противном случае, будет использоваться система координат набора данных мозаики. Также может использоваться для перезаписи системы координат входных данных.

Spatial Reference
filter
(дополнительно)

Фильтр данных, добавляемых в набор данных мозаики. Для создания фильтра данных могут использоваться выражения SQL. Символ звездочки или другие подобные символы в составе фильтра могут приниматься за полный путь к входным данным.

Следующее SQL выражение выбирает строки с соответствующими ID объектов.

  • OBJECTID IN (19745, 19680, 19681, 19744, 5932, 5931, 5889, 5890, 14551, 14552, 14590, 14591)

Если необходимо добавить только изображение в формате TIFF, добавьте символ звездочки перед расширением файла.

  • *.TIF

Если необходимо добавить все изображения со словом "sensor" в составе пути файла или имени файла, поставьте символ звездочки как перед этим словом, так и после него.

  • *sensor2009*

Также для создания фильтра данных может использоваться синтаксис PERL.

  • REGEX: .*1923.*|.*1922.*

  • REGEX: .*192[34567].*|.*194.*|.*195.*

Следующий синтаксис PERL с множественной языковой группировкой в качестве части выражения не поддерживается.

  • REGEX: .* map_mean_.*(?:(?:[a-z0-9]*)_pptPct_(?:[0-9]|1[0-2]*?)_2[0-9]_*\w*).img

Или можно использовать следующий синтаксис.

  • REGEX: .*map_mean_*[a-z0-9]*_pptPct_([0-9]|1[0-2])_2[0-9]*_\w*.img

String
sub_folder
(дополнительно)

Рекурсивно исследует подпапки.

  • SUBFOLDERS (Вложенные папки)Данные будут извлекаться из всех вложенных папок. Это значение используется по умолчанию.
  • NO_SUBFOLDERS (Без вложенных папок)Источником данных будет служить только папка первого верхнего уровня.
Boolean
duplicate_items_action
(дополнительно)

Проверка будет выполнена, чтобы увидеть, были ли растры уже добавлены, с помощью исходного пути и имени файла. Выберите, какое действие выполнять, если найден одинаковый путь или имя файла.

  • ALLOW_DUPLICATES (Разрешить дубликаты)Будут добавлены все растры, даже те, которые уже существуют в наборе данных мозаики. Это значение используется по умолчанию.
  • EXCLUDE_DUPLICATES (Исключить дубликаты)Повторяющиеся растры не будут добавлены.
  • OVERWRITE_DUPLICATES (Перезапись дубликатов)При добавлении повторяющихся растров существующие копии будут обновлены.
String
build_pyramids
(дополнительно)

Построить пирамидные слои для каждого исходного растра.

  • NO_PYRAMIDSПирамидные слои не будут созданы. Это значение используется по умолчанию.
  • BUILD_PYRAMIDSПирамидные слои будут созданы.
Boolean
calculate_statistics
(дополнительно)

Вычисляет статистику для каждого исходного растра.

  • NO_STATISTICSСтатистика не будет рассчитана. Это значение используется по умолчанию.
  • CALCULATE_STATISTICSБудет произведен расчет статистики.
Boolean
build_thumbnails
(дополнительно)

Строит образцы для каждого исходного растра.

  • NO_THUMBNAILSОбразцы не будут созданы. Это значение используется по умолчанию.
  • BUILD_THUMBNAILSОбразцы будут созданы.
Boolean
operation_description
(дополнительно)

Описание, характеризующее данную операцию добавления растровых данных. Оно будет добавлено в таблицу типов растра, и в дальнейшем сможет участвовать в поиске или служить справочной информацией.

String
force_spatial_reference
(дополнительно)

При загрузке данных в набор данных мозаики все растры преобразуются в указанную систему координат.

  • NO_FORCE_SPATIAL_REFERENCE (Без принудительной пространственной привязки)При загрузке данных будут сохранены системы координат каждого растра. Это значение используется по умолчанию.
  • FORCE_SPATIAL_REFERENCE (Принудительная пространственная привязка)При загрузке каждый набор растровых данных будет принудительно преобразован в систему координат, указанную в этом инструменте.
Boolean

Пример кода

Добавить растры в набор данных мозаики. Пример 1 (окно Python)

Это пример Python для инструмента Добавить растры в набор данных мозаики.

import arcpy
arcpy.AddRastersToMosaicDataset_management(
     "c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+", 
     "c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
     "NO_OVERVIEWS", "UPDATE_OVERVIEWS", "2", "#", "#", 
     "GCS_WGS_1984.prj","*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
     "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS", 
     "Add Landsat L1G", "FORCE_SPATIAL_REFERENCE")
Добавить растры в набор данных мозаики. Пример 2 (автономный скрипт)

Это пример скрипта Python для инструмента Добавить растры в набор данных мозаики.

#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)

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

Связанные темы

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

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
5/10/2014