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 2.5D, mallas 3D y nubes de puntos a partir de imágenes ajustadas.

Licencia:

La herramienta Reconstruir superficiesolo está disponible con una licencia de ArcGIS Reality for ArcGIS Pro, junto con una licencia Standard o Advanced de ArcGIS.

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 realidad, consulte la herramienta Calcular ajustes de bloques.

• Después de ejecutar la herramienta, se creará un archivo Project.spr dentro del valor Carpeta de reconstrucción. Si el valor Carpeta de reconstrucción se vuelve a utilizar, la presencia del archivo Project.spr hará que el parámetro Dataset de mosaico de entrada se oculte en el panel Geoprocesamiento. Esto le permite generar productos adicionales sin volver a calcular la información del mosaico de entrada, ya que esta se almacena en el archivo Project.spr. Para generar productos adicionales para el mismo proyecto, vuelva a ejecutar la herramienta.

• 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, especifique 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 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.

  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.
  • srs: el sistema de coordenadas geográficas de un proyecto en formato WKT.
  • 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.
  • cellSizeMultiplicator: un valor escalar de tamaño de celda. Este valor se estima automáticamente, pero se puede definir manualmente. Los valores pueden ser AUTO o de tipo doble.
  • areaX: las coordenadas x de la extensión de salida.
  • areaY: las coordenadas y de la extensión de salida.
  • areaZ: las coordenadas z de la extensión de salida.
  • areaFeatures: el área de interés.
  • waterbodyFeatures: un polígono que especifica la extensión de grandes masas de agua.
  • correctionFeatures: un polígono que especifica la extensión de todas las superficies que no son masas de agua.
  • gpuStatus: un valor booleano que especifica si la GPU se usará para el procesamiento. El valor predeterminado depende del valor de entorno Tipo de procesador.
  • applyGlobalColorBalancing: un valor booleano que especifica si se aplicará balance de color. El valor predeterminado es verdadero.
  • orthoEnhanceTexture: un valor booleano que especifica si las texturas se mejorarán para los productos de ortofotos de DSM. El valor predeterminado es false.
  • meshEnhanceTexture: un valor booleano que especifica si las texturas se mejorarán para los productos de malla. El valor predeterminado es verdadero.
  • colorBitDepth: un valor entero que especifica la profundidad de bit de color de los productos true ortho y DSM. Los valores válidos son 8 y 16. El valor predeterminado es 8 bits.
  • dsmDepthBuffer: un valor entero que define cuántos de los puntos más altos de una celda DSM se utilizarán para calcular el valor de altura de la celda. De forma predeterminada, este valor se determina automáticamente, pero el valor también se puede especificar manualmente.
  • exportAdditionalTFWs: un valor booleano que especifica si se exportarán archivos .tfw adicionales. El valor predeterminado es verdadero.
  • exportImagePyramidsInTIFFs: un valor booleano que especifica si se exportarán pirámides de imagen en archivos .tiff. El valor predeterminado es verdadero.
  • 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_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 y DSM_ROUGHNESS.
  • meshAndTextureFormats: especifica el formato de salida de la malla. Solo se admiten combinaciones específicas de formatos de malla y textura. En la siguiente tabla, se enumeran las combinaciones admitidas. Los formatos OSGB y S3TC se utilizan de forma predeterminada.

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

  • 3dTilesOverImposeHeightsOnTargetEllipsoid: un valor booleano que especifica si todas las dimensiones, incluida la altura, se convertirán al sistema de coordenadas utilizado por Cesium (WGS 84) sin modificaciones. Si esta opción está en falso, los valores de altura de la malla de entrada se interpretarán como alturas por encima del elipsoide de Cesium. El valor predeterminado es verdadero.
  • 3dTilesExportInPCS: un valor booleano que especifica si se realizará una transformación del sistema de coordenadas para el formato de malla Teselas 3D. Si es falso, los resultados de la malla Teselas 3D se convertirán al sistema de coordenadas WGS84 con alturas del geoide EGM96. Si es verdadero, no se realizará ninguna transformación del sistema de coordenadas para el formato de malla Teselas 3D, excepto donde se requiera un sistema de coordenadas diferente. El valor predeterminado es false.
  • slpkExportInPCS: un valor booleano que especifica si se realizará una transformación del sistema de coordenadas para el formato de malla SLPK. Si es falso, los resultados de la malla SLPK se convertirán al sistema de coordenadas WGS84 con alturas del geoide EGM96. Si es verdadero, no se realizará ninguna transformación del sistema de coordenadas para el formato de malla SLPK, excepto donde se requiera un sistema de coordenadas diferente. El valor predeterminado es verdadero.

• Los valores predeterminados para el parámetro Opciones de reconstrucción solo se usan para una carpeta de reconstrucción recién creada. Si la carpeta de reconstrucción existe, se conservan los valores predeterminados de la carpeta de reconstrucción existente.

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

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 especifica este 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 Usos que aparece anteriormente para obtener una lista de opciones.	File; String
Escenario (Opcional)	Especifica el tipo de imágenes que se utilizarán para generar los productos de salida. Predeterminado—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.	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—Las imágenes de entrada se utilizarán con su resolución (completa) original. Alto—Las imágenes de entrada se reducirán dos veces. Medio—Las imágenes de entrada se reducirán cuatro veces. Bajo—Las imágenes de entrada se reducirán ocho veces.	String
Productos (Opcional)	Especifica los productos que se generarán. DSM—Se generará un DSM. Esta opción se seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo. Ortofoto verdadera—Las imágenes se ortorrectificarán. Esta opción se seleccionará 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 seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo. Nube de puntos—Se generará una nube de puntos de imagen. Esta opción se seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Predeterminado u Oblicuo aéreo. Malla—Se generará una malla 3D. Esta opción se seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Predeterminado u Oblicuo aéreo.	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 shapefile 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. Ninguna—Todas las imágenes se usarán en el procesamiento. Automática—La extensión de procesamiento se calculará automáticamente. Esta es la opción predeterminada.	Feature Layer; File; String
Entidades de masa de agua (Opcional)	Un polígono que definirá la extensión de grandes masas de agua. Para obtener los mejores resultados, utilice 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. Si el valor del parámetro recon_folder contiene un proyecto existente, especifique None para el parámetro in_mosaic_dataset.	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 especifica este 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 Usos que aparece anteriormente para obtener una lista de opciones.	File; String
scenario (Opcional)	Especifica el tipo de imágenes que se utilizarán para generar los productos de salida. DEFAULT—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.	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—Las imágenes de entrada se utilizarán con su resolución (completa) original. HIGH—Las imágenes de entrada se reducirán dos veces. MEDIUM—Las imágenes de entrada se reducirán cuatro veces. LOW—Las imágenes de entrada se reducirán ocho veces.	String
products [products,...] (Opcional)	Especifica los productos que se generarán. DSM—Se generará un DSM. Esta opción se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR. TRUE_ORTHO—Las imágenes se ortorrectificarán. Esta opción se seleccionará 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 seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR. POINT_CLOUD—Se generará una nube de puntos de imagen. Esta opción se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como DEFAULT 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 DEFAULT 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 shapefile 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. NONE—Todas las imágenes se usarán en el procesamiento. AUTO—La extensión de procesamiento se calculará automáticamente. Esta es la opción predeterminada.	Feature Layer; File; String
waterbody_features (Opcional)	Un polígono que definirá la extensión de grandes masas de agua. Para obtener los mejores resultados, utilice 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 Python)

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, "DEFAULT", 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 Python)

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":"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"}')

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

Entornos

Extensión, Tipo de procesador

Información de licenciamiento

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