Help

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

Adjust3DZ_management (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)

Uniformly adjusts all Z-values by the specified number. Entering a negative number will decrease the Z-value, whereas a positive number will increase it.

Double
from_units
(Optional)

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

  • MILLIMETERS
  • CENTIMETERS
  • METERS
  • INCHES
  • FEET
  • YARDS
  • FATHOMS
String
to_units
(Optional)

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

  • MILLIMETERS
  • CENTIMETERS
  • METERS
  • INCHES
  • FEET
  • YARDS
  • FATHOMS
String

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

  • ArcGIS for Desktop Basic: Yes
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics