Reconstruir superficie (Administración de datos)

Disponible con una licencia Advanced.

Resumen

Genera ortofotos de DSM, mallas 2.5D, mallas 3D y nubes de puntos a partir de imágenes ajustadas.

Licencia:

La herramienta Reconstruir superficie solo está disponible a través de una versión de prueba beta limitada y solo por invitación.

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 Ajuste 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.
  • applyGlobalColorBalancing: un valor booleano que especifica si se aplicará balance de color.
  • orthoEnhanceTexture: un valor booleano que especifica si las texturas se mejorarán para los productos de ortofotos de DSM.
  • meshEnahnceTexture: un valor booleano que especifica si las texturas se mejorarán para los productos de malla.
  • force8BitColor: un valor booleano que especifica si se utilizará el color de 8 bits independientemente de la entrada.
  • 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.
  • exportImagePyramidsInTIFFs: un valor booleano que especifica si se exportarán pirámides de imagen en archivos .tiff.
  • 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
    CESIUM	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

  • cesiumOverImposeHeightsOnTargetEllipsoid: 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 False, los valores de altura de la malla de entrada se interpretarán como alturas por encima del elipsoide de Cesium.
  • cesiumDracoCompression: un valor booleano que especifica si se reducirá el tamaño de la malla para mejorar el rendimiento.
  • slpkExportInPCS: un valor booleano que especifica si se llevará a cabo una transformación del sistema de coordenadas para el formato de malla SLPK. De forma predeterminada, SURE convertirá los resultados de la malla SLPK al sistema de coordenadas WGS 84 con alturas de geoide EGM96. Si está en True, no se llevará a cabo ninguna transformación del sistema de coordenadas para el formato de malla SLPK, excepto cuando se requiera un sistema de coordenadas diferente. Cuando esta opción está en True, se deben definir los WKID para los sistemas de coordenadas horizontales y verticales, el modelo de altura y la unidad de altura.

• 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.	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 modelo digital de superficie (DSM). Este producto se seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo. Orto verdadero—Las imágenes se ortorrectificarán. Este producto se seleccionará de forma predeterminada cuando el parámetro Escenario se haya definido como Nadir aéreo. Malla DSM—Se generará una malla DSM. Este producto 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. Este producto 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. Este producto 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 Class; 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 un shapefile 3D.	Feature Class; 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 un shapefile 3D.	Feature Class; 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.management.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.	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 modelo digital de superficie (DSM). Este producto se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR. TRUE_ORTHO—Las imágenes se ortorrectificarán. Este producto se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como AERIAL_NADIR. DSM_MESH—Se generará una malla DSM. Este producto 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. Este producto se seleccionará de forma predeterminada cuando el parámetro scenario se haya definido como DEFAULT o AERIAL_OBLIQUE. MESH—Se generará una malla 3D. Este producto 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 Class; 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 un shapefile 3D.	Feature Class; 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 un shapefile 3D.	Feature Class; 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 una malla 3D a partir de ortoimágenes.

# Import system modules
import arcpy

3d_surface = arcpy.management.ReconstructSurface(r"C:\SURE.gdb\droneMD", r"C:\RS_output", None, "DEFAULT", 
	   None, None, "HIGH", "TRUE_ORTHO", 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 un DSM, una malla DSM y un Orto verdadero a partir de ortoimágenes

# Import system modules
import arcpy

surface = arcpy.management.ReconstructSurface(r"C:\SURE.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,"meshEnhanceTexture":true,"areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI"}')

Ejemplo 3 de ReconstructSurface (script independiente)

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

# Import system modules
import arcpy


# Define input parameters
in_mosaic = "C:/SURE.gdb/farm"
out_folder = "C:/ScenarioNadir"
json_file = ""
scenario = "AERIAL_NADIR"
forward_overlap = 60
side_overlap = 30
out_quality = "ULTRA"
output_products = "DSM;TRUE_ORTHO;DSM_MESH"

#Execute - Generate Products
surface = arcpy.management.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 Representación cartográfica de realidad
• Advanced: Requiere Representación cartográfica de realidad