ArcMap

Adjust 3D Z

Summary

Modifies Z-values of 3D features.

Usage

  • 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.

  • REVERSE —Inverts the sign of Z-values causing the feature to flip upside down.
  • NO_REVERSE —Maintains 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.

  • MILLIMETERS —Millimeters
  • CENTIMETERS —Centimeters
  • METERS —Meters
  • INCHES —Inches
  • FEET —Feet
  • YARDS —Yards
  • FATHOMS —Fathoms
String
to_units
(Optional)

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

  • MILLIMETERS —Millimeters
  • CENTIMETERS —Centimeters
  • METERS —Meters
  • INCHES —Inches
  • FEET —Feet
  • YARDS —Yards
  • FATHOMS —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.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
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.

import arcpy
from arcpy import env

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

Environments

Licensing information

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

Related topics