Update Feature Z (3D Analyst)—ArcGIS Pro

Summary

Updates the z-coordinates of 3D feature vertices using a surface.

Usage

Only features that entirely overlap the input surface will have their vertices updated. Features that do not overlap the surface will be skipped.
Note:
If the z-value obtained for a given vertex is outside of a geodatabase feature's spatial reference z-domain, the vertex's z-value will not be updated. Create a copy of the input features and specify an appropriate z-domain to process the affected features.

Syntax

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

Parameter	Explanation	Data Type
in_features	The 3D features whose vertex z-values will be modified.	Feature Layer
in_surface	The surface that will be used to determine the new z-value for the 3D feature vertices.	LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer
method (Optional)	Interpolation method used in determining information about the surface. The available options depend on the data type of the input surface: BILINEAR —An interpolation method exclusive to the raster surface, which determines cell values from the four nearest cells. This is the only option available for a raster surface. LINEAR — Default interpolation method for a TIN, terrain, and LAS dataset. Obtains elevation from the plane defined by the triangle that contains the XY location of a query point. NATURAL_NEIGHBORS — Obtains elevation by applying area-based weights to the natural neighbors of a query point. CONFLATE_ZMIN — Obtains elevation from the smallest z-value found among the natural neighbors of a query point. CONFLATE_ZMAX — Obtains elevation from the largest z-value found among the natural neighbors of a query point. CONFLATE_NEAREST — Obtains elevation from the nearest value among the natural neighbors of a query point. CONFLATE_CLOSEST_TO_MEAN — Obtains elevation from the z-value that is closest to the average of all the natural neighbors of a query point.	String
status_field (Optional)	An existing numeric field that will be populated with values to reflect whether the feature's vertices were successfully updated. A value of 1 would be specified for updated features and 0 for features that were not updated. Features that partially overlap the surface will not be updated.	Field

Derived Output

Name	Explanation	Data Type
out_feature_class	The updated 3D features whose vertex z-values have been modified.	Feature Layer

Code sample

UpdateFeatureZ example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window.

arcpy.env.workspace = 'C:/data'

arcpy.UpdateFeatureZ_3d('lines_3d.shp', 'dsm.tif', status_field='Updated')

UpdateFeatureZ example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script.

'''****************************************************************************
       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())

Environments

Current Workspace, Extent

Licensing information

Basic: Requires 3D Analyst
Standard: Requires 3D Analyst
Advanced: Requires 3D Analyst