Reconstruir superficie (Representación cartográfica de realidad)

Disponible con una licencia Advanced.

Disponible para una organización de ArcGIS con la licencia de ArcGIS Reality.

Resumen

Genera un modelo digital de superficie (DSM), ortofotos verdaderas, mallas de DSM, mallas 3D y nubes de puntos a partir de imágenes ajustadas.

Uso

• El valor del parámetro Dataset de mosaico de entrada se debe preajustar. Para obtener más información sobre el ajuste de bloques en la representación cartográfica de ortofotos, consulte la herramienta Calcular ajustes de bloques.

• Cuando se ejecute la herramienta, se creará un archivo reality.json en el valor del parámetro Carpeta de reconstrucción. Si la herramienta se ejecuta de nuevo utilizando el mismo valor de Carpeta de reconstrucción, la presencia del archivo reality.json determinará los parámetros Escenario, Calidad, Entidades de masa de agua y Entidades de corrección según los valores de los parámetros de la ejecución anterior. Para generar productos adicionales para el mismo proyecto, vuelva a ejecutar la herramienta.

  Nota:

  Para restablecer los valores utilizados para los parámetros Entidades de masa de agua y Entidades de corrección, establezca los valores de dichos parámetros en NONE.

• Si hay cambios en el dataset de mosaico de entrada, especifique una carpeta diferente para el valor Carpeta de reconstrucción. Para generar productos que reflejen cambios en el dataset de mosaico, proporcione esta nueva ubicación y vuelva a ejecutar la herramienta.

• Utilice el parámetro Área de interés para acelerar el procesamiento y generar productos para un subconjunto de imágenes del dataset de mosaico de entrada.

• Si se especifica el parámetro Opciones de reconstrucción, las propiedades del archivo .json o la cadena de caracteres JSON definirán los valores predeterminados para el resto de parámetros opcionales.

  Nota:

  Si se establece la misma propiedad utilizando el parámetro Opciones de reconstrucción y un parámetro opcional restante, el valor del parámetro opcional sobrescribirá el valor Opciones de reconstrucción.

  La siguiente lista define las palabras clave utilizadas por el parámetro Opciones de reconstrucción como un archivo .json o una cadena de caracteres JSON:

  • scenario: especifica el tipo de imágenes que se utilizarán para generar los productos de salida.
  • fwdOverlap: porcentaje de superposición hacia delante (longitudinal) entre las imágenes. Esta palabra clave se utiliza cuando scenario está establecido como AERIAL_NADIR.
  • swdOverlap: porcentaje de superposición hacia los lados (transversal) entre las imágenes. Esta palabra clave se utiliza cuando scenario está establecido como AERIAL_NADIR.
  • quality: especifica la calidad de imagen del producto final.
  • products: especifica los productos que se generarán.
  • tileSize: tamaño de tesela. Los valores pueden ser AUTO o de tipo doble.
  • cellSize: el tamaño de celda del producto del ráster de salida. Este valor se estima automáticamente, pero se puede definir manualmente. Los valores pueden ser AUTO o de tipo doble.
  • tilingOrigin: las coordenadas de mapa del origen del teselado. Por ejemplo, "tilingOrigin": [0, 0]
  • areaFeatures: el área de interés.
  • waterbodyFeatures: un polígono que define la extensión de grandes masas de agua.
  • correctionFeatures: un polígono que define la extensión de todas las superficies que no son masas de agua.
  • dsmMetaProducts: especifica los productos de información de metadatos de DSM que deberán incluirse en la salida. Los valores pueden ser cualquier combinación de DSM_BINARY_MASK, DSM_DISTANCE_MAP y DSM_POINT_MODEL_COUNT.
  • meshFormats: especifica el formato de salida de la malla. Los valores válidos son SLPK, OBJ y 3D_TILES, por ejemplo, "meshFormats": "SLPK;OBJ;3D_TILES". El valor predeterminado es SLPK.
  • processingFolder: la ubicación de procesamiento en el almacenamiento local El valor predeterminado es la carpeta temporal local. El contenido generado se eliminará una vez completado el procesamiento.
  • resultsFolder: la ubicación de salida de los resultados de procesamiento. El valor predeterminado es la carpeta de reconstrucción.

• A continuación, se muestra un ejemplo del valor del parámetro Opciones de reconstrucción especificado como 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"
  }

Heredado:

En ArcGIS Pro 3.2, la opción Predeterminada del parámetro Escenario se reemplazó por la opción Dron. Además, las siguientes opciones de parámetros han quedado obsoletas:

• Parámetro Calidad: las opciones Media y Baja han quedado obsoletas.
• Parámetro Área de interés: la opción Auto ha quedado obsoleta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Dataset de mosaico de entrada	El dataset de mosaico de entrada ajustado.	Mosaic Dataset; Mosaic Layer
Carpeta de reconstrucción	La carpeta del dataset de salida.	Folder
Opciones de reconstrucción (Opcional)	Un archivo .json o una cadena JSON que especifica los valores de los parámetros de la herramienta. Si se proporciona este valor de parámetro, las propiedades del archivo .json o la cadena de caracteres JSON definirán los valores predeterminados para el resto de parámetros opcionales. Consulte la sección Usos para ver una lista de opciones.	File; String
Escenario (Opcional)	Especifica el tipo de imágenes que se utilizarán para generar los productos de salida. Dron—Las imágenes de entrada se definirán como adquiridas con drones o cámaras terrestres. Nadir aéreo—Las imágenes de entrada se definirán como adquiridas con sistemas de cámaras fotogramétricas grandes. Oblicuo aéreo—Las imágenes de entrada se definirán como adquiridas con sistemas de cámaras oblicuas. Satélite—Las imágenes de entrada se definirán como adquiridas con un satélite.	String
Superposición hacia delante (Opcional)	El porcentaje de superposición hacia delante (longitudinal) que se utilizará entre las imágenes. El valor predeterminado es 60. Este parámetro se activa cuando el parámetro Escenario está establecido como Nadir aéreo.	Long
Solapamiento lateral (Opcional)	El porcentaje de superposición hacia los lados (transversal) que se utilizará entre las imágenes. El valor predeterminado es 30. Este parámetro se activa cuando el parámetro Escenario está establecido como Nadir aéreo.	Long
Calidad (Opcional)	Especifica la calidad de imagen del producto final. Ultra—Se utilizará el mayor nivel de nube de puntos de densidad. Las imágenes de entrada se utilizarán con su resolución (completa) original. Alto—Se utilizará el nivel alto de nube de puntos de densidad. Las imágenes de entrada se reducirán dos veces.	String
Productos (Opcional)	Especifica los productos que se generarán. DSM—Se generará un DSM. Esta opción se especificará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo o Satélite. Ortofoto verdadera—Las imágenes se ortorrectificarán. Esta opción se especificará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo. Malla DSM—Se generará una malla DSM. Esta opción se especificará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo o Satélite. Nube de puntos—Se generará una nube de puntos de imagen. Esta opción se especificará de forma predeterminada cuando el parámetro Escenario se haya definido como Dron o Aéreo oblicuo. Malla—Se generará una malla 3D. Esta opción se especificará de forma predeterminada cuando el parámetro Escenario se haya definido como Dron o Aéreo oblicuo.	String
Tamaño de celda (Opcional)	El tamaño de celda del producto de salida.	Double; String
Área de interés (Opcional)	El área de interés que se utilizará para seleccionar imágenes para el procesamiento. El área de interés se puede calcular automáticamente o definir utilizando un polígono de entrada. Si el valor contiene geometrías 3D, se ignorará el componente z. Si el valor incluye entidades superpuestas, se calculará la combinación de estas entidades.	Feature Layer; File; String
Entidades de masa de agua (Opcional)	Un polígono que definirá la extensión de grandes masas de agua. El valor debe ser una entidad 3D.	Feature Layer; File; String
Entidades de corrección (Opcional)	Un polígono que definirá la extensión de todas las superficies que no son masas de agua. El valor debe ser una entidad 3D.	Feature Layer; File; String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Carpeta de reconstrucción actualizada	La carpeta de reconstrucción de salida.	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})

Nombre	Explicación	Tipo de datos
in_mosaic_dataset	El dataset de mosaico de entrada ajustado.	Mosaic Dataset; Mosaic Layer
recon_folder	La carpeta del dataset de salida.	Folder
recon_options (Opcional)	Un archivo .json o una cadena JSON que especifica los valores de los parámetros de la herramienta. Si se proporciona este valor de parámetro, las propiedades del archivo .json o la cadena de caracteres JSON definirán los valores predeterminados para el resto de parámetros opcionales. Consulte la sección Usos para ver una lista de opciones.	File; String
scenario (Opcional)	Especifica el tipo de imágenes que se utilizarán para generar los productos de salida. DRONE—Las imágenes de entrada se definirán como adquiridas con drones o cámaras terrestres. AERIAL_NADIR—Las imágenes de entrada se definirán como adquiridas con sistemas de cámaras fotogramétricas grandes. AERIAL_OBLIQUE—Las imágenes de entrada se definirán como adquiridas con sistemas de cámaras oblicuas. SATELLITE—Las imágenes de entrada se definirán como adquiridas con un satélite.	String
fwd_overlap (Opcional)	El porcentaje de superposición hacia delante (longitudinal) que se utilizará entre las imágenes. El valor predeterminado es 60. Este parámetro está habilitado cuando el parámetro scenario tiene el valor AERIAL_NADIR.	Long
swd_overlap (Opcional)	El porcentaje de superposición hacia los lados (transversal) que se utilizará entre las imágenes. El valor predeterminado es 30. Este parámetro está habilitado cuando el parámetro scenario tiene el valor AERIAL_NADIR.	Long
quality (Opcional)	Especifica la calidad de imagen del producto final. ULTRA—Se utilizará el mayor nivel de nube de puntos de densidad. Las imágenes de entrada se utilizarán con su resolución (completa) original. HIGH—Se utilizará el nivel alto de nube de puntos de densidad. Las imágenes de entrada se reducirán dos veces.	String
products [products,...] (Opcional)	Especifica los productos que se generarán. DSM—Se generará un DSM. Esta opción se especificará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR o SATELLITE. TRUE_ORTHO—Las imágenes se ortorrectificarán. Esta opción se especificará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR. DSM_MESH—Se generará una malla DSM. Esta opción se especificará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR o SATELLITE. POINT_CLOUD—Se generará una nube de puntos de imagen. Esta opción se especificará de forma predeterminada cuando el parámetro scenario se haya definido como DRONE o AERIAL_OBLIQUE. MESH—Se generará una malla 3D. Esta opción se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como DRONE o AERIAL_OBLIQUE.	String
cell_size (Opcional)	El tamaño de celda del producto de salida.	Double; String
aoi (Opcional)	El área de interés que se utilizará para seleccionar imágenes para el procesamiento. El área de interés se puede calcular automáticamente o definir utilizando un polígono de entrada. Si el valor contiene geometrías 3D, se ignorará el componente z. Si el valor incluye entidades superpuestas, se calculará la combinación de estas entidades.	Feature Layer; File; String
waterbody_features (Opcional)	Un polígono que definirá la extensión de grandes masas de agua. El valor debe ser una entidad 3D.	Feature Layer; File; String
correction_features (Opcional)	Un polígono que definirá la extensión de todas las superficies que no son masas de agua. El valor debe ser una entidad 3D.	Feature Layer; File; String

Salida derivada

Nombre	Explicación	Tipo de datos
derived_recon_folder	La carpeta de reconstrucción de salida.	Folder

Muestra de código

Ejemplo 1 de ReconstructSurface (ventana de PythonPython)

Este ejemplo crea productos 3D a partir de un dataset de mosaico ajustado.

# 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")

Ejemplo 2 de ReconstructSurface (ventana de PythonPython)

Este ejemplo crea productos DSM, mall DSM y true ortho utilizando una cadena 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"}')

Ejemplo 3 de ReconstructSurface (script independiente)

En este ejemplo se crean varios productos 2D a partir de imágenes de nadir aéreo.

#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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: No
• Standard: Requiere ArcGIS Reality for ArcGIS Pro
• Advanced: Requiere ArcGIS Reality for ArcGIS Pro