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

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

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

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

• Добавляемые растровые данные не являются управляемыми; поэтому удаление или перемещение растровых данных будет влиять на набор данных мозаики.

• Вы можете добавлять растры только в набор данных мозаики, находящийся в базе геоданных. Наборы данных мозаики, которые созданы вне базы геоданных, могут содержать только данные ранее созданного набора данных мозаики.

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

  Более подробно о Растровых типах

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

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

• Для более быстрого отображения и обработки, можно сгенерировать кэш пикселов набора данных мозаики, если выбрать опцию Включить кэш пикселов.

Параметры

Диалог

Подпись	Описание	Тип данных
Набор данных мозаики	Путь или имя набора данных мозаики, в который будут добавляться растровые данные.	Mosaic Layer
Растровый тип	Тип добавляемого растра. Растровый тип является специфичным для продуктов изображений. Он идентифицирует метаданные, например, пространственную привязку, дату получения и тип сенсора, а также формат растра. Если вы используете растровый тип LAS, набор данных LAS или Terrain, на странице свойств Растрового типа должен быть указан размер ячейки. В ниспадающем списке Шаблоны обработки содержатся функции, которые будут применяться к элементам, добавляемым к набору данных мозаики, а также порядок их применения. Это может быть одна функция, например, Растяжка, или это может быть последовательность функций для создания более сложного продукта. Большинство растровых типов содержит несколько готовых функций, связанных с ними. Используйте этот ниспадающий список для редактирования имеющихся функций или добавления новых функций к элементам, добавляемым к набору данных мозаики. Для редактирования шаблона выберите его в ниспадающем списке Шаблоны обработки и щелкните Редактировать . Когда вы закончите редактировать шаблон, щелкните Сохранить , чтобы обновить шаблон, или щелкните Сохранить как , чтобы сохранить его в ниспадающем списке как новый элемент. Чтобы экспортировать шаблон на диск для использования с другими наборами данных мозаики, щелкните кнопку Экспорт . Чтобы создать шаблон, щелкните Создать новый шаблон в ниспадающем списке Шаблоны обработки. Более подробно см. в разделе Шаблоны растровых функций. Чтобы импортировать последовательность функций с диска или с панели Функции растра, щелкните Импорт в ниспадающем списке Шаблоны обработки. Если шаблон был создан независимо от редактора шаблонов типов растров, необходимо изменить имя переменной первичного входного растра на Dataset. Для этого дважды щелкните первую функцию в последовательности и щелкните вкладку Переменные. Измените значение в поле Name параметра растра на Dataset.	Raster Type
Входные данные	Задает путь и имя входных файла, папки, набора растровых данных, набора данных мозаики, таблицы или сервиса. Не все входные опции будут доступны. Выбранный тип растра определяет доступные опции. Набор данных—В качестве входных данных будет использоваться набор географических данных ArcGIS, например растр или набор данных мозаики в базе геоданных или в таблице. Рабочая область—В качестве входных данных будет использоваться папка с несколькими наборами растровых данных. Она также может содержать вложенные папки.На эту опцию влияют параметры Включить вложенные папки и Фильтр входных данных. Файл—В качестве входных данных будут использоваться один или несколько наборов растровых данных, хранящихся в папке на диске, файл определения сервиса изображений (.ISDef) и файл определения обработки растра (.RPDef).Список файлов будет игнорировать файлы, которые не соответствуют добавляемому растровому типу.Не используйте эту опцию с форматами файлов, которые являются наборами растровых данных, например, с файлами TIFF или MrSID – вместо этого используйте тип входных данных Набор данных. Сервис—В качестве входных данных будет использоваться сервис WCS, картографический сервис или сервис изображений, либо файл слоя веб-сервиса.	File; Image Service; LAS Dataset Layer; Layer File; Map Server; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace
Обновить диапазоны размеров ячеек (Дополнительный)	Задает возможность вычисления диапазонов размеров ячеек каждого растра в наборе данных мозаики. Эти значения записываются в таблицу атрибутов в полях minPS и maxPS. Отмечено – диапазоны размера ячейки будут вычисляться для всех растров набора данных мозаики. Это значение по умолчанию Не отмечено – диапазоны размера ячейки не будут вычисляться.	Boolean
Обновить границы (Дополнительный)	Задает, будет ли сгенерирован или обновлен полигон границ набора данных мозаики. По умолчанию объединяются все полигоны контуров для создания единой границы, представляющей экстент значащих пикселов. Отмечено – граница будет построена или обновлена. Это значение по умолчанию Не отмечено – граница не будет построена или обновлена.	Boolean
Обновить обзорные изображения (Дополнительный)	Задает, будет ли задаваться и генерироваться обзорные изображения набора данных мозаики. Отмечено – будут определены или созданы обзорные изображения. Не отмечено – обзорные изображения не будут определены или созданы. Это значение по умолчанию	Boolean
Максимальные уровни (Дополнительный)	Максимальное количество уровней пирамидных слоев, которые будут использоваться в наборе данных мозаики. Например, при значении 2 будут использоваться только первые два пирамидных слоя из исходного растра. Если вы оставите этот параметр незаполненным или введете значение -1, пирамидные слои будут построены для всех уровней. Значение может влиять на отображение и количество создаваемых общих видов.	Long
Максимальный размер ячейки (Дополнительный)	Максимальный размер ячейки пирамидного слоя, который будет использоваться в наборе данных мозаики.	Double
Минимум строк или столбцов (Дополнительный)	Минимальные измерения пирамидного слоя растра, который будет использоваться в наборе данных мозаики.	Long
Система координат входных данных (Дополнительный)	Система пространственной привязки входных данных. Должна быть задана, если данные не имеют системы координат; в противном случае будет использоваться система координат набора данных мозаики. Также может использоваться для перезаписи системы координат входных данных.	Spatial Reference
Добавляемые растровые данные не являются управляемыми; поэтому удаление или перемещение растровых данных будет влиять на набор данных мозаики. (Дополнительный)	Фильтр данных, добавляемых в набор данных мозаики. Для создания фильтра данных могут использоваться выражения 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
Включить вложенные папки (Дополнительный)	Задает рекурсивный поиск данных во вложенных папках. Отмечено – данные будут извлекаться из всех вложенных папок. Это значение по умолчанию Не отмечено – источником данных будет служить только папка первого верхнего уровня.	Boolean
Добавлять только новые наборы данных (Дополнительный)	Задает способ обработки дублирующихся растров. Будет выполнена проверка исходного пути и имени файлов, которая позволит увидеть, были ли растры уже добавлены. Выберите, какое действие выполнять, если найден одинаковый путь или имя файла. Разрешить дубликаты—Будут добавлены все растры, даже те, которые уже существуют в наборе данных мозаики. Это значение по умолчанию Исключить дубликаты—Повторяющиеся растры не будут добавлены. Перезаписать дубликаты—Дублирующий растр перезапишет существующий растр.	String
Построить пирамидные слои растра (Дополнительный)	Задает построение пирамидных слоев для каждого растра-источника. Не отмечено – пирамидные слои не будут построены. Это значение по умолчанию Отмечено – пирамидные слои будут построены.	Boolean
Вычислить статистику (Дополнительный)	Задает вычисление статистики для каждого растра-источника. Не отмечено – статистика не рассчитывается. Это значение по умолчанию Отмечено – статистика будет рассчитана.	Boolean
Построить образцы (Дополнительный)	Задает, будут ли построены образцы для каждого исходного растра. Не отмечено – образцы не будут построены. Это значение по умолчанию Отмечено – образцы будут построены.	Boolean
Описание операции (Дополнительный)	Описание, характеризующее данную операцию добавления растровых данных. Оно будет добавлено в таблицу растровых типов и в дальнейшем сможет участвовать в поиске или служить справочной информацией.	String
Применить эту систему координат для входных данных (Дополнительный)	Определяет, будет ли использоваться значение параметра Система координат для входных данных для всех растров при загрузке данных в набор данных мозаики. Эта опция не перепроецирует данные; для построения элементов в наборе данных мозаики она использует систему координат, указанную в инструменте. Будет использован экстент изображения, но проекция будет перезаписана. Не отмечено – при загрузке данных будут сохранены системы координат каждого растра. Это значение по умолчанию Если не отмечено, и у входного изображения отсутствует система координат (т.е. она неизвестна), при создании элементов набора данных мозаики будет использована система координат мозаики. Если у изображения есть система координат, будет использоваться именно она. Отмечено – система координат в параметре Система координат для входных данных будет использоваться для каждого из наборов растровых данных при загрузке данных.	Boolean
Оценить статистику набора данных мозаики (Дополнительный)	Задает вычисление статистики набора данных мозаики для более быстрого рендеринга и обработки на уровне набора данных мозаики. Не отмечено – статистика не рассчитывается. Статистика, полученная из каждого элемента набора данных мозаики, будет использоваться для отображения и обработки. Это значение по умолчанию Отмечено – для набора данных мозаики будет рассчитана статистика. Это приведет к использованию распределения пикселов, использующихся для отображения набора данных мозаики, вместо распределения исходного элемента в наборе данных мозаики.	Boolean
Вспомогательные входные данные (Дополнительный)	Настройки типа растра, заданные на странице Свойства типа растра. Эти настройки параметра замещают настройки, заданные на странице Свойства типа растра.	Value Table
Включить кэш пикселов (Дополнительный)	Задает построение кэша пикселов для ускорения отображения и обработки набора данных мозаики. Не отмечено – кэш пикселов не будет создаваться. Это значение по умолчанию Отмечено – кэш пикселов будет создаваться.	Boolean
Местоположение кэша пикселов (Дополнительный)	Местоположение кэша пикселов. Если местоположение не указано, кэш записывается в C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\. Если местоположение указано, не нужно снова задавать путь при добавлении новых растров в набор данных мозаики. Вам необходимо только отметить параметр Включить кэш пикселов (enable_pixel_cache = "USE_PIXEL_CACHE" в Python) при добавлении новых данных.	Folder; String

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

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

Python

arcpy.management.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,...]	Задает путь и имя входных файла, папки, набора растровых данных, набора данных мозаики, таблицы или сервиса. Не все входные опции будут доступны. Выбранный тип растра определяет доступные опции. Dataset—В качестве входных данных будет использоваться набор географических данных ArcGIS, например растр или набор данных мозаики в базе геоданных или в таблице. Folder—В качестве входных данных будет использоваться папка с несколькими наборами растровых данных. Она также может содержать вложенные папки.На эту опцию влияют параметры Включить вложенные папки и Фильтр входных данных. File—В качестве входных данных будут использоваться один или несколько наборов растровых данных, хранящихся в папке на диске, файл определения сервиса изображений (.ISDef) и файл определения обработки растра (.RPDef).Список файлов будет игнорировать файлы, которые не соответствуют добавляемому растровому типу.Не используйте эту опцию с форматами файлов, которые являются наборами растровых данных, например, с файлами TIFF или MrSID – вместо этого используйте тип входных данных Набор данных. Service—В качестве входных данных будет использоваться сервис WCS, картографический сервис или сервис изображений, либо файл слоя веб-сервиса.	File; Image Service; LAS Dataset Layer; Layer File; Map Server; Mosaic 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 (Дополнительный)	Задает систему координат. Использовать систему координат, указанную в параметре spatial_reference для всех растров при загрузке данных в набор данных мозаики. NO_FORCE_SPATIAL_REFERENCE—При загрузке данных будут сохранены системы координат каждого растра. Это значение по умолчанию FORCE_SPATIAL_REFERENCE—Система координат, указанная в параметре spatial_reference, будет использоваться для каждого растра при загрузке данных.	Boolean
estimate_statistics (Дополнительный)	Задает вычисление статистики набора данных мозаики для более быстрого рендеринга и обработки на уровне набора данных мозаики. NO_STATISTICS—Статистика не рассчитывается. Применяется статистика, созданная для каждого элемента набора данных мозаики с целью отображения и обработки. Это значение по умолчанию ESTIMATE_STATISTICS—Для набора данных мозаики будет рассчитана статистика. Это приведет к использованию распределения пикселов, использующихся для отображения набора данных мозаики, вместо распределения исходного элемента в наборе данных мозаики.	Boolean
aux_inputs [aux_inputs,...] (Дополнительный)	Настройки типа растра, заданные на странице Свойства типа растра. Эти настройки параметра замещают настройки, заданные на странице Свойства типа растра.	Value Table
enable_pixel_cache (Дополнительный)	Задает построение кэша пикселов для ускорения отображения и обработки набора данных мозаики. NO_PIXEL_CACHE—Кэш пикселов не будет создаваться. Это значение по умолчанию USE_PIXEL_CACHE—Кэш пикселов будет создаваться.	Boolean
cache_location (Дополнительный)	Местоположение кэша пикселов. Если местоположение не указано, кэш записывается в C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\. Если местоположение указано, не нужно снова задавать путь при добавлении новых растров в набор данных мозаики. Вам необходимо только отметить параметр Включить кэш пикселов (enable_pixel_cache = "USE_PIXEL_CACHE" в Python) при добавлении новых данных.	Folder; String

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

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

Пример кода

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 = "#"
estimatestats = "ESTIMATE_STATISTICS"
auxilaryinput = ""
enablepixcache = "USE_PIXEL_CACHE"
cachelocation = "c:\\test\\cachelocation"

arcpy.AddRastersToMosaicDataset_management(
     mdname,  rastype, inpath, updatecs, updatebnd, updateovr,
     maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
     subfolder, duplicate, buildpy, calcstats, 
     buildthumb, comments, forcesr, estimatestats,
     auxilaryinput, enablepixcache, cachelocation)

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

Текущая рабочая область, Экстент, Географические преобразования, Коэффициент параллельной обработки, Пирамидные слои, Статистика растра, Временная рабочая область

Особые случаи

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

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