Diferencia de superficie (3D Analyst)

Resumen

Calcula el desplazamiento entre dos superficies para determinar si una de ellas está por encima, por debajo o al mismo nivel que la otra superficie.

Obtenga más información acerca de cómo funciona Diferencia de superficie

Uso

  • La salida solo representa las partes de las superficies de entrada que se superponen.

  • Considere la opción de generar un ráster de salida o TIN para evaluar la diferencia Z entre la entrada y la superficie de referencia.

  • Es mejor si los sistemas de coordenadas horizontales y verticales de las superficies de entrada son el mismo.

  • La clase de entidad de salida tendrá entidades poligonales que separan las regiones de la superficie de entrada según si están por encima, por debajo o al mismo nivel que el plano de referencia. La tabla de atributos de la entidad contendrá los campos siguientes:

    • Volume: el volumen de espacio entre la entrada y la superficie de referencia que está limitada por el polígono. El volumen siempre será 0 para áreas donde las dos superficies sean iguales.
    • SArea: el área de superficie de la superficie de entrada que está delimitada por el polígono.
    • Code: un valor numérico que describe la relación espacial de la superficie con el plano de referencia. -1 indica que la superficie está bajo el plano de referencia, 0 indica que la superficie es la misma que el plano de referencia y 1 indica que la superficie está sobre el plano de referencia.

Parámetros

EtiquetaExplicaciónTipo de datos
Superficie de entrada

La superficie triangulada cuyo desplazamiento relativo se evalúa respecto a la superficie de referencia.

LAS Dataset Layer; Terrain Layer; TIN Layer
Superficie de referencia

La superficie triangulada que se utilizará como línea base para determinar el desplazamiento relativo de la superficie de entrada.

LAS Dataset Layer; Terrain Layer; TIN Layer
Clase de entidad de salida

La clase de entidad de salida que contiene triángulos contiguos, y partes de triángulos, que tienen la misma clasificación agrupada en polígonos. El volumen encerrado por cada región de diferencia se enumera en la tabla de atributos.

Feature Class
Resolución de análisis
(Opcional)

La resolución que se utilizará para generar la superficie de entrada. En un dataset de terreno, se corresponderá con sus definiciones en el nivel de pirámide, donde el valor predeterminado de 0 representa la resolución completa. En el caso de un dataset LAS, este valor representa la longitud de cada lado del área cuadrada que se utilizará para simplificar las devoluciones de puntos LAS.

Double
Resolución de análisis de referencia
(Opcional)

La resolución que se utilizará para generar la superficie de referencia. En un dataset de terreno, se corresponderá con sus definiciones en el nivel de pirámide, donde el valor predeterminado de 0 representa la resolución completa. En el caso de un dataset LAS, este valor representa la longitud de cada lado del área cuadrada que se utilizará para filtrar las devoluciones de puntos LAS.

Double
Ráster de salida
(Opcional)

La superficie de ráster de salida cuyos valores representan la superficie de entrada normalizada según la superficie de referencia. Los valores positivos reflejan las áreas en las que la superficie de entrada está por encima de la superficie de referencia, mientras que los valores negativos reflejan las áreas donde la superficie de entrada está por debajo de la superficie de referencia. Los valores de ráster proceden de un TIN mediante la interpolación lineal.

Raster Dataset
Tamaño de celda ráster
(Opcional)

El tamaño de celda del ráster de salida.

Double
Carpeta de TIN de salida
(Opcional)

La ubicación de carpeta para almacenar las superficies de TIN cuyos valores representan la diferencia entre la superficie de entrada y de referencia.

Folder
Nombre de base de TIN de salida
(Opcional)

El nombre base dado a cada superficie de TIN de salida. Si un dataset de TIN no es suficiente para representar los datos, varias TIN se crearán con el mismo nombre base.

String
Método de simplificación LAS

El método utilizado para seleccionar un punto LAS de cada ventana de análisis al aplicar una resolución de análisis para simplificar la superficie del dataset LAS de entrada. Los puntos resultantes se utilizarán para construir una superficie triangulada.

  • Más cercano a la mediaSe utilizará el punto LAS cuyo valor sea más cercano a la media de todos los puntos LAS de la ventana de análisis. Esta es la opción predeterminada.
  • MínimoEl punto LAS con el valor z más pequeño de entre todos los puntos LAS de la ventana de análisis.
  • MáximoEl punto LAS con el valor z más alto de entre todos los puntos LAS de la ventana de análisis.
String
Método de simplificación LAS de referencia

El método utilizado para seleccionar un punto LAS de cada ventana de análisis al aplicar una resolución de análisis para simplificar la superficie del dataset LAS de entrada. Los puntos resultantes se utilizarán para construir una superficie triangulada.

  • Más cercano a la mediaSe utilizará el punto LAS cuyo valor sea más cercano a la media de todos los puntos LAS de la ventana de análisis. Esta es la opción predeterminada.
  • MínimoEl punto LAS con el valor z más pequeño de entre todos los puntos LAS de la ventana de análisis.
  • MáximoEl punto LAS con el valor z más alto de entre todos los puntos LAS de la ventana de análisis.
String
Extensión de procesamiento
(Opcional)

La extensión de los datos que se evaluarán.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de dibujo Cuadrar y terminar: la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.
    Nota:

    Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

    Nota:

    Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.

    Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasÁrea de entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Área de entidades seleccionadas y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Intersección de entradas Intersección: la extensión se basará en la extensión mínima o en común de todas las entradas. Si ninguna de las entradas se solapa, podría generarse una extensión nula con todos los valores igual a cero.
  • Combinación de entradas Combinación: la extensión se basa en la extensión máxima o combinada de todas las entradas.
  • Portapapeles Pegar: la extensión puede copiarse en y desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Pegar extensión Pegar: pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
    Nota:

    Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.
    Precaución:

    El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent
Límite de procesamiento

Una entidad poligonal que definirá el área de interés que se va a procesar.

Feature Layer

arcpy.ddd.SurfaceDifference(in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {out_raster}, {raster_cell_size}, {out_tin_folder}, {out_tin_basename}, method, reference_method, {extent}, boundary)
NombreExplicaciónTipo de datos
in_surface

La superficie triangulada cuyo desplazamiento relativo se evalúa respecto a la superficie de referencia.

LAS Dataset Layer; Terrain Layer; TIN Layer
in_reference_surface

La superficie triangulada que se utilizará como línea base para determinar el desplazamiento relativo de la superficie de entrada.

LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class

La clase de entidad de salida que contiene triángulos contiguos, y partes de triángulos, que tienen la misma clasificación agrupada en polígonos. El volumen encerrado por cada región de diferencia se enumera en la tabla de atributos.

Feature Class
pyramid_level_resolution
(Opcional)

La resolución que se utilizará para generar la superficie de entrada. En un dataset de terreno, se corresponderá con sus definiciones en el nivel de pirámide, donde el valor predeterminado de 0 representa la resolución completa. En el caso de un dataset LAS, este valor representa la longitud de cada lado del área cuadrada que se utilizará para simplificar las devoluciones de puntos LAS.

Double
reference_pyramid_level_resolution
(Opcional)

La resolución que se utilizará para generar la superficie de referencia. En un dataset de terreno, se corresponderá con sus definiciones en el nivel de pirámide, donde el valor predeterminado de 0 representa la resolución completa. En el caso de un dataset LAS, este valor representa la longitud de cada lado del área cuadrada que se utilizará para filtrar las devoluciones de puntos LAS.

Double
out_raster
(Opcional)

La superficie de ráster de salida cuyos valores representan la superficie de entrada normalizada según la superficie de referencia. Los valores positivos reflejan las áreas en las que la superficie de entrada está por encima de la superficie de referencia, mientras que los valores negativos reflejan las áreas donde la superficie de entrada está por debajo de la superficie de referencia. Los valores de ráster proceden de un TIN mediante la interpolación lineal.

Raster Dataset
raster_cell_size
(Opcional)

El tamaño de celda del ráster de salida.

Double
out_tin_folder
(Opcional)

La ubicación de carpeta para almacenar las superficies de TIN cuyos valores representan la diferencia entre la superficie de entrada y de referencia.

Folder
out_tin_basename
(Opcional)

El nombre base dado a cada superficie de TIN de salida. Si un dataset de TIN no es suficiente para representar los datos, varias TIN se crearán con el mismo nombre base.

String
method

El método utilizado para seleccionar un punto LAS de cada ventana de análisis al aplicar una resolución de análisis para simplificar la superficie del dataset LAS de entrada. Los puntos resultantes se utilizarán para construir una superficie triangulada.

  • CLOSEST_TO_MEANSe utilizará el punto LAS cuyo valor sea más cercano a la media de todos los puntos LAS de la ventana de análisis. Esta es la opción predeterminada.
  • MINEl punto LAS con el valor z más pequeño de entre todos los puntos LAS de la ventana de análisis.
  • MAXEl punto LAS con el valor z más alto de entre todos los puntos LAS de la ventana de análisis.
String
reference_method

El método utilizado para seleccionar un punto LAS de cada ventana de análisis al aplicar una resolución de análisis para simplificar la superficie del dataset LAS de entrada. Los puntos resultantes se utilizarán para construir una superficie triangulada.

  • CLOSEST_TO_MEANSe utilizará el punto LAS cuyo valor sea más cercano a la media de todos los puntos LAS de la ventana de análisis. Esta es la opción predeterminada.
  • MINEl punto LAS con el valor z más pequeño de entre todos los puntos LAS de la ventana de análisis.
  • MAXEl punto LAS con el valor z más alto de entre todos los puntos LAS de la ventana de análisis.
String
extent
(Opcional)

La extensión de los datos que se evaluarán.

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent
boundary

Una entidad poligonal que definirá el área de interés que se va a procesar.

Feature Layer

Muestra de código

Ejemplo 1 de SurfaceDifference (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceDifference("sample.gdb/lidar/terrain", "flood_tin", "surface_diff.shp")
Ejemplo 2 de SurfaceDifference (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

'''****************************************************************************
Name: SurfaceDifference Example
Description: This script demonstrates how to use the
             SurfaceDifference tool.
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
inSurface = "flood_tin"
inReference = "elev_tin"

# Ensure output name is unique
outPoly = arcpy.CreateUniqueName("difference.shp")

# Execute SurfaceDifference
arcpy.ddd.SurfaceDifference(inSurface, inReference, outPoly)

Información de licenciamiento

  • Basic: Requiere 3D Analyst
  • Standard: Requiere 3D Analyst
  • Advanced: Requiere 3D Analyst

Temas relacionados