Geoprocessing tool reference > Data Management toolbox > Features toolset > Tools
Adjust 3D Z (Data Management) |
|
|
Release 9.2
Last modified November 29, 2010 |
Print all topics in : "Tools" |
Allows the modification of all Z values in a Z enabled Feature Class.
Usage tips
-
Bathymetry data often has positive Z-values. You may wish to reverse the signs of all the data in the Feature Class to make it negative.
-
Z-enabled data could be referenced to a vertical datum that is not appropriate for your geoprocessing needs. This tool could apply a bulk-shift of all the Z-values in the Feature Class to adjust the data either up or down vertically.
-
If your Z-values represent units that aren't consistent with your other data, or you'd like to convert them to another unit, we have included several common unit conversions.
-
The following environment settings affect this tool: Z Tolerance, Output Z domain, Output has Z values, Default Z value.
Command line syntax
An overview of the Command Line window
Adjust3DZ_management <in_features> {NO_REVERSE | REVERSE} {adjust_value} {MILLIMETERS | CENTIMETERS | METERS | INCHES | FEET | YARDS | FATHOMS} {MILLIMETERS | CENTIMETERS | METERS | INCHES | FEET | YARDS | FATHOMS}
| Parameter | Explanation | Data Type |
| <in_features> |
The input feature class containing Z-values in the SHAPE field. |
Feature Layer |
| {NO_REVERSE | REVERSE} |
Flips the sign of all the Z values in the feature class. |
String keyword |
| {adjust_value} |
This parameters allows you to specify a value for a bulk shift. To decrease the z-values for the entire feature class, enter a negative number. To increase, enter a positive value. |
Double |
| {MILLIMETERS | CENTIMETERS | METERS | INCHES | FEET | YARDS | FATHOMS} |
This parameter specifies the units that the z values will be converted from. Available conversion factors are:
centimeters meters inches feet yards fathoms This parameter is used in conjunction with Convert To Units. |
String keyword |
| {MILLIMETERS | CENTIMETERS | METERS | INCHES | FEET | YARDS | FATHOMS} |
This parameter specifies the units that the z values will be converted to. Available conversion factors are:
centimeters meters inches feet yards fathoms This parameter is used in conjunction with Convert From Units. |
String keyword |
Command line example
Reverse Sign Example:Adjust3DZ C:\Tutorial\sample_data.gdb\tutorial\depths REVERSE # #Bulk Shift Adjustment Example:
Adjust3DZ C:\Tutorial\sample_data.gdb\tutorial\coastline # 10.5 # #Unit Conversion Example:
Adjust3DZ C:\Tutorial\sample_data.gdb\tutorial\breaklines # # FEET METERS
Scripting syntax
About getting started with writing geoprocessing scripts
Adjust3DZ_management (in_features, reverse_sign, adjust_value, from_units, to_units)
| Parameter | Explanation | Data Type |
| in_features (Required) |
The input feature class containing Z-values in the SHAPE field. |
Feature Layer |
| reverse_sign (Optional) |
Flips the sign of all the Z values in the feature class. |
String keyword |
| adjust_value (Optional) |
This parameters allows you to specify a value for a bulk shift. To decrease the z-values for the entire feature class, enter a negative number. To increase, enter a positive value. |
Double |
| from_units (Optional) |
This parameter specifies the units that the z values will be converted from. Available conversion factors are:
centimeters meters inches feet yards fathoms This parameter is used in conjunction with Convert To Units. |
String keyword |
| to_units (Optional) |
This parameter specifies the units that the z values will be converted to. Available conversion factors are:
centimeters meters inches feet yards fathoms This parameter is used in conjunction with Convert From Units. |
String keyword |
Data types for geoprocessing tool parameters
Script example
# Name: adjust3dz.py # Description: This python file tests the functionality of Adjust3DZ, specifically for: # 1. REVERSE signs of Z-values in Z enabled multipoint feature class # 2. BULK SHIFT of Z-values in Z enabled polyline feature class # 3. COORDINATE CONVERSION of units in Z-enabled point feature class # Requirements: Python and the Python win32all extension # Author: ESRI # Date 1/1/2009 # Create the Geoprocessor import arcgisscripting, time gp = arcgisscripting.create() gp.overwriteoutput = 1 # 1. REVERSE signs of Z-values in Z enabled multipoint feature class inFClass = "test_adjust.gdb\\topography\\multipoint_test" signage = "REVERSE" adjust = " " from_units = " " to_units = " " print "Executing REVERSE Adjust3DZ test." adjust3dz_management (inFClass, signage, adjust, from_units, to_units) # 2. BULK SHIFT of Z-values in Z enabled polyline feature class inFClass = "test_adjust.gdb\\topography\\breaklines" signage = " " adjust = "10.5" from_units = " " to_units = " " print "Executing BULK_SHIFT Adjust3DZ test." adjust3dz_management (inFClass, signage, adjust, from_units, to_units) # 3. COORDINATE CONVERSION of units in Z-enabled point feature class inFClass = "test_adjust.gdb\\topography\\points_test" signage = " " adjust = " " from_units = "FEET" to_units = "METERS" print "Executing UNIT_CONVERSION Adjust3DZ test." adjust3dz_management (inFClass, signage, adjust, from_units, to_units) print "Finished Adjust3DZ tests."