Disponible con una licencia de 3D Analyst.
Disponible con una licencia de Spatial Analyst.
Resumen
Entidades de atributo con información espacial derivada de una superficie.
Uso
Los valores Z de las entidades 3D se ignoran. Cada entidad resumirá las propiedades Z de la superficie que se interseca con su geometría. Los puntos derivan los valores Z de la ubicación XY de la superficie, las líneas adquieren las propiedades Z mediante la interpolación de las mediciones de la superficie a lo largo de su longitud y los polígonos resumen las propiedades Z de la superficie correspondientes a su área.
Las opciones Propiedad de salida se escriben en la tabla de atributos de la entidad de entrada. Cada entidad define la ubicación de las propiedades de superficie evaluadas y el tipo de propiedad que se puede reportar depende de la geometría de la entidad:
Geometría de entidad Propiedades de superficie Punto
Elevación puntual interpolada desde las coordenadas XY del punto en la superficie.
Multipunto
Valor mínimo, máximo y medio de la elevación puntual de todos los puntos del registro multipunto.
Polilínea
Distancia 3D de la línea a lo largo de la superficie.
Valor mínimo, máximo y medio de la elevación y la pendiente de la línea a lo largo de la superficie.
Polígono
Área 3D de la superficie que se solapa con el polígono.
Valor mínimo, máximo y medio de la elevación y la pendiente de la superficie.
Los valores de pendiente se miden en unidades de porcentaje (grado) y, para las entidades de línea, se calculan en cada segmento a lo largo de la línea.
- La pendiente mínima se obtiene desde el segmento cuyo valor es más cercano a 0, o grado horizontal.
- La pendiente máxima se obtiene desde el segmento con el mayor valor calculado.
- La pendiente promedio se obtiene ponderando cada pendiente por su longitud 3D. Esto resulta en segmentos más largos con mayor influencia en el valor resultante sobre segmentos más cortos.
Considere la posibilidad de aplicar un Filtro de ruido para impedir que las porciones de superficie caracterizadas por mediciones anómalas contribuyan a los cálculos de pendiente. Las entidades de línea están segmentadas por vértices que capturan el perfil de la superficie, y filtrar estos segmentos por longitud elimina la influencia de los segmentos cortos, debidos probablemente a mediciones de superficie no deseables. Del mismo modo, el filtro de área para las entidades poligonales impide que los falsos triángulos de las superficies trianguladas contribuyan a los cálculos de pendiente. En el caso de las superficies ráster, se usa un subconjunto de centroides de celda para construir una superficie triangulada sobre la que se aplica el filtro de área.
Sintaxis
AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})
Parámetro | Explicación | Tipo de datos |
in_feature_class | Las entidades de punto, multipunto, polilínea o polígono que definen las ubicaciones para determinar una o más propiedades de superficie. | Feature Layer |
in_surface | El dataset LAS, mosaico, ráster, terreno o superficie de TIN utilizados para interpolar los valores z. | LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer |
out_property [out_property,...] | La propiedad de elevación de la superficie que se agrega a la tabla de atributos de la clase de entidad de entrada. La siguiente lista resume las palabras clave de propiedad disponibles y sus tipos de geometría compatible:
| String |
method (Opcional) | Método de interpolación que se utilizará para determinar la información acerca de la superficie. Las opciones disponibles dependen del tipo de datos de la superficie de entrada:
| String |
sample_distance (Opcional) | El espaciado en el que se interpolarán los valores z. Por defecto, el tamaño de celda ráster se utiliza cuando la superficie de entrada es un ráster, y la densificación natural de la superficie de triángulos se utiliza cuando la entrada es un dataset de TIN o de terreno. | Double |
z_factor (Opcional) | El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales Z para que coincidan con las unidades lineales XY. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro está deshabilitado si la referencia espacial de la superficie de entrada tiene un datum Z con una unidad lineal especificada. | Double |
pyramid_level_resolution (Opcional) | La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que utilizará esta herramienta. El valor predeterminado es 0, o resolución completa. | Double |
noise_filtering (Opcional) | Impide que las porciones de superficie que pueden estar caracterizadas por mediciones anómalas contribuyan a los cálculos de pendiente. Las entidades de línea ofrecen un filtro de longitud, mientras que los polígonos proporcionan un filtro de área. El valor correspondiente a las distintas opciones de filtrado se evalúa en las unidades lineales del sistema de coordenadas de la entidad. Las propiedades no relacionadas con la pendiente no se ven afectadas por este parámetro. | String |
Salida derivada
Nombre | Explicación | Tipo de datos |
output_feature_class | Las entidades de entrada actualizadas. | Capa de entidades |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
from arcpy.sa import *
AddSurfaceInformation("point.shp", "dtm_tin", "Z", "LINEAR")
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
# Name: AddSurfaceInformation_Ex_02.py
# Description: This script demonstrates how to use AddSurfaceInformation
# on a 2D point feature class in a target workspace.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"
# Set the local variables
inFeatureClass = "point.shp"
inSurface = "dtm_tin"
Prop = "Z"
method = "LINEAR"
pyramid = 5
# Execute the tool
AddSurfaceInformation(inFeatureClass, inSurface, Prop, method, 15, 1, pyramid)
Información de licenciamiento
- Basic: Requiere Spatial Analyst o 3D Analyst
- Standard: Requiere Spatial Analyst o 3D Analyst
- Advanced: Requiere Spatial Analyst o 3D Analyst