Adjust 3D Z (Data Management)

Summary

Modifies Z-values of 3D features.

Usage

    Caution:

    This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

  • Consider inverting Z values of bathymetry and other subsurface measurements that use positive values to denote depth.

  • The Convert From Units and Convert To Units parameters allow you to convert Z-values from one common unit of measure to another.

Syntax

arcpy.management.Adjust3DZ(in_features, {reverse_sign}, {adjust_value}, {from_units}, {to_units})
ParameterExplanationData Type
in_features

The 3D features whose Z values will be modified.

Feature Layer
reverse_sign
(Optional)

Specifies whether features will be inverted along the Z-axis.

  • REVERSEInverts the sign of Z-values causing the feature to flip upside down.
  • NO_REVERSEMaintains the sign of Z-values. This is the default.
String
adjust_value
(Optional)

A numeric value or field from the input features that will be used to adjust the Z of each vertex in the input features. A positive value will shift the feature higher, while a negative number will shift it lower along the Z-axis.

Double; Field
from_units
(Optional)

The existing units of the Z-values. This parameter is used in conjunction with the Convert To Units parameter.

  • MILLIMETERSMillimeters
  • CENTIMETERSCentimeters
  • METERSMeters
  • INCHESInches
  • FEETFeet
  • YARDSYards
  • FATHOMSFathoms
String
to_units
(Optional)

The units that existing Z-values will be converted to.

  • MILLIMETERSMillimeters
  • CENTIMETERSCentimeters
  • METERSMeters
  • INCHESInches
  • FEETFeet
  • YARDSYards
  • FATHOMSFathoms
String

Derived Output

NameExplanationData Type
out_feature_class

The updated input features.

Feature Layer

Code sample

Adjust3DZ example 1 (Python window)

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

arcpy.env.workspace = "C:/data"
arcpy.Adjust3DZ_management("subsurface_pts.shp", "REVERSE", 0, "METERS", "FEET")
Adjust3DZ example 2 (stand-alone script)

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

arcpy.env.workspace = "C:/data"
arcpy.Adjust3DZ_management("subsurface_pts.shp", "REVERSE", 0, "METERS", "FEET")

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics