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.
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.
Syntax
arcpy.management.Adjust3DZ(in_features, {reverse_sign}, {adjust_value}, {from_units}, {to_units})
Parameter | Explanation | Data 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.
| 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.
| String |
to_units (Optional) | The units that existing Z-values will be converted to.
| String |
Derived Output
Name | Explanation | Data Type |
out_feature_class | The updated input features. | Feature Layer |
Code sample
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")
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")
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes