Реконструировать поверхность (Reality Mapping)

Доступно с лицензией Advanced.

Доступно для организации ArcGIS organization с лицензией ArcGIS Reality.

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

Формирует цифровую модель местности (ЦММ), истинное орто, модели mesh ЦММ, 3D модель mesh и также облака точек на основе уравненного снимка в наборе данных мозаики.

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

• Необходимо предварительно задать параметр Входной набор данных мозаики. Подробнее о блочном уравнивании в ортокартографировании см. документацию инструмента Вычислить Блочное уравнивание.

• После запуска инструмента будет создан файл reality.json в местоположении, заданном параметром Папка реконструкции. Если инструмент запускается еще раз, используя то же значение параметра Папка реконструкции наличие файла reality.json позволяет заполнить параметры Сценарий, Качество, Объекты водной поверхности и Объекты корректировки на основе значений параметров из предыдущего запуска. Для создания дополнительных продуктов в том же проекте запустите инструмент снова.

  Примечание:

  Чтобы сбросить значения, используемые в параметрах Объекты водной поверхности и Объекты корректировки установите значения этих параметров на NONE.

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

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

• Если задан параметр Опции реконструкции, то свойства файла .json или строки JSON будут заданы по умолчанию для оставшихся дополнительных параметров.

  Примечание:

  Если одно и то же свойство установлено с использованием параметра Опции реконструкции и остальными дополнительными параметрами, значение дополнительного параметра перезапишет значение Опции реконструкции.

  Следующий список определяет ключевые поля, которые используются параметром Опции реконструкции в виде файла .json или строки JSON:

  • scenario - определяет тип изображений, которые используются для создания выходных продуктов.
  • fwdOverlap — процент прямого (продольного) перекрытия изображений. Это ключевое слово используется, когда scenario задан как AERIAL_NADIR.
  • swdOverlap — процент бокового (поперечного) перекрытия между изображениями. Это ключевое слово используется, когда scenario задан как AERIAL_NADIR.
  • quality — определяет качество итогового продукта.
  • products — определяет продукты, которые будут созданы.
  • tileSize — размер листа. Значения могут быть AUTO или введите double.
  • cellSize - размер ячейки выходного растра продукта. Это значение оценивается автоматически, но его можно задать вручную. Значения могут быть AUTO или введите double.
  • tilingOrigin - координаты начала отсчета листов на карте, например, "tilingOrigin": [0, 0].
  • areaFeatures — область интереса.
  • waterbodyFeatures — полигон, который задает экстент больших водных объектов.
  • correctionFeatures — полигон, который задает экстент всех поверхностей, не являющихся водными объектами.
  • dsmMetaProducts - определяет продукты метаданных DSM для включения в выходные данные. Значения могут включать любую комбинацию DSM_BINARY_MASK, DSM_DISTANCE_MAP и DSM_POINT_MODEL_COUNT.
  • meshFormats -- задает выходной формат mesh. Допустимые значения - это SLPK, OBJ и 3D_TILES, например, "meshFormats": "SLPK;OBJ;3D_TILES". Значение по умолчанию равно SLPK.
  • processingFolder - местоположение обработки в локальном хранилище. По умолчанию используется локальная папка temp. Созданный ресурс будет удален после завершения обработки.
  • resultsFolder - местоположение вывода результатов обработки. По умолчанию используется папка reconstruction.
  • meshSettings - задает настройки модели mesh для продуктов mesh. Поддерживаемые настройки модели mesh - srs, exportInLocalCoordinateSystem, exportAsSingleFile и keepHeightsOfInputCoordinateSystem. Разные форматы mesh поддерживают разные настройки модели mesh. Настройки модели mesh могут быть заданы глобально или в соответствии с форматом. Например, если установлено значение { "dsmMeshSettings": { "srs": "4326;5773" } }, формат mesh SLPK и формат mesh 3D_Tiles будут иметь на выходе указанную пространственную привязку. Если вы хотите, чтобы формат mesh SLPK и формат mesh 3D_Tiles имели на выходе другую пространственную привязку, задайте настройки модели mesh в соответствии с форматом.
    • srs — пространственная привязка для формата SLPK. Значение srs может быть парой WKID горизонтальной системы координат и вертикальной системы координат, например, "4326;5773" или WKT. Первое значение является горизонтальной системой координат, а значение srs можно указать, если поддерживается преобразование из системы координат проекта в выбранную систему координат. Если целевая пространственная привязка — это географическая система координат, в настоящее время поддерживается только WGS84. По умолчанию это пространственная привязка набора данных мозаики.
    • exportInLocalCoordinateSystem - логическое значение, указывающее, будет ли модель mesh экспортироваться в локальной системе координат. Эта опция доступна для формата OBJ. Если значение установлено на True, модель mesh будет экспортироваться в локальной системе координат. Если значение установлено на False, модель mesh будет экспортироваться в системе координат реконструкции. Значение по умолчанию равно False.
    • exportAsSingleFile - логическое значение, указывающее, будет ли модель mesh экспортироваться в виде одного файла .obj или нескольких файлов. Эта опция доступна только для формата OBJ. Если значение установлено на True, модель mesh будет экспортироваться в виде одного файла .obj. Если значение установлено на False, модель mesh будет экспортироваться в виде нескольких файлов .obj. Значение по умолчанию равно False.
  • dsmMeshSettings - задает настройки модели mesh для продукта модель Mesh ЦММ. Поддерживаемые настройки модели mesh ЦММ точно такие же, как и настройки meshSettings выше.

• Ниже приведен пример значения параметра Опции реконструкции, заданный как JSON:

  {
    "scenario": "AERIAL_NADIR",
    "fwdOverlap": 0.60,
    "swdOverlap": 0.30,
    "quality": "ULTRA",
    "products": "DSM;TRUE_ORTHO;DSM_MESH",
    "dsmMeshFormats": "SLPK;3D_TILES;OBJ",
    "dsmMetaProducts": "DSM_BINARY_MASK;DSM_DISTANCE_MAP",
    "dsmMeshSettings": {
      "SLPK": {
        "srs": "4326;5773"
      },   
      "OBJ": {
        "exportInLocalCoordinateSystem": false,
        "exportAsSingleFile": false
      }
    },
    "resultsFolder": "C:\\RMResultsFolder"
  }

• Мультиспектральные данные БПЛА поддерживают только создание продуктов ЦММ и истинного орто; они не поддерживают создание облаков точек или продуктов mesh.

• Если параметр Продукты установлен на ЦММ, инструмент создаст выходной набор данных LAS или папку LAS в папке ...\Results\DSM\las. Набор данных LAS или папка может быть использована для создания цифровой модели поверхности (ЦМП) с помощью инструмента Интерполировать из облака точек.

Прежние версии:

В версии ArcGIS Pro 3.2 опция По умолчанию в параметрах Сценарий была опцией БПЛА. Кроме того, следующие параметры были признаны устаревшими:

• Параметр Качество - опции Средний и Низкий были признаны устаревшими.
• Параметр Область интереса - опция Автоматически устарела.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной набор данных мозаики	Уравненный входной набор данных мозаики.	Mosaic Dataset; Mosaic Layer
Папка реконструкции	Папка выходного набора данных.	Folder
Опции реконструкции (Дополнительный)	Файл .json или строка JSON, которая определяет значения для параметров инструмента. Если значение этого параметра задано, свойства файла .json или строки JSON будут заданы по умолчанию для оставшихся дополнительных параметров. См. раздел Использование со списком опций.	File; String
Сценарий (Дополнительный)	Определяет тип изображений, которые используются для создания выходных продуктов. Беспилотный летательный аппарат—Входные снимки будут задаваться по мере получения с БПЛА или наземных камер. Аэро в надире—Входные снимки будут задаваться по мере получения с больших фотограмметрических съемочных систем. Аэро перспективный—Входные снимки будут задаваться по мере получения с перспективных съемочных систем. Спутник—Входные изображения будут определены как полученные со спутника.	String
Прямое перекрытие (Дополнительный)	Процент прямого перекрытия (продольное), который будет использоваться между изображениями. Значение по умолчанию равно 60. Этот параметр активен, когда параметр Сценарий задан как Аэро в надире.	Long
Боковое перекрытие (Дополнительный)	Процент бокового (поперечного) перекрытия между изображениями. Значение по умолчанию равно 30. Этот параметр активен, когда параметр Сценарий задан как Аэро в надире.	Long
Качество (Дополнительный)	Определяет качество итогового продукта. Ультра—Будет использовано облако точек с максимальной плотностью. Входные изображения будут использовать их исходное (полное) разрешение. Высокая—Будет использовано облако точек с высокой плотностью. Разрешение входных изображений будет снижено в два раза.	String
Продукты (Дополнительный)	Определяет продукты, которые будут созданы. ЦММ—Будет создана ЦММ. Эта опция будет выбрана по умолчанию, если для параметра Сценарий задан как Аэро в надире или Спутник. Истинное орто—К изображению будет применена ортотрансформация. Эта опция будет выбрана по умолчанию, если для параметра Сценарий задан как Аэро в надире или Спутник. ЦММ Mesh—Будет создана модель mesh ЦММ. Эта опция будет выбрана по умолчанию, если для параметра Сценарий задан как Аэро в надире или Спутник. Облако точек—Будет создано облако точек изображения. Эта опция будет выбрана по умолчанию, если для параметра Сценарий задано БПЛА или Аэро в перспективе. Модель Mesh—Будет создана модель 3D mesh. Эта опция будет выбрана по умолчанию, если для параметра Сценарий задано БПЛА или Аэро в перспективе. Гауссовы пятна—Точки будут отрисованы в плотном 3D-облаке точек с гауссовым распределением, и будет использовано машинное обучение для восстановления высококачественных 3D-сцен, чтобы захватить мелкие детали, такие как тонкие структуры.	String
Размер ячейки (Дополнительный)	Размер ячейки выходного продукта.	Double; String
Область интереса (Дополнительный)	Область интереса, которая будет использоваться для выбора изображений для обработки. Область интересов может быть вычислена автоматически или определена с помощью входного полигона. Если значение содержит 3D геометрию, то z-компонент будет проигнорирован. Если значение включает перекрывающиеся объекты, то будет вычислено объединение этих объектов.	Feature Layer; File; String
Объекты водной поверхности (Дополнительный)	Полигон, который задает экстент больших водных объектов. Значение должно быть 3D-объект.	Feature Layer; File; String
Объекты корректировки (Дополнительный)	Полигон, который задает экстент всех поверхностей, не являющихся водными объектами. Значение должно быть 3D-объект.	Feature Layer; File; String

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

Подпись	Описание	Тип данных
Обновленная папка реконструкции	Папка выходной реконструкции.	Folder

Python

arcpy.rm.ReconstructSurface(in_mosaic_dataset, recon_folder, {recon_options}, {scenario}, {fwd_overlap}, {swd_overlap}, {quality}, {products}, {cell_size}, {aoi}, {waterbody_features}, {correction_features})

Имя	Описание	Тип данных
in_mosaic_dataset	Уравненный входной набор данных мозаики.	Mosaic Dataset; Mosaic Layer
recon_folder	Папка выходного набора данных.	Folder
recon_options (Дополнительный)	Файл .json или строка JSON, которая определяет значения для параметров инструмента. Если значение этого параметра задано, свойства файла .json или строки JSON будут заданы по умолчанию для оставшихся дополнительных параметров. См. раздел Использование со списком опций.	File; String
scenario (Дополнительный)	Определяет тип изображений, которые используются для создания выходных продуктов. DRONE—Входные снимки будут задаваться по мере получения с БПЛА или наземных камер. AERIAL_NADIR—Входные снимки будут задаваться по мере получения с больших фотограмметрических съемочных систем. AERIAL_OBLIQUE—Входные снимки будут задаваться по мере получения с перспективных съемочных систем. SATELLITE—Входные изображения будут определены как полученные со спутника.	String
fwd_overlap (Дополнительный)	Процент прямого перекрытия (продольное), который будет использоваться между изображениями. Значение по умолчанию равно 60. Этот параметр активен тогда, когда параметр scenario имеет значение AERIAL_NADIR.	Long
swd_overlap (Дополнительный)	Процент бокового (поперечного) перекрытия между изображениями. Значение по умолчанию равно 30. Этот параметр активен тогда, когда параметр scenario имеет значение AERIAL_NADIR.	Long
quality (Дополнительный)	Определяет качество итогового продукта. ULTRA—Будет использовано облако точек с максимальной плотностью. Входные изображения будут использовать их исходное (полное) разрешение. HIGH—Будет использовано облако точек с высокой плотностью. Разрешение входных изображений будет снижено в два раза.	String
products [products,...] (Дополнительный)	Определяет продукты, которые будут созданы. DSM—Будет создана ЦММ. Эта опция будет выбрана по умолчанию, если для параметра scenario задано AERIAL_NADIR или SATELLITE. TRUE_ORTHO—К изображению будет применена ортотрансформация. Эта опция будет выбрана по умолчанию, если для параметра scenario задано AERIAL_NADIR или SATELLITE. DSM_MESH—Будет создана модель mesh ЦММ. Эта опция будет выбрана по умолчанию, если для параметра scenario задано AERIAL_NADIR или SATELLITE. POINT_CLOUD—Будет создано облако точек изображения. Эта опция будет выбрана по умолчанию, если для параметра scenario задано DRONE или AERIAL_OBLIQUE. MESH—Будет создана модель 3D mesh. Эта опция будет выбрана по умолчанию, если для параметра scenario задано DRONE, AERIAL_OBLIQUE. GAUSSIAN_SPLATS—Точки будут отрисованы в плотном 3D-облаке точек с гауссовым распределением, и будет использовано машинное обучение для восстановления высококачественных 3D-сцен, чтобы захватить мелкие детали, такие как тонкие структуры.	String
cell_size (Дополнительный)	Размер ячейки выходного продукта.	Double; String
aoi (Дополнительный)	Область интереса, которая будет использоваться для выбора изображений для обработки. Область интересов может быть вычислена автоматически или определена с помощью входного полигона. Если значение содержит 3D геометрию, то z-компонент будет проигнорирован. Если значение включает перекрывающиеся объекты, то будет вычислено объединение этих объектов.	Feature Layer; File; String
waterbody_features (Дополнительный)	Полигон, который задает экстент больших водных объектов. Значение должно быть 3D-объект.	Feature Layer; File; String
correction_features (Дополнительный)	Полигон, который задает экстент всех поверхностей, не являющихся водными объектами. Значение должно быть 3D-объект.	Feature Layer; File; String

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

Имя	Описание	Тип данных
derived_recon_folder	Папка выходной реконструкции.	Folder

Пример кода

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

В этом примере создается 3D-продукт из уравненного набора данных мозаики.

# ReconstructSurface example 1 (Python window) 
# This example creates 3D products from an adjusted mosaic dataset. 

# Import system modules 
import arcpy 

products_3d = arcpy.rm.ReconstructSurface(r"C:\ReconstructSurface.gdb\droneMD", r"C:\RS_output", None, "DRONE", None, None, "HIGH", "POINT_CLOUD;MESH", 0.1, r"\\shared_location\RMeTesting.gdb\AOI", None, r"\\shared_location\RMTesting.gdb\CorrectionFeature")

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

В этом примере создается ЦММ, ЦММ mesh и истинный орто продукты с использованием строки JSON.

# ReconstructSurface example 2 (Python window) 
# This example creates DSM, DSM mesh, and True Ortho products using JSON string. 

# Import system modules 

import arcpy

products_2d = arcpy.rm.ReconstructSurface(r"C:\ReconstructSurface.gdb\droneMD_json", r"C:\RS_output_folder", r'{"scenario":"DRONE","quality":"ULTRA","products":"DSM;TRUE_ORTHO;DSM_MESH","cellSize":0.05,"correctionFeatures":"\\\\shared_location\\RMeTesting.gdb\\CorrectionFeature","areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI","processingFolder":"\\\\shared_location\\RMeprocessingFolder"}')

ReconstructSurface, пример 3 (автономный скрипт)

Этот пример создает несколько продуктов на основе аэросъемки в надире.

# ReconstructSurface example 3 (stand-alone script) 
# This example creates multiple 2D products from aerial nadir imagery. 

# Import system modules 
import arcpy 

# Define input parameters 
in_mosaic = "C:/ReconstructSurface.gdb/aerialMD" 
out_folder = "C:/ScenarioAerialNadir" 
json_file = "" 
scenario = "AERIAL_NADIR" 
forward_overlap = 60
side_overlap = 30 
out_quality = "ULTRA" 
output_products = "DSM;TRUE_ORTHO;DSM_MESH" 

# Execute - Generate Products 
products = arcpy.rm.ReconstructSurface(in_mosaic, out_folder, json_file,senario, forward_overlap, side_overlap, out_quality, output_products)

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

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

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

• Basic: Нет
• Standard: Обязательно ArcGIS Reality for ArcGIS Pro
• Advanced: Обязательно ArcGIS Reality for ArcGIS Pro