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.
- Plantéese la posibilidad de generar un ráster o TIN de salida si desea evaluar la diferencia z entre la superficie de entrada y 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:
- Volumen: el volumen de espacio entre la superficie de entrada y de referencia 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 limitada por el polígono.
- Código: valor número que indica la relación espacial de la superficie respecto al plano de referencia. -1 indica que la superficie está por debajo del plano de referencia, 0 indica que la superficie es la misma que el plano de referencia y 1 indica que la superficie está por encima del plano de referencia.
Sintaxis
SurfaceDifference_3d (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})| Parámetro | Explicación | Tipo de datos |
in_surface | La superficie TIN o de terreno cuyo desplazamiento relativo se evalúa respecto a la superficie de referencia. | Terrain Layer; TIN Layer |
in_reference_surface | La superficie TIN o de terreno que se utilizará como línea base para determinar el desplazamiento relativo de la superficie de entrada. | 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) | El nivel de pirámide de terreno que se utilizará para generar la superficie de entrada. El valor predeterminado es 0, o resolución completa. Este parámetro solo se utiliza con el dataset de terreno. | Double |
reference_pyramid_level_resolution (Opcional) | El nivel de pirámide de terreno que se utilizará para generar la superficie de referencia. El valor predeterminado es 0, o resolución completa. Este parámetro solo se utiliza con el dataset de terreno. | 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 |
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.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceDifference_3d("sample.gdb/featuredataset/terrain", "sample.gdb/featuredataset/terrain2", "surface_diff.shp")
Ejemplo 2 de SurfaceDifference (secuencia de comandos 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
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
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.SurfaceDifference_3d(inSurface, inReference, outPoly)
del arcpy, inSurface, inReference, outPoly
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere 3D Analyst
- ArcGIS Desktop Standard: Requiere 3D Analyst
- ArcGIS Desktop Advanced: Requiere 3D Analyst