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

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

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

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

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

Лицензия:

Инструмент Реконструировать поверхность доступен только с лицензией ArcGIS Reality for ArcGIS Pro, вместе с лицензией ArcGIS Standard или Advanced.

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

Необходимо предварительно задать параметр Входной набор данных мозаики. Подробнее о блочном уравнивании в Reality mapping см. справку инструмента Вычислить Блочное уравнивание.
После запуска инструмента будет создан файл Project.spr в Папке реконструкции. Если Папка реконструкции используется повторно, наличие файла Project.spr приведет к тому, что параметр Входной набор данных мозаики будет скрыт в панели Геообработка. Это позволит вам создавать дополнительные продукты без повторного вычисления информации из входной мозаики, которая хранится в файле Project.spr. Для создания дополнительных продуктов в том же проекте запустите инструмент снова.
Если во входном наборе данных мозаики есть изменения, укажите другую папку в качестве Папки реконструкции. Для создания продуктов, которые отразят изменения в наборе данных мозаики, укажите новое местоположение, а затем снова запустите этот инструмент.
Используйте параметр Область интереса для ускорения обработки и создания продуктов для поднабора изображений во входной мозаике.
Если задан параметр Опции реконструкции, то свойства файла .json или строки JSON будут заданы по умолчанию для оставшихся дополнительных параметров.
Следующий список определяет ключевые поля, которые используются параметром Опции реконструкции в виде файла .json или строки JSON:
- scenario - определяет тип изображений, которые используются для создания выходных продуктов.
- fwdOverlap—процент прямого (продольного) перекрытия изображений. Это ключевое слово используется, когда scenario задан как AERIAL_NADIR.
- swdOverlap—процент бокового (поперечного) перекрытия между изображениями. Это ключевое слово используется, когда scenario задан как AERIAL_NADIR.
- quality—определяет качество итогового продукта.
- products—определяет продукты, которые будут созданы.
- srs - географическая система координат проекта в формате WKT.
- tileSize—размер листа. Значения могут быть AUTO или введите double.
- cellSize - размер ячейки выходного растра продукта. Это значение оценивается автоматически, но его можно задать вручную. Значения могут быть AUTO или введите double.
- cellSizeMultiplicator — скалярное значение размера ячейки. Это значение оценивается автоматически, но его можно задать вручную. Значения могут быть AUTO или введите double.
- areaX—x-координаты выходного экстента.
- areaY—y-координаты выходного экстента.
- areaZ—z-координаты выходного экстента.
- areaFeatures—область интереса.
- waterbodyFeatures—полигон, который задает экстент больших водных объектов.
- correctionFeatures—полигон, который задает экстент всех поверхностей, не являющихся водными объектами.
- gpuStatus—булево значение, которое определяет, будет ли для обработки использоваться графический процессор. Значение по умолчанию зависит от значения параметра среды Тип процессора.
- applyGlobalColorBalancing—булево значение, которое определяет, нужно ли применять балансировку цвета. По умолчанию используется значение true.
- orthoEnhanceTexture —булево значение, которое определяет, будут ли улучшены текстуры для продуктов DSM ортофото. Значение по умолчанию – false.
- meshEnhanceTexture — булево значение, которое определяет, будут ли улучшены текстуры для продуктов mesh. По умолчанию используется значение true.
- colorBitDepth - Целочисленное значение, указывающее разрядность цвета продуктов истинный орто и ЦММ. Допустимые значения - 8 и 16. Значение по умолчанию - 8 бит.
- dsmDepthBuffer--целочисленное значение, которое определяет, сколько наивысших точек в ячейке DSM будут использоваться для вычисления значения высоты в ячейке. По умолчанию, это значение определяется автоматически, но значение может также задаваться вручную.
- exportAdditionalTFWs—булево значение, которое определяет, будут ли экспортированы дополнительные файлы .tfw. По умолчанию используется значение true.
- exportImagePyramidsInTIFFs—булево значение, которое определяет, будут ли пирамидные слои изображения экспортированы в файлы .tiff. По умолчанию используется значение true.
- dsmMetaProducts - определяет продукты метаданных DSM для включения в выходные данные. Значения могут включать любую комбинацию DSM_CELL_POINT_COUNT, DSM_HEIGHT_COLORED, DSM_POINT_COLOR, DSM_POINT_COLOR_INTERPOLATE, DSM_BINARY_MASK, DSM_DISTANCE_MAP, DSM_POINT_MODEL_COUNT, DSM_CELL_SD и DSM_ROUGHNESS.
- meshAndTextureFormats--задает выходной формат mesh. Совместимы только определенные комбинации форматов mesh и текстуры. Ниже в таблице перечислены поддерживаемые комбинации. Форматы OSGB и S3TC используются по умолчанию.
  MeshFileFormat TextureFileFormat
  OSGB
  S3TC
  3D_TILES
  JPG и S3TC
  SLPK
  JPG, JPG и DDS
  LOD_OBJ
  JPG, PNG и DDS
  LOD_DAE
  JPG, PNG и DDS
  DAE
  JPG и PNG
  OBJ
  JPG и PNG
- 3dTilesOverImposeHeightsOnTargetEllipsoid — булево значение, которое определяет, будут ли все измерения, включая высоту, конвертированы в систему координат, используемую Cesium (WGS 84) без каких-либо изменений. Если эта опция - false, значения высот входной mesh будут интерпретированы как высоты над поверхностью эллипсоида Cesium. По умолчанию используется значение true.
- 3dTilesExportInPCS — булево значение, которое определяет, будут ли выполнены преобразования системы координат для формата 3D Tiles mesh. Если значение равно false, результаты 3D Tiles mesh будут конвертированы в систему координат WGS84 с высотами геоида EGM96. Если , преобразования системы координат не будут выполнены для формата 3D Tiles mesh, за исключением случаев, когда требуется другая система координат. Значение по умолчанию – false.
- slpkExportInPCS — булево значение, которое определяет, будут ли выполнены преобразования системы координат для формата SLPK mesh. Если значение равно false, результаты SLPK mesh будут конвертированы в систему координат WGS84 с высотами геоида EGM96. Если значение равно true, преобразования системы координат не будут выполнены для формата SLPK mesh, за исключением случаев, когда требуется другая система координат. По умолчанию используется значение true.
Значения по умолчанию для Опций реконструкции используются только для вновь созданной папки реконструкции. Если папка реконструкции существует, значения по умолчанию из существующей папки реконструкции сохраняются.

MeshFileFormat	TextureFileFormat
OSGB	S3TC
3D_TILES	JPG и S3TC
SLPK	JPG, JPG и DDS
LOD_OBJ	JPG, PNG и DDS
LOD_DAE	JPG, PNG и DDS
DAE	JPG и PNG
OBJ	JPG и PNG

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

{
    "scenario": "AERIAL_NADIR",
    "fwdOverlap": .60,
    "swdOverlap": .30,
    "quality": "HIGH",
    "products": "DSM;TRUE_ORTHO;DSM_MESH",
    "areaX": [424960.019858008, 425010.984614762],
    "areaY": [5132484.30528369, 5132517.9432181],
    "gpuStatus": True,
    "applyGlobalColorBalancing": True,
    "dsmMetaProducts": "DSM_HEIGHT_COLORED;DSM_ROUGHNESS"

}

Параметры

Подпись	Описание	Тип данных
Входной набор данных мозаики	Уравненный входной набор данных мозаики.	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

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	Уравненный входной набор данных мозаики. Если параметр recon_folder содержит существующий проект, укажите None для параметра in_mosaic_dataset.	Mosaic Dataset; Mosaic Layer
recon_folder	Папка выходного набора данных.	Folder
recon_options (Дополнительный)	Файл .json или строка JSON, которая определяет значения для параметров инструмента. Если этот параметр задан, то свойства файла .json или строки JSON будут заданы по умолчанию для оставшихся дополнительных параметров. См. раздел Использование ниже, чтобы получить список опций.	File; String
scenario (Дополнительный)	Определяет тип изображений, которые используются для создания выходных продуктов. DEFAULT—Входные снимки будут задаваться по мере получения с БПЛА или наземных камер. AERIAL_NADIR—Входные снимки будут задаваться по мере получения с больших фотограмметрических съемочных систем. AERIAL_OBLIQUE—Входные снимки будут задаваться по мере получения с перспективных съемочных систем.	String
fwd_overlap (Дополнительный)	Процент прямого перекрытия (продольное), который будет использоваться между изображениями. Значение по умолчанию равно 60. Этот параметр активен тогда, когда параметр scenario имеет значение AERIAL_NADIR.	Long
swd_overlap (Дополнительный)	Процент бокового (поперечного) перекрытия между изображениями. Значение по умолчанию равно 30. Этот параметр активен тогда, когда параметр scenario имеет значение AERIAL_NADIR.	Long
quality (Дополнительный)	Определяет качество итогового продукта. ULTRA—Входные изображения будут использовать их исходное (полное) разрешение. HIGH—Разрешение входных изображений будет снижено в два раза. MEDIUM—Разрешение входных изображений будет снижено в четыре раза. LOW—Разрешение входных изображений будет снижено в восемь раз.	String
products [products,...] (Дополнительный)	Определяет продукты, которые будут созданы. DSM—Будет создана ЦММ. Эта опция будет выбрана по умолчанию, если параметр scenario задан как AERIAL_NADIR. TRUE_ORTHO—К изображению будет применена ортотрансформация. Эта опция будет выбрана по умолчанию, если параметр scenario задан как AERIAL_NADIR. DSM_MESH—Будет создана модель mesh ЦММ. Эта опция будет выбрана по умолчанию, если параметр scenario задан как AERIAL_NADIR. POINT_CLOUD—Будет создано облако точек изображения. Эта опция будет выбрана по умолчанию, если параметр scenario задан как DEFAULT или AERIAL_OBLIQUE. MESH—Будет создана модель 3D mesh. Эта опция будет выбрана по умолчанию, если параметр scenario задан как DEFAULT или AERIAL_OBLIQUE.	String
cell_size (Дополнительный)	Размер ячейки выходного продукта.	Double; String
aoi (Дополнительный)	Область интереса, которая будет использоваться для выбора изображений для обработки. Область интересов может быть вычислена автоматически или определена с помощью входного шейп-файла. Если значение содержит 3D геометрию, то z-компонент будет проигнорирован. Если значение включает перекрывающиеся объекты, то будет вычислено объединение этих объектов. NONE—Все изображения будут использованы в обработке. AUTO—Экстент обработки будут вычислен автоматически. Это значение по умолчанию	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, "DEFAULT", 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":"DEFAULT","quality":"HIGH","products":"DSM;TRUE_ORTHO;DSM_MESH","cellSize":0.05,"correctionFeatures":"\\\\shared_location\\RMeTesting.gdb\\CorrectionFeature","meshAndTextureFormats":{"OSGB":"S3TC","SLPK":"JPG","OBJ":"JPG","LOD_DAE":"PNG"},"applyGlobalColorBalancing":true,"areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI"}')

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,	scenario, forward_overlap, side_overlap, out_quality, output_products)

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

Экстент, Тип процессора

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

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

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

Отзыв по этому разделу?

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

Лицензия:

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

Параметры

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

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

Пример кода

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

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

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

В этом разделе