Actualizar entidad Z (3D Analyst)

Resumen

Actualiza las coordenadas Z de los vértices de entidad 3D usando una superficie.

Uso

• Solo se actualizarán los vértices de las entidades que se superpongan totalmente con la superficie de entrada. Las entidades que no se superponen con la superficie se omitirán.

  Nota:

  Si el valor z obtenido para un vértice dado está fuera del dominio z de la referencia espacial de una entidad de una geodatabase, el valor z del vértice no se actualizará. Cree una copia de las entidades de entrada y especifique un dominio z apropiado para procesar las entidades afectadas.

Sintaxis

arcpy.3d.UpdateFeatureZ(in_features, in_surface, {method}, {status_field})

Parámetro	Explicación	Tipo de datos
in_features	Las entidades 3D cuyos valores z de vértices se modificarán.	Feature Layer
in_surface	La superficie que se utilizará para determinar el nuevo valor z para los vértices de entidades 3D.	LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer
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: BILINEAR —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 — Método de interpolación predeterminado para un dataset TIN, de terreno y LAS. Obtiene la elevación a partir del plano definido por el triángulo que contiene la ubicación XY del punto de consulta. NATURAL_NEIGHBORS — Obtiene la elevación al aplicar los pesos basadas en el área a los vecinos naturales del terreno de un punto de consulta. CONFLATE_ZMIN — Obtiene la elevación del valor z más bajo que se encuentra entre los vecinos naturales de un punto de consulta. CONFLATE_ZMAX — Obtiene la elevación del valor z más alto que se encuentra entre los vecinos naturales de un punto de consulta. CONFLATE_NEAREST — Obtiene la elevación del valor más cercano entre los vecinos naturales del terreno de un punto de consulta. CONFLATE_CLOSEST_TO_MEAN — Obtiene la elevación del valor z que está más cerca del promedio de todos los vecinos naturales de un punto de consulta.	String
status_field (Opcional)	Campo numérico existente que se rellenará con valores para reflejar si los vértices de la entidad se han actualizado correctamente. Se especificará un valor 1 para las entidades actualizadas y 0 para las entidades que no se han actualizado. Las entidades que se superponen parcialmente con la superficie no se actualizarán.	Field

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	Las entidades 3D actualizadas cuyos valores z de vértices se han modificado.	Capa de entidades

Muestra de código

Ejemplo 1 de UpdateFeatureZ (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.UpdateFeatureZ_3d('lines_3d.shp', 'dsm.tif', status_field='Updated')

Ejemplo 2 de UpdateFeatureZ (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

'''****************************************************************************
       Name: Update Antenna Positions
Description: Updates antenna positions based on elevations from a surface.
****************************************************************************'''
# Import system modules
import arcpy

in_fc = arcpy.GetParameterAsText(1) # pt features representing antenna locations
surface = arcpy.GetParameterAsText(2) # surface used to modify feature Z values


try:
    if arcpy.Describe(surface).dataType in ('Raster', 'RasterLayer'):
        method = 'BILINEAR'
    else:
        method = 'CONFLATE_ZMAX'
    arcpy.ddd.UpdateFeatureZ(in_fc, surface, method)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

Entornos

Espacio de trabajo actual, Extensión

Información de licenciamiento

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