Добавить изображения в набор данных ориентированных изображений (Инструменты ориентированных изображений)

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

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

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

Добавляемые изображения не управляются набором данных ориентированных изображений. Набор данных указывает на место хранения изображений. Если изображение удаляется или перемещается, оно не будет загружено во вьюер ориентированных изображений.
На основании значения параметра Входные данные инструмент определяет метаданные, необходимые для загрузки данных в набор данных ориентированных изображений. Функционал ориентированных изображений зависит от информации в метаданных.
Все опции входных данных поддерживают формат JPEG. В следующих случаях изображения должны быть добавлены с использованием файла .csv, соответствующего схеме таблицы ориентированных изображений, векторного слоя, соответствующего схеме таблицы атрибутов ориентированных изображений, или слоя ориентированных изображений:
- Формат изображения - GeoTIF или MRF.
- Метаданные изображения хранятся отдельно от файлов изображений или их необходимо будет отредактировать перед добавлением.
- Вы включаете ориентацию камеры, позволяющую выполнять более точные преобразования изображение-земля и земля-изображение.
Если данные добавляются непосредственно из файлов изображений, папки с изображениями или текстового файла со списком путей к изображениям, информация метаданных извлекается из данных EXIF и XMP изображений. Данные EXIF должны, как минимум, содержать информацию о географическом местоположении.

Подпись	Объяснение	Тип данных
Набор данных ориентированных изображений	Путь к набору данных ориентированных изображений, в который будут добавлены изображения, и его название.	Oriented Imagery Layer
Категория изображения	Указывает тип входных изображений, которые будут использоваться, и задает свойства набора данных ориентированных изображений по умолчанию. Свойство по умолчанию будет использоваться, если соответствующий атрибут не будет найден в таблице атрибутов набора ориентированных изображений. `Horizontal`—Будут использоваться изображения, экспозиция которых параллельна земле и обращена на горизонт. `Oblique`—Будут использоваться изображения с экспозицией под углом к земле, обычно около 45 градусов, поэтому можно увидеть боковые стороны объектов `Nadir`—Будут использоваться изображения, экспозиция которых перпендикулярна земле и смотрит вертикально вниз. Видна только верхняя часть объектов. `360`—Будут использоваться изображения, сделанные специализированными камерами, которые обеспечивают сферический объемный обзор на 360 градусов, или объединенные в виде 360-градусных обзоров с нескольких камер. `Inspection`—Будут использоваться изображения объектов крупным планом (находящиеся менее чем в 5 метрах от камеры). `AeriaFrameVideo`—Видео, снятое с БПЛА или самолета камерой, направленной вниз, к земле. `TerrestrialFrameVideo`—Видео, снятое с помощью портативных устройств, таких как камеры на приборной панели. `Terrestrial360Video`—360-градусное видео, снятое с помощью таких устройств, как GoPro или Insta360.	String
Входные данные	Путь и имя входных данных. Поддерживаются следующие: Одно или несколько изображений в формате JPEG. Папка, содержащая изображения. В набор данных из папки будут добавлены только изображения JPEG. Файл `.txt`, содержащий пути к изображениям JPEG. Каждый путь к изображению должен быть в отдельной строчке. Файл `.csv`, использующий схему таблицы ориентированных изображений. Векторный слой, использующий схему таблицы атрибутов ориентированных изображений. Слой ориентированных изображений. Файл `.csv`, использующий схему таблицы FrameCamera. Набор данных мозаики, созданный с помощью растровых типов аэрофотоснимков.	Folder; Oriented Imagery Layer; Table; Raster Layer; File
Включить вложенные папки (Дополнительный)	Задает рекурсивный поиск данных во вложенных папках. Отмечено–Данные будут рекурсивно извлекаться из всех вложенных папок. Используется по умолчанию. Не отмечено–Источником данных будет служить только папка первого верхнего уровня.	Boolean
Фильтр входной папки (Дополнительный)	Выражение, которое будет использоваться для фильтрации и добавления изображений во входную папку. Например, чтобы добавить только изображения, содержащие определенную строку, добавьте знаки процента до и после значения строки (`%value%`).	String
Фильтр входной таблицы (Дополнительный)	SQL-выражение, которое будет использоваться для выбора поднабора записей. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.	SQL Expression
Включить все поля из входной таблицы (Дополнительный)	Определяет, будут ли все поля из входной таблицы, кроме требуемой схемы, добавлены в таблицу атрибутов набора данных. Отмечено–Все поля входной таблицы будут добавлены в таблицу атрибутов набора данных. Не отмечено–В таблицу атрибутов набора данных будут добавлены только поля, специфичные для схемы ориентированных изображений. Используется по умолчанию.	Boolean
Входной файл видео (Дополнительный)	Видеофайл, хранящийся в общедоступном облачном хранилище. Видеофайл должен быть совместим со стандартными веб-браузерами. Дополнительные сведения о поддерживаемых типах видео (форматах и кодеках) см. в разделе Часто используемые кодеки. Для входных данных `TerrestrialFrameVideo` и `Terrestrial360Video` инструмент автоматически извлекает поле местоположения сенсора и временной метки, если видео содержит допустимые метаданные KLV.	File
Файл метаданных (Дополнительный)	Файл `.csv`, содержащий метаданные видео. Для `AerialFrameVideo` к каждому видео кадра аэросъемки должен прилагаться локальный файл `.csv`, содержащий следующие поля для каждого кадра: Точная временная отметка, Широта сенсора, Долгота сенсора, Высота на эллипсоиде или истинная высота сенсора, Курсовой угол платформы, Угол тангажа платформы, Угол крена платформы, Угол относительного тангажа сенсора, Угол относительной высоты сенсора, Угол относительного азимута сенсора, Горизонтальное поле зрения сенсора и Вертикальное поле зрения сенсора. Все поля обязательны для заполнения и должны содержать допустимые значения. Для `TerrestrialFrameVideo` и `Terrestrial360Video`, файл `.csv` является необязательным. Если включен, файл должен быть локальным и содержать как минимум следующие поля: X,Y и AcquisitionDate (в формате гггг-мм-дд ЧЧ:ММ:СС).	File
Минимальный интервал между кадрами (Дополнительный)	Минимальный интервал времени, требуемый между последовательными видеокадрами. В набор данных ориентированных изображений будут добавлены только те кадры, которые разделены как минимум этим интервалом времени. Значение по умолчанию равно 1 секунде.	Time Unit
Минимальное изменение положения сенсора (Дополнительный)	Минимальное расстояние в метрах, на которое сенсор должен перемещаться между кадрами. В набор данных ориентированных изображений будут включены только те кадры, e которых положение сенсора изменилось как минимум на это значение.	Double
Минимальное перекрытие кадров (Дополнительный)	Минимальное процентное перекрытие, требуемое между последовательными кадрами. В набор данных ориентированных изображений будут включены только кадры с перекрытием, превышающим это значение. По умолчанию значение равно 0. Для корректного применения этого параметра необходимо указать допустимое значение для CameraHeading.	Double
Расстояние для вычисления перекрытия (Дополнительный)	Расстояние в метрах, используемое для вычисления контура изображения (усеченной пирамиды) для расчета перекрытия. Если не указано, значение по умолчанию равно `FarDistance` / 2. Подробную информацию о `FarDistance` см. в разделе Поля таблицы ориентированных изображений.	Double
Вычислить курс (Дополнительный)	Определяет, будет ли инструмент создавать значения CameraHeading. Примечание: При отсутствии значений `CameraHeading` вычисление контура завершится ошибкой. Отмечено–Инструмент создаст значения `CameraHeading`. Эти вычисленные значения имеют приоритет, даже если видео уже содержит значения для `CameraHeading`. Не отмечено–Инструмент не создаст значения `CameraHeading`.	Boolean
Смещение курса (Дополнительный)	Смещение, применяемое к `CameraHeading`, чтобы учитывать положение установки камеры. Оно применяется, когда камера не направлена вперед, например, когда она установлена сбоку транспортного средства. По умолчанию значение равно 0.	Double

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

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

arcpy.oi.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields}, {input_video_file}, {metadata_file}, {minimum_frame_interval}, {minimum_sensor_position_change}, {minimum_frame_overlap}, {distance_to_compute_overlap}, {compute_heading}, {heading_offset})

Имя	Объяснение	Тип данных
in_oriented_imagery_dataset	Путь к набору данных ориентированных изображений, в который будут добавлены изображения, и его название.	Oriented Imagery Layer
imagery_category	Указывает тип входных изображений, которые будут использоваться, и задает свойства набора данных ориентированных изображений по умолчанию. Свойство по умолчанию будет использоваться, если соответствующий атрибут не будет найден в таблице атрибутов набора ориентированных изображений. `Horizontal`—Будут использоваться изображения, экспозиция которых параллельна земле и обращена на горизонт. `Oblique`—Будут использоваться изображения с экспозицией под углом к земле, обычно около 45 градусов, поэтому можно увидеть боковые стороны объектов `Nadir`—Будут использоваться изображения, экспозиция которых перпендикулярна земле и смотрит вертикально вниз. Видна только верхняя часть объектов. `360`—Будут использоваться изображения, сделанные специализированными камерами, которые обеспечивают сферический объемный обзор на 360 градусов, или объединенные в виде 360-градусных обзоров с нескольких камер. `Inspection`—Будут использоваться изображения объектов крупным планом (находящиеся менее чем в 5 метрах от камеры). `AeriaFrameVideo`—Видео, снятое с БПЛА или самолета камерой, направленной вниз, к земле. `TerrestrialFrameVideo`—Видео, снятое с помощью портативных устройств, таких как камеры на приборной панели. `Terrestrial360Video`—360-градусное видео, снятое с помощью таких устройств, как GoPro или Insta360.	String
input_data [input_data,...]	Путь и имя входных данных. Поддерживаются следующие: Одно или несколько изображений в формате JPEG. Папка, содержащая изображения. В набор данных из папки будут добавлены только изображения JPEG. Файл `.txt`, содержащий пути к изображениям JPEG. Каждый путь к изображению должен быть в отдельной строчке. Файл `.csv`, использующий схему таблицы ориентированных изображений. Векторный слой, использующий схему таблицы атрибутов ориентированных изображений. Слой ориентированных изображений. Файл `.csv`, использующий схему таблицы FrameCamera. Набор данных мозаики, созданный с помощью растровых типов аэрофотоснимков.	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 (Дополнительный)	Определяет, будут ли все поля из входной таблицы, кроме требуемой схемы, добавлены в таблицу атрибутов набора данных. `INCLUDE_ALL_FIELDS`–Все поля входной таблицы будут добавлены в таблицу атрибутов набора данных. `NO_INCLUDE_ALL_FIELDS`–В таблицу атрибутов набора данных будут добавлены только поля, специфичные для схемы ориентированных изображений. Используется по умолчанию.	Boolean
input_video_file (Дополнительный)	Видеофайл, хранящийся в общедоступном облачном хранилище. Видеофайл должен быть совместим со стандартными веб-браузерами. Дополнительные сведения о поддерживаемых типах видео (форматах и кодеках) см. в разделе Часто используемые кодеки. Для входных данных `TerrestrialFrameVideo` и `Terrestrial360Video` инструмент автоматически извлекает поле местоположения сенсора и временной метки, если видео содержит допустимые метаданные KLV.	File
metadata_file (Дополнительный)	Файл `.csv`, содержащий метаданные видео. Для `AerialFrameVideo` к каждому видео кадра аэросъемки должен прилагаться локальный файл `.csv`, содержащий следующие поля для каждого кадра: Точная временная отметка, Широта сенсора, Долгота сенсора, Высота на эллипсоиде или истинная высота сенсора, Курсовой угол платформы, Угол тангажа платформы, Угол крена платформы, Угол относительного тангажа сенсора, Угол относительной высоты сенсора, Угол относительного азимута сенсора, Горизонтальное поле зрения сенсора и Вертикальное поле зрения сенсора. Все поля обязательны для заполнения и должны содержать допустимые значения. Для `TerrestrialFrameVideo` и `Terrestrial360Video`, файл `.csv` является необязательным. Если включен, файл должен быть локальным и содержать как минимум следующие поля: X,Y и AcquisitionDate (в формате гггг-мм-дд ЧЧ:ММ:СС).	File
minimum_frame_interval (Дополнительный)	Минимальный интервал времени, требуемый между последовательными видеокадрами. В набор данных ориентированных изображений будут добавлены только те кадры, которые разделены как минимум этим интервалом времени. Значение по умолчанию равно 1 секунде.	Time Unit
minimum_sensor_position_change (Дополнительный)	Минимальное расстояние в метрах, на которое сенсор должен перемещаться между кадрами. В набор данных ориентированных изображений будут включены только те кадры, e которых положение сенсора изменилось как минимум на это значение.	Double
minimum_frame_overlap (Дополнительный)	Минимальное процентное перекрытие, требуемое между последовательными кадрами. В набор данных ориентированных изображений будут включены только кадры с перекрытием, превышающим это значение. По умолчанию значение равно 0. Для корректного применения этого параметра необходимо указать допустимое значение для CameraHeading.	Double
distance_to_compute_overlap (Дополнительный)	Расстояние в метрах, используемое для вычисления контура изображения (усеченной пирамиды) для расчета перекрытия. Если не указано, значение по умолчанию равно `FarDistance` / 2. Подробную информацию о `FarDistance` см. в разделе Поля таблицы ориентированных изображений.	Double
compute_heading (Дополнительный)	Определяет, будет ли инструмент создавать значения CameraHeading. Примечание: При отсутствии значений `CameraHeading` вычисление контура завершится ошибкой. `COMPUTE_HEADING`–Инструмент создаст значения `CameraHeading`. Эти вычисленные значения имеют приоритет, даже если видео уже содержит значения для `CameraHeading`. `NO_COMPUTE_HEADING`–Инструмент не создаст значения `CameraHeading`.	Boolean
heading_offset (Дополнительный)	Смещение, применяемое к `CameraHeading`, чтобы учитывать положение установки камеры. Оно применяется, когда камера не направлена вперед, например, когда она установлена сбоку транспортного средства. По умолчанию значение равно 0.	Double

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

Имя	Объяснение	Тип данных
out_oriented_imagery_dataset	Обновленный набор данных ориентированных изображений.	Oriented Imagery Layer

Пример кода

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

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

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

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

Выходная система координат, Географические преобразования, Экстент

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

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

Добавить изображения в набор данных ориентированных изображений (Инструменты ориентированных изображений)

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

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

Параметры

Примечание:

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

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

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

Связанные разделы