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

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

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

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

Формирует цифровую модель местности (DSM), истинное орто, модели 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.

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

  {
      "scenario": "AERIAL_NADIR",
      "fwdOverlap": .60,
      "swdOverlap": .30,
      "quality": "ULTRA",
      "products": "DSM;TRUE_ORTHO;DSM_MESH",
      "dsmMetaProducts": "DSM_BINARY_MASK;DSM_DISTANCE_MAP",
      "resultsFolder": "C:\\RMResultsFolder"
  }

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

В версии 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. Эта опция будет выбрана по умолчанию, если для параметра Сценарий задано Дрон или Аэро в перспективе.	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. DSM_MESH—Будет создана модель mesh ЦММ. Эта опция будет выбрана по умолчанию, если для параметра scenario задано AERIAL_NADIR или SATELLITE. POINT_CLOUD—Будет создано облако точек изображения. Эта опция будет выбрана по умолчанию, если для параметра scenario задано DRONE или AERIAL_OBLIQUE. MESH—Будет создана модель 3D mesh. Эта опция будет выбрана по заданию, если для параметра scenario задано DRONE или AERIAL_OBLIQUE.	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