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

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

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

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

    Внимание:

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

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

  • Если параметр строкового типа необходимо удалить с помощью инструмента Python, задайте значение "None".

Параметры

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

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

Oriented Imagery Layer
Максимальное расстояние
(Дополнительный)

Максимальное расстояние поиска, которое будет использоваться при запросе объектов набора данных. Максимальное расстояние не может быть отрицательным. Единицами измерения являются метры.

Double
Процент покрытия
(Дополнительный)

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

Отрицательное значение в процентах уменьшает размер контура на земле, а положительное - увеличивает. Этот параметр можно использовать для исключения и включения точек по краям изображения. К примеру, значение -30 уменьшит размер контура на 30 процентов, а значение 20 - увеличит его на 20 процентов. Допустимы значения от -50 до 50.

Double
Элемент контура
(Дополнительный)

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

String
Источник высот
(Дополнительный)

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

  • ЦМРИсточником высот будет цифровая модель рельефа, представляющая собой динамический сервис изображений либо сервис листов изображений.
  • Постоянная высотаИсточником высот будет постоянное значение высоты поверхности для всего набора данных.
  • НетИсточник высот будет удален.
String
Постоянная высота
(Дополнительный)

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

Этот параметр активен, если для Источника высот выбрана Постоянная высота.

Double
Цифровая модель рельефа
(Дополнительный)

URL, ссылающийся на входную цифровую модель рельефа. Динамический сервис изображений или сервис листов изображений могут использоваться в качестве ЦМР.

Этот параметр активен, если для Источника высот выбрана ЦМР.

Image Service
Уровень прорисовки
(Дополнительный)

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

Этот параметр включен, если в качестве Цифровой модели рельефа выбран сервис листов изображений.

String
Функция растра
(Дополнительный)

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

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

String
Вертикальная единица измерения
(Дополнительный)

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

  • МетрВ качестве единиц измерения будут использованы метры.
  • ФутыВ качестве единиц измерения будут использованы футы.
String
Единицы измерения временного интервала
(Дополнительный)

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

  • МинутыИзображения будут фильтроваться по минутам.
  • ЧасыИзображения будут фильтроваться по часам.
  • ДниИзображения будут фильтроваться по дням.
  • НеделиИзображения будут фильтроваться по неделям.
  • МесяцыИзображения будут фильтроваться по месяцам.
  • ГодыИзображения будут фильтроваться по годам.
String
Тип ориентированного изображения
(Дополнительный)

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

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

Ориентация камеры после первого поворота вокруг оси Z камеры. Значение в градусах. Значения курса измеряются в положительных значениях угла, отсчитываемого по часовой стрелке, причем север определяется как 0 градусов. При неизвестной ориентации камеры присваивается значение -999.

Double
Наклон камеры
(Дополнительный)

Ориентация камеры после второго поворота вокруг оси X камеры, измеряемая в положительных значениях угла, отсчитываемого против часовой стрелки. Значение в градусах. Угол наклона равен 0 градусов, когда камера направлена прямо на землю. Допустимый диапазон значений угла наклона — от 0 до 180 градусов, при этом 180 градусов соответствует направлению камеры вертикально вверх, а 90 градусов - камеры, смотрящей на горизонт.

Double
Крен камеры
(Дополнительный)

Ориентация камеры после последнего поворота вокруг оси Z камеры, измеряемая в положительных значениях угла, отсчитываемого по часовой стрелке. Значение в градусах. Допустимые значения находятся в диапазоне от -90 до 90 градусов.

Double
Высота камеры
(Дополнительный)

Высота камеры над землей на момент получения снимка. Единицами измерения являются метры. Высота камеры используется для определения видимого экстента изображения. Чем больше значение - тем больше экстент вида. Значения не должны быть отрицательными.

Double
Горизонтальное поле зрения
(Дополнительный)

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

Double
Вертикальное поле зрения
(Дополнительный)

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

Double
Близость
(Дополнительный)

Ближайшее полезное расстояние изображения от положения камеры. Единицами измерения являются метры.

Double
Дальность
(Дополнительный)

Максимальное полезное расстояние изображения от положения камеры. Единицами измерения являются метры. Максимальное расстояние должно быть больше нуля.

Double
Поворот изображения
(Дополнительный)

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

Double
Точность ориентации
(Дополнительный)

Значения стандартных отклонений точности, разделенные точками с запятой. Значения стандартного отклонения добавляются в следующем порядке и формате:

  • Местоположение камеры в направлении XY в метрах
  • Высота камеры в метрах
  • Направление камеры в градусах
  • Наклон камеры в градусах
  • Крен камеры в градусах
  • Ближайшее расстояние в метрах
  • Максимальное расстояние в метрах
  • Высота в метрах

Например, если среднеквадратичное значение отклонение GPS +/– 10 метров в отношении координат x,y и +/– 20 метров в отношении высоты, значение точности ориентации составит 10;20.

String
Префикс пути изображения
(Дополнительный)

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

String
Суффикс пути изображения
(Дополнительный)

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

String
Префикс пути изображения глубины
(Дополнительный)

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

String
Суффикс пути изображения глубины
(Дополнительный)

Суффикс, который будет использоваться для построения пути к изображению глубины вместе с атрибутом Depth Image.

String
Префикс пути ЦМР
(Дополнительный)

Префикс, который будет использоваться для построения пути к ЦМР вместе с URL Elevation Source в атрибуте.

String
Суффикс пути ЦМР
(Дополнительный)

Суффикс, который будет использоваться для построения пути к ЦМР вместе с URL Elevation Source в атрибуте.

String

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

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

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

Oriented Imagery Dataset

arcpy.management.UpdateOrientedImageryDatasetProperties(in_oriented_imagery_dataset, {maximum_distance}, {coverage_percent}, {footprint_item}, {elevation_source}, {constant_elevation}, {dem}, {lod}, {raster_function}, {vertical_measurement_unit}, {time_interval_unit}, {oriented_imagery_type}, {camera_heading}, {camera_pitch}, {camera_roll}, {camera_height}, {hfov}, {vfov}, {near_distance}, {far_distance}, {image_rotation}, {orientation_accuracy}, {image_path_prefix}, {image_path_suffix}, {depth_image_path_prefix}, {depth_image_path_suffix}, {dem_path_prefix}, {dem_path_suffix})
ИмяОписаниеТип данных
in_oriented_imagery_dataset

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

Oriented Imagery Layer
maximum_distance
(Дополнительный)

Максимальное расстояние поиска, которое будет использоваться при запросе объектов набора данных. Максимальное расстояние не может быть отрицательным. Единицами измерения являются метры.

Double
coverage_percent
(Дополнительный)

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

Отрицательное значение в процентах уменьшает размер контура на земле, а положительное - увеличивает. Этот параметр можно использовать для исключения и включения точек по краям изображения. К примеру, значение -30 уменьшит размер контура на 30 процентов, а значение 20 - увеличит его на 20 процентов. Допустимы значения от -50 до 50.

Double
footprint_item
(Дополнительный)

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

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

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

  • DEMИсточником высот будет цифровая модель рельефа, представляющая собой динамический сервис изображений либо сервис листов изображений.
  • CONSTANT_ELEVATIONИсточником высот будет постоянное значение высоты поверхности для всего набора данных.
  • NONEИсточник высот будет удален.
String
constant_elevation
(Дополнительный)

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

Этот параметр включен, если значение параметра elevation_source задано как CONSTANT_ELEVATION.

Double
dem
(Дополнительный)

URL, ссылающийся на входную цифровую модель рельефа. Динамический сервис изображений или сервис листов изображений могут использоваться в качестве ЦМР.

Этот параметр включен, если значение параметра elevation_source задано как DEM.

Image Service
lod
(Дополнительный)

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

Этот параметр включен, если значением параметра dem является сервис листов изображений.

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

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

Этот параметр включен, если значением параметра dem является динамический сервис изображений.

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

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

  • METERВ качестве единиц измерения будут использованы метры.
  • FEETВ качестве единиц измерения будут использованы футы.
String
time_interval_unit
(Дополнительный)

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

  • MINUTESИзображения будут фильтроваться по минутам.
  • HOURSИзображения будут фильтроваться по часам.
  • DAYSИзображения будут фильтроваться по дням.
  • WEEKSИзображения будут фильтроваться по неделям.
  • MONTHSИзображения будут фильтроваться по месяцам.
  • YEARSИзображения будут фильтроваться по годам.
String
oriented_imagery_type
(Дополнительный)

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

  • HORIZONTALВ наборе данных находятся изображения, экспозиция которых параллельна земле и обращена к горизонту.
  • OBLIQUEВ наборе данных содержатся изображения, экспозиция которых расположена под углом к земле, обычно около 45 градусов, поэтому можно увидеть боковые стороны объектов.
  • NADIRВ наборе данных содержатся изображения, экспозиция которых перпендикулярна земле и смотрит прямо вниз. Вы увидите только верх объектов.
  • 360В наборе данных содержатся изображения, полученные камерами, которые обеспечивают сферический объемный обзор на 360 градусов или были сшиты в 360-градусные изображения, полученные несколькими камерами.
  • INSPECTIONВ наборе данных содержатся крупные изображения объектов.
  • NONEТип ориентированного изображения будет удален из набора данных.
String
camera_heading
(Дополнительный)

Ориентация камеры после первого поворота вокруг оси Z камеры. Значение в градусах. Значения курса измеряются в положительных значениях угла, отсчитываемого по часовой стрелке, причем север определяется как 0 градусов. При неизвестной ориентации камеры присваивается значение -999.

Double
camera_pitch
(Дополнительный)

Ориентация камеры после второго поворота вокруг оси X камеры, измеряемая в положительных значениях угла, отсчитываемого против часовой стрелки. Значение в градусах. Угол наклона равен 0 градусов, когда камера направлена прямо на землю. Допустимый диапазон значений угла наклона — от 0 до 180 градусов, при этом 180 градусов соответствует направлению камеры вертикально вверх, а 90 градусов - камеры, смотрящей на горизонт.

Double
camera_roll
(Дополнительный)

Ориентация камеры после последнего поворота вокруг оси Z камеры, измеряемая в положительных значениях угла, отсчитываемого по часовой стрелке. Значение в градусах. Допустимые значения находятся в диапазоне от -90 до 90 градусов.

Double
camera_height
(Дополнительный)

Высота камеры над землей на момент получения снимка. Единицами измерения являются метры. Высота камеры используется для определения видимого экстента изображения. Чем больше значение - тем больше экстент вида. Значения не должны быть отрицательными.

Double
hfov
(Дополнительный)

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

Double
vfov
(Дополнительный)

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

Double
near_distance
(Дополнительный)

Ближайшее полезное расстояние изображения от положения камеры. Единицами измерения являются метры.

Double
far_distance
(Дополнительный)

Максимальное полезное расстояние изображения от положения камеры. Единицами измерения являются метры. Максимальное расстояние должно быть больше нуля.

Double
image_rotation
(Дополнительный)

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

Double
orientation_accuracy
(Дополнительный)

Значения стандартных отклонений точности, разделенные точками с запятой. Значения стандартного отклонения добавляются в следующем порядке и формате:

  • Местоположение камеры в направлении XY в метрах
  • Высота камеры в метрах
  • Направление камеры в градусах
  • Наклон камеры в градусах
  • Крен камеры в градусах
  • Ближайшее расстояние в метрах
  • Максимальное расстояние в метрах
  • Высота в метрах

Например, если среднеквадратичное значение отклонение GPS +/– 10 метров в отношении координат x,y и +/– 20 метров в отношении высоты, значение точности ориентации составит 10;20.

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

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

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

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

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

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

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

Суффикс, который будет использоваться для построения пути к изображению глубины вместе с атрибутом Depth Image.

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

Префикс, который будет использоваться для построения пути к ЦМР вместе с URL Elevation Source в атрибуте.

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

Суффикс, который будет использоваться для построения пути к ЦМР вместе с URL Elevation Source в атрибуте.

String

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

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

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

Oriented Imagery Dataset

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset",
    maximum_distance=550,
    footprint_item='MyOrientedImageryDataset_footprint',
    image_path_prefix='None')
UpdateOrientedImageryDatasetProperties, пример 2 (автономный скрипт)

Следующий скрипт Python демонстрирует использование функции UpdateOrientedImageryDatasetProperites в качестве автономного скрипта.

# Import system modules
import arcpy

# Set local variables
in_oi = "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset"
new_maximum_distance = 550
footprint = "MyOrientedImageryDataset_footprint"
new_time_unit = "HOURS"
new_camera_height = 2.5

# Run Update Oriented Imagery Dataset Properties
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    in_oriented_imagery_dataset = in_oi,
    maximum_distance = new_maximum_distance,
    footprint_item = footprint,
    time_interval_unit = new_time_unit,
    camera_height = new_camera_height,
)

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

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