Добавить изображения в набор данных ориентированных изображений (Oriented Imagery)

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

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

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

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

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

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

    • Формат изображения - TIF или MRF.
    • Метаданные изображения хранятся отдельно от файлов изображений или их необходимо будет отредактировать перед добавлением.
    • Вы включаете ориентацию камеры, позволяющую выполнять более точные преобразования из системы координат изображения в систему координат земной поверхности и обратно.

  • Если данные добавляются непосредственно из файлов изображений, папки с изображениями или текстового файла со списком путей к изображениям, информация метаданных извлекается из данных EXIF и XMP изображений. Данные EXIF должны, как минимум, содержать информацию о географическом местоположении.

Параметры

ПодписьОписаниеТип данных
Набор данных ориентированных изображений

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

Oriented Imagery Layer
Категория изображения

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

  • Horizontal - будут использоваться изображения, экспозиция которых параллельна земле и обращена на горизонт.
  • Oblique - будут использоваться изображения, экспозиция которых расположена под углом к земле, обычно около 45 градусов, поэтому можно увидеть боковые стороны объектов.
  • Nadir - будут использоваться изображения, экспозиция которых перпендикулярна земле и смотрит вертикально вниз. Вы увидите только верх объектов.
  • 360 - будут использоваться изображения, полученные камерами, которые обеспечивают сферический объемный обзор на 360 градусов или были сшиты в 360-градусные изображения, полученные специальными камерами.
  • Inspection - будут использоваться изображения объектов крупным планом (находящиеся менее чем в 5 метрах от камеры).
String
Входные данные

Путь и имя входных данных. Поддерживаются следующие:

Folder; Oriented Imagery Layer; Table; Raster Layer; File
Включить вложенные папки
(Дополнительный)

Задает рекурсивный поиск данных во вложенных папках.

  • Отмечено – данные будут рекурсивно извлекаться из всех вложенных папок. Это значение по умолчанию
  • Не отмечено – источником данных будет служить только папка первого верхнего уровня.
Boolean
Фильтр входной папки
(Дополнительный)

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

Например, чтобы добавить только изображения, содержащие определенную строку, добавьте знаки процента до и после этой строки (%value%).

String
Фильтр входной таблицы
(Дополнительный)

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

SQL Expression
Включить все поля из входной таблицы
(Дополнительный)

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

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

Отмечено — все поля входной таблицы будут добавлены в таблицу атрибутов набора данных.

Boolean

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

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

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

Oriented Imagery Layer

arcpy.management.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})
ИмяОписаниеТип данных
in_oriented_imagery_dataset

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

Oriented Imagery Layer
imagery_category

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

  • Horizontal - будут использоваться изображения, экспозиция которых параллельна земле и обращена на горизонт.
  • Oblique - будут использоваться изображения, экспозиция которых расположена под углом к земле, обычно около 45 градусов, поэтому можно увидеть боковые стороны объектов.
  • Nadir - будут использоваться изображения, экспозиция которых перпендикулярна земле и смотрит вертикально вниз. Вы увидите только верх объектов.
  • 360 - будут использоваться изображения, полученные камерами, которые обеспечивают сферический объемный обзор на 360 градусов или были сшиты в 360-градусные изображения, полученные специальными камерами.
  • Inspection - будут использоваться изображения объектов крупным планом (находящиеся менее чем в 5 метрах от камеры).
String
input_data
[input_data,...]

Путь и имя входных данных. Поддерживаются следующие:

Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders
(Дополнительный)

Задает рекурсивный поиск данных во вложенных папках.

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

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

Например, чтобы добавить только изображения, содержащие определенную строку, добавьте знаки процента до и после этой строки (%value%).

String
where_clause
(Дополнительный)

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

SQL Expression
include_all_fields
(Дополнительный)

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

  • NO_INCLUDE_ALL_FIELDSВ таблицу атрибутов набора данных будут добавлены только поля, специфичные для схемы ориентированных изображений. Это значение по умолчанию
  • INCLUDE_ALL_FIELDSВсе поля входной таблицы будут добавлены в таблицу атрибутов набора данных.
Boolean

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

ИмяОписаниеТип данных
out_oriented_imagery_dataset

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

Oriented Imagery Layer

Пример кода

AddImagesToOrientedImageryDataset, пример 1 (окно Python)

Пример скрипта окна Python для использования функции AddImagesToOrientedImageryDataset в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data='C:/OrientedImageryExample/Samples/img1.jpg;C:/OrientedImageryExample/Samples/img2.jpg')