Agregar información de superficie (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 x,y 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 del parámetro 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 x,y 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 media de una polilínea se obtiene tomando una media ponderada de la pendiente de cada segmento de línea. La ponderación se basa en la longitud 3D de cada segmento. Esto resulta en segmentos más largos con mayor influencia en el cálculo resultante sobre segmentos más cortos.

• Utilice el parámetro 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 a la que se aplica el filtro de área.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	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
Superficie de entrada	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
Propiedad de salida	Especifica la propiedad de elevación de la superficie que se agrega a la tabla de atributos de la clase de entidad de entrada. Z—Se agregarán los valores z de superficie interpolados para la ubicación x,y de cada entidad de un solo punto. Z mínima—Se agregarán los valores z de superficie más bajos en el área definida por el polígono a lo largo de la longitud de una línea o entre los valores interpolados para los puntos de un registro multipunto. Z máxima—Se agregará la elevación de superficie más alta en el área definida por el polígono a lo largo de la longitud de una línea o entre los valores interpolados para los puntos de un registro multipunto. Z Media—Se agregará la elevación de superficie promedio del área definida por el polígono a lo largo de la longitud de una línea o entre los valores interpolados para los puntos de un registro multipunto. Área de superficie—Se agregará el área de la superficie 3D de la región definida por cada polígono. Longitud en superficie—Se agregará la distancia 3D de la línea a lo largo de la superficie. Pendiente mínima—Se agregará el valor de la pendiente más cercano a cero a lo largo de la línea o dentro del área definida por el polígono. Pendiente máxima—Se agregará el valor de la pendiente más alto a lo largo de la línea o dentro del área definida por el polígono. Pendiente media—Se agregará el valor de la pendiente promedio a lo largo de la línea o dentro del área definida por el polígono.	String
Método (Opcional)	Especifica el método de interpolación que se utilizará para determinar la información acerca de la superficie. Bilineal—Se utilizará el método de interpolación exclusivo para la superficie ráster que determina los valores de celda a partir de las cuatro celdas más cercanas. Esta es la única opción disponible para una superficie de ráster. Lineal—La elevación se obtendrá del plano definido por el triángulo que contiene la ubicación x,y de un punto de consulta. Este es el método de interpolación predeterminado para las TIN, los terrenos y los datasets LAS. Vecinos naturales—La elevación se obtendrá aplicando pesos basados en áreas a los vecinos naturales del terreno de un punto de consulta. Componer Z mínimo—La elevación se obtendrá del valor z más bajo que se encuentra entre los vecinos naturales de un punto de consulta. Componer Z máximo—La elevación se obtendrá del valor z más grande entre los vecinos naturales del terreno de un punto de consulta. Componer Z más cercana—La elevación se obtendrá del valor más cercano entre los vecinos naturales del terreno de un punto de consulta. Componer z más cercano al valor medio—La elevación se obtendrá del valor z que está más cerca al promedio de todos los vecinos naturales de un punto de consulta.	String
Distancia de Muestra (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
Factor Z (Opcional)	El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.	Double
Resolución de nivel de pirámide (Opcional)	La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.	Double
Filtrado de ruido (Opcional)	Especifica si se impide que las porciones de superficie que pueden estar caracterizadas por mediciones anómalas contribuyan a los cálculos de pendiente. Las demás propiedades no se ven afectadas por este parámetro. Las entidades de línea ofrecen un filtro de longitud, en el cual los segmentos de línea cuyas longitudes 3D sean más cortas que el valor especificado se excluyen de los cálculos de la pendiente. Las entidades de polígono ofrecen un filtro de área, en el cual se excluyen los polígonos que cubren una superficie menor que el valor especificado.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de entrada actualizadas	Las entidades de entrada actualizadas.	Feature Layer

Python

AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})

Nombre	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,...]	Especifica la propiedad de elevación de la superficie que se agrega a la tabla de atributos de la clase de entidad de entrada. Z—Se agregarán los valores z de superficie interpolados para la ubicación x,y de cada entidad de un solo punto. Z_MIN—Se agregarán los valores z de superficie más bajos en el área definida por el polígono a lo largo de la longitud de una línea o entre los valores interpolados para los puntos de un registro multipunto. Z_MAX—Se agregará la elevación de superficie más alta en el área definida por el polígono a lo largo de la longitud de una línea o entre los valores interpolados para los puntos de un registro multipunto. Z_MEAN—Se agregará la elevación de superficie promedio del área definida por el polígono a lo largo de la longitud de una línea o entre los valores interpolados para los puntos de un registro multipunto. SURFACE_AREA—Se agregará el área de la superficie 3D de la región definida por cada polígono. SURFACE_LENGTH—Se agregará la distancia 3D de la línea a lo largo de la superficie. MIN_SLOPE—Se agregará el valor de la pendiente más cercano a cero a lo largo de la línea o dentro del área definida por el polígono. MAX_SLOPE—Se agregará el valor de la pendiente más alto a lo largo de la línea o dentro del área definida por el polígono. AVG_SLOPE—Se agregará el valor de la pendiente promedio a lo largo de la línea o dentro del área definida por el polígono.	String
method (Opcional)	Especifica el método de interpolación que se utilizará para determinar la información acerca de la superficie. BILINEAR—Se utilizará el método de interpolación exclusivo para la superficie ráster que determina los valores de celda a partir de las cuatro celdas más cercanas. Esta es la única opción disponible para una superficie de ráster. LINEAR—La elevación se obtendrá del plano definido por el triángulo que contiene la ubicación x,y de un punto de consulta. Este es el método de interpolación predeterminado para las TIN, los terrenos y los datasets LAS. NATURAL_NEIGHBORS—La elevación se obtendrá aplicando pesos basados en áreas a los vecinos naturales del terreno de un punto de consulta. CONFLATE_ZMIN—La elevación se obtendrá del valor z más bajo que se encuentra entre los vecinos naturales de un punto de consulta. CONFLATE_ZMAX—La elevación se obtendrá del valor z más grande entre los vecinos naturales del terreno de un punto de consulta. CONFLATE_NEAREST—La elevación se obtendrá del valor más cercano entre los vecinos naturales del terreno de un punto de consulta. CONFLATE_CLOSEST_TO_MEAN—La elevación se obtendrá del valor z que está más cerca al promedio de todos los vecinos naturales de un punto de consulta.	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. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible 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 se utilizará. El valor predeterminado es 0, o resolución completa.	Double
noise_filtering (Opcional)	Especifica si se impide que las porciones de superficie que pueden estar caracterizadas por mediciones anómalas contribuyan a los cálculos de pendiente. Las demás propiedades no se ven afectadas por este parámetro. Las entidades de línea ofrecen un filtro de longitud, en el cual los segmentos de línea cuyas longitudes 3D sean más cortas que el valor especificado se excluyen de los cálculos de la pendiente. Las entidades de polígono ofrecen un filtro de área, en el cual se excluyen los polígonos que cubren una superficie menor que el valor especificado.	String

Salida derivada

Nombre	Explicación	Tipo de datos
output_feature_class	Las entidades de entrada actualizadas.	Feature Layer

Muestra de código

Ejemplo 1 de AddSurfaceInformation (ventana de Python)

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")

Ejemplo 2 de AddSurfaceInformation (script independiente)

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)

Entornos

Espacio de trabajo actual, Extensión, Transformaciones geográficas, Auto ejecución

Casos especiales

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