ArcMap

Update Feature Z

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.

Syntax

UpdateFeatureZ_3d (in_features, in_surface, {method}, {status_field})
ParameterExplanationData 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

NameExplanationData Type
out_feature_class

Feature Layer

Code sample

UpdateFeatureZ example 1 (Python window)

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

Missing source code file
UpdateFeatureZ example 2 (stand-alone script)

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

Missing source code file

Environments

Licensing information

  • ArcGIS Desktop Basic: Requires 3D Analyst
  • ArcGIS Desktop Standard: Requires 3D Analyst
  • ArcGIS Desktop Advanced: Requires 3D Analyst

Related topics