Импорт изображений Indoor (Indoors)

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

Импортирует 360-градусные и панорамные изображения из файла .e57 в набор данных ориентированных изображений. Результаты работы этого инструмента могут быть добавлены в карты и сцены с поддержкой этажей в ArcGIS Pro.

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

• Используйте этот инструмент для загрузки 360-градусных и панорамных изображений в набор данных ориентированных изображений. Можно добавить слои ориентированных изображений с поддержкой этажности на карты с поддержкой этажности.

• Инструмент поддерживает 360-градусные и панорамные изображения в формате JPEG, хранящиеся в файлах .e57. Изображения должны использовать равнопрямоугольное представление (сферическое).

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

• Значение параметра Целевой слой ориентированных изображений должно быть задано как слой ориентированных изображений с поддержкой z-значений. Создайте ориентированное изображение с помощью инструмента Создать набор данных ориентированных изображений.

  Слой ориентированных изображений может быть основан на локальном наборе данных ориентированных изображений или размещенном сервисе объектов. При импорте фотографий в размещенный сервис объектов сервис объектов должен поддерживать вложения объектов.

• Используйте параметр Входная система координат для определения горизонтальной и вертикальной систем координат входных данных.

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

• Для учета этажей инструмент добавляет поле LEVEL_ID к целевому набору данных ориентированных изображений, если поле отсутствовало.

• Инструмент назначает Level ID изображениям, сравнивая z-значения у изображений и уровней следующим образом:

  • Изображению назначается Level ID объекта уровня, который вертикально находится на уровне изображения или непосредственно под ним.
  • Когда изображение имеет z-значение ниже самого нижнего уровня или на 15 и более метров выше самого высокого уровня, изображению будет присвоен Level ID со значением Null.
  • Изображения, которые находятся не в пределах объекта уровня (по x,y координатам) получат Level ID со значением Null.

• Если у входных данных и входного слоя уровней разные начала z-значений, используйте параметр Уравнивание высоты для компенсации разницы. Уравнивание высоты применяется после всех необходимых перепроецирований местоположений изображений.

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

  

  Отрицательное значение -400m используется для выравнивания положения изображений и уровней по высоте.

• Инструмент заполняет атрибуты объекта ориентированного изображения следующим образом:

  • Shape— Значения x-, y-, и z координат основываются на информации о местоположении файла входных данных для изображения.
  • Name— Название изображения берется из метаданных файла входных данных. Если метаданные отсутствуют, имя файла входных данных используется с добавлением последовательных числовых окончаний.

    Примечание:

    Значение может отличаться от имени файла в поле ImagePath.

  • LEVEL_ID—Идентификатор уровня связанного объекта уровня. Если связанный уровень отсутствует, будет назначено значение Null.
  • ImagePath— Путь к файлу изображения, связанному с объектом.
  • AcquisitionDate— Дата и время съемки берется из метаданных входного файла. Если метаданные отсутствуют, используются дата и время последнего изменения файла данных.
  • CameraHeading— Направление камеры определяется на основе информации о повороте в файле входных данных изображения. Значения задаются в градусах.
    • Значения курса (направления) измеряются в положительном направлении по часовой стрелке, где север определяется как 0 градусов.
    • Инструмент не заполняет атрибуты CameraPitch или CameraRoll ориентированного изображения.

      Примечание:

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

  • HorizontalFieldOfView— Поле зрения камеры в горизонтальном направлении, в градусах.
    • Значения должны находиться в диапазоне от 0 до 360.
    • По умолчанию инструмент задает значение 360. Настройте это значение с помощью параметра Горизонтальное поле зрения.
  • VerticalFieldOfView—Поле зрения камеры в вертикальном направлении, в градусах.
    • Допустимые значения находятся в диапазоне от 0 до 180.
    • По умолчанию инструмент задает значение 180. Настройте это значение с помощью параметра Вертикальное поле зрения.
  • OrientedImageryType— Тип ориентированного изображения. Инструмент назначает значение 360, что указывает, что изображение является сферическим круговым или панорамным обзором.

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

• Импортированные изображения хранятся как локальные файлы в папке, заданной параметром Целевая папка изображений.

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

  Если значение параметра Целевое ориентированное изображение - это размещенный сервис объектов, импортированные изображения будут добавлены в качестве вложений объектов в слое ориентированных изображений.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входные данные	Файл .e57 с целевым ориентированным изображением для импорта.	File
Входные объекты уровней	Связанный слой уровней из информационной модели ArcGIS Indoors, расположенный в той же рабочей области, что и целевой слой изображений.	Feature Layer
Целевая папка изображений	Существующая папка, в которую будут записаны файлы изображений.	Folder
Целевое ориентированное изображение	Целевой слой ориентированных изображений, в который будут добавлены объекты.	Oriented Imagery Layer
Входная система координат (Дополнительный)	Пространственная привязка входного файла изображения. Система координат может быть указана, если она не указана во входном файле изображения.	Spatial Reference
Уравнивание высоты (Дополнительный)	Значение поправки для z-значений импортируемых изображений. Если местоположения импортируемых изображений перепроецируются, выравнивание выполняется после перепроецирования. Значение по умолчанию 0 метров. Значение -300 футов уменьшает z-значение импортируемых изображений на 300 футов. Значение 250 футов увеличивает z-значение импортируемых изображений на 250 футов.	Double
Горизонтальное поле зрения (Дополнительный)	Эффективный охват горизонтального поля зрения импортируемых изображений в градусах. Значения должны находиться в диапазоне от 0 до 360. Значение, предлагаемое по умолчанию, равно 360.	Double
Вертикальное поле зрения (Дополнительный)	Эффективный охват вертикального поля зрения импортируемых изображений в градусах. Допустимые значения находятся в диапазоне от 0 до 180. Значение по умолчанию 180.	Double

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

Подпись	Описание	Тип данных
Обновленное целевое ориентированное изображение	Обновленный набор данных ориентированных изображений в рабочей области Indoors. Существующие данные ориентированных изображений сохранятся в процессе импорта. Новый точечный объект со связанным изображением в качестве вложения добавляется для каждого изображения во входных данных. Атрибуты добавляемых точечных объектов заполняются на основе атрибутов входного файла изображения.	Oriented imagery Layer

Python

arcpy.indoors.ImportIndoorImages(in_data, in_level_features, target_image_folder, target_oriented_imagery, {in_coordinate_system}, {elevation_adjustment}, {horizontal_field_of_view}, {vertical_field_of_view})

Имя	Описание	Тип данных
in_data	Файл .e57 с целевым ориентированным изображением для импорта.	File
in_level_features	Связанный слой уровней из информационной модели ArcGIS Indoors, расположенный в той же рабочей области, что и целевой слой изображений.	Feature Layer
target_image_folder	Существующая папка, в которую будут записаны файлы изображений.	Folder
target_oriented_imagery	Целевой слой ориентированных изображений, в который будут добавлены объекты.	Oriented Imagery Layer
in_coordinate_system (Дополнительный)	Пространственная привязка входного файла изображения. Система координат может быть указана, если она не указана во входном файле изображения.	Spatial Reference
elevation_adjustment (Дополнительный)	Значение поправки для z-значений импортируемых изображений. Если местоположения импортируемых изображений перепроецируются, выравнивание выполняется после перепроецирования. Значение по умолчанию 0 метров. Значение -300 футов уменьшает z-значение импортируемых изображений на 300 футов. Значение 250 футов увеличивает z-значение импортируемых изображений на 250 футов.	Double
horizontal_field_of_view (Дополнительный)	Эффективный охват горизонтального поля зрения импортируемых изображений в градусах. Значения должны находиться в диапазоне от 0 до 360. Значение, предлагаемое по умолчанию, равно 360.	Double
vertical_field_of_view (Дополнительный)	Эффективный охват вертикального поля зрения импортируемых изображений в градусах. Допустимые значения находятся в диапазоне от 0 до 180. Значение по умолчанию 180.	Double

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

Имя	Описание	Тип данных
updated_target_oriented_imagery	Обновленный набор данных ориентированных изображений в рабочей области Indoors. Существующие данные ориентированных изображений сохранятся в процессе импорта. Новый точечный объект со связанным изображением в качестве вложения добавляется для каждого изображения во входных данных. Атрибуты добавляемых точечных объектов заполняются на основе атрибутов входного файла изображения.	Oriented imagery Layer

Пример кода

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

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

arcpy.indoors.ImportIndoorImages(r"C:\BuildingScans\BuildingA.e57",
                                 r"C:\IndoorsModel.gdb\Indoors\Levels",
                                 r"C:\indoorsphotos\photos",
                                 r"C:\IndoorsModel.gdb\OIDataset",
                                 '', '', '')

ImportIndoorImages пример 2 (окно Python)

В следующем автономном скрипте показано использование функции ImportIndoorImages.

# Import system modules 
import arcpy

#Set parameter values
    in_data=r"C:\BuildingScans\BuildingA.e57"
    in_level_features=r"C:\IndoorsModel.gdb\Indoors\Levels"
    target_image_folder=r"C:\indoorsphotos\photos"
    target_oriented_imagery=r"C:\IndoorsModel.gdb\Indoors\OIDataset"
    in_coordinate_system='PROJCS["NAD_1983_2011_StatePlane_California_VI_FIPS_0406",GEOGCS["GCS_NAD_1983_2011",' \
                           'DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],' \
                           'PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],' \
                           'PROJECTION["Lambert_Conformal_Conic"],PARAMETER["False_Easting",2000000.0],' \
                           'PARAMETER["False_Northing",500000.0],PARAMETER["Central_Meridian",-116.25],' \
                           'PARAMETER["Standard_Parallel_1",32.78333333333333],' \
                           'PARAMETER["Standard_Parallel_2",33.88333333333333],' \
                           'PARAMETER["Latitude_Of_Origin",32.16666666666666],' \
                           'UNIT["Meter",1.0],AUTHORITY["EPSG",6425]]'
    elevation_adjustment="-396 Meters"
    horizontal_field_of_view=360
    vertical_field_of_view=180
    
#Run the tool
ImportIndoorImages_Indoors(in_level_features, target_image_folder, target_oriented_imagery, in_coordinate_system,
                           elevation_adjustment, horizontal_field_of_view, vertical_field_of_view)

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

Этот инструмент не использует параметры среды геообработки

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

• Basic: Нет
• Standard: Обязательно ArcGIS Indoors Pro или ArcGIS Indoors Maps
• Advanced: Обязательно ArcGIS Indoors Pro или ArcGIS Indoors Maps