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.

  • Use the Convert From Units and Convert To Units parameters to convert z-values from one common unit of measure to another.

Parameters

LabelExplanationData Type
Input Features

The 3D features with the z-values that will be modified.

Feature Layer
Reverse Sign of Z Values
(Optional)

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

  • Reverse Z Orientation —The sign of z-values will be inverted causing the feature to flip upside down.
  • Maintain Z Orientation —The sign of z-values will not be inverted; it will be maintained. This is the default.
String
Adjust Z 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
Convert From Units
(Optional)

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

  • Millimeters —The units will be millimeters.
  • Centimeters —The units will be centimeters.
  • Meters —The units will be meters.
  • Inches —The units will be inches.
  • Feet —The units will be feet.
  • Yards —The units will be yards.
  • Fathoms —The units will be fathoms.
String
Convert To Units
(Optional)

Specifies the units that existing z-values will be converted to.

  • Millimeters —The units will be millimeters.
  • Centimeters —The units will be centimeters.
  • Meters —The units will be meters.
  • Inches —The units will be inches.
  • Feet —The units will be feet.
  • Yards —The units will be yards.
  • Fathoms —The units will be fathoms.
String

Derived Output

LabelExplanationData Type
Updated Features

The updated input features.

Feature Layer

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

The 3D features with the z-values that will be modified.

Feature Layer
reverse_sign
(Optional)

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

  • REVERSEThe sign of z-values will be inverted causing the feature to flip upside down.
  • NO_REVERSEThe sign of z-values will not be inverted; it will be maintained. 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)

Specifies the existing units of the z-values. This parameter is used in conjunction with the to_units parameter.

  • MILLIMETERSThe units will be millimeters.
  • CENTIMETERSThe units will be centimeters.
  • METERSThe units will be meters.
  • INCHESThe units will be inches.
  • FEETThe units will be feet.
  • YARDSThe units will be yards.
  • FATHOMSThe units will be fathoms.
String
to_units
(Optional)

Specifies the units that existing z-values will be converted to.

  • MILLIMETERSThe units will be millimeters.
  • CENTIMETERSThe units will be centimeters.
  • METERSThe units will be meters.
  • INCHESThe units will be inches.
  • FEETThe units will be feet.
  • YARDSThe units will be yards.
  • FATHOMSThe units will be fathoms.
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