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.

      MeshFileFormatTextureFileFormat

      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

EtiquetaExplicaciónTipo 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.

  • PredeterminadoLas imágenes de entrada se definirán como adquiridas con drones o cámaras terrestres.
  • Nadir aéreoLas imágenes de entrada se definirán como adquiridas con sistemas de cámaras fotogramétricas grandes.
  • Oblicuo aéreoLas 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.

  • UltraLas imágenes de entrada se utilizarán con su resolución (completa) original.
  • AltoLas imágenes de entrada se reducirán dos veces.
  • MedioLas imágenes de entrada se reducirán cuatro veces.
  • BajoLas imágenes de entrada se reducirán ocho veces.
String
Productos
(Opcional)

Especifica los productos que se generarán.

  • DSMSe generará un DSM. Esta opción se seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo.
  • Ortofoto verdaderaLas 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 DSMSe 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 puntosSe 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.
  • MallaSe 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.

  • NingunaTodas las imágenes se usarán en el procesamiento.
  • AutomáticaLa 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

EtiquetaExplicaciónTipo de datos
Carpeta de reconstrucción actualizada

La carpeta de reconstrucción de salida.

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})
NombreExplicaciónTipo 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.

  • DEFAULTLas imágenes de entrada se definirán como adquiridas con drones o cámaras terrestres.
  • AERIAL_NADIRLas imágenes de entrada se definirán como adquiridas con sistemas de cámaras fotogramétricas grandes.
  • AERIAL_OBLIQUELas 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.

  • ULTRALas imágenes de entrada se utilizarán con su resolución (completa) original.
  • HIGHLas imágenes de entrada se reducirán dos veces.
  • MEDIUMLas imágenes de entrada se reducirán cuatro veces.
  • LOWLas imágenes de entrada se reducirán ocho veces.
String
products
[products,...]
(Opcional)

Especifica los productos que se generarán.

  • DSMSe generará un DSM. Esta opción se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR.
  • TRUE_ORTHOLas 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_MESHSe generará una malla DSM. Esta opción se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR.
  • POINT_CLOUDSe 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.
  • MESHSe 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.

  • NONETodas las imágenes se usarán en el procesamiento.
  • AUTOLa 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

NombreExplicaciónTipo 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)

Información de licenciamiento

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

Temas relacionados