Add Z Information (3D Analyst)
Summary
Adds information about elevation properties of features in a Zenabled feature class.
Each 3D shape is examined and the selected properties are appended to the attribute table of the input feature class. The output options vary based on the feature's geometry.
Usage

The following list summarizes Z property options by geometry:
 Points—Z
 Multipoints—Zminimum, Zmaximum, Zmean, point count
 Polylines—Zminimum, Zmaximum, Zmean, 3D length, minimum slope, maximum slope, average slope, vertex count
 Polygons—Zminimum, Zmaximum, Zmean, 3D length, minimum slope, maximum slope, average slope, vertex count
 Multipatches—Zminimum, Zmaximum, surface area, volume, minimum slope, maximum slope, average slope

Slope is returned as a percentage value, or grade, and is calculated differently for each geometry type that supports this property.
 Slope values for line features are calculated for each line segment:
 Min slope is obtained from the segment whose value is closest to 0, or horizontal grade.
 Max slope is obtained from the segment with the largest calculated value.
 Average slope is obtained by averaging the slope of all line segments after weighing each segment by its 3D length. This results in longer segments having greater influence on the resulting value over shorter segments.
 Slope values for multipatch features are calculated for each triangle face.
 Min slope is obtained from the face whose value is closest to 0, or horizontal grade.
 Max slope is obtained from the face with the largest value.
 Average slope is obtained by averaging the slope of all triangle faces after weighing each segment by its 3dimensional area. This results in larger areas having greater influence on the resulting value over smaller ones.
 Slope values for polygon features are only calculated for the feature edge using the same technique applied for line segments.
 Slope values for line features are calculated for each line segment:
Volume can only be computed for closed multipatches. An open multipatch feature will return a value of 0.0. On the Solaris platform, a design limitation currently prevents the tool from determining if a multipatch is closed, resulting in volume measurements being calculated for all multipatches under the assumption they are closed.
Syntax
Parameter  Explanation  Data Type 
in_feature_class 
The input feature class.  Feature Layer 
out_property [out_property,...]  The output Z properties that will be added to the attribute table of the input feature class. The following options are available:
 String 
noise_filtering (Optional) 
Provides the option to exclude small portions of features from statistical calculations. This option is useful for obtaining good maximum slope estimates, as small portions often exhibit extreme slopes, which may bias the statistical results. The values given in either the Area or Length options will be used to exclude these portions of features. This parameter does not apply to point and multipoint features.
 String 
Code Sample
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.AddZInformation_3d('lines_3D.shp', 'Z_MEAN; LENGTH_3D; AVG_SLOPE', 'NO_FILTER')
The following sample demonstrates the use of this tool in a standalone Python script:
'''****************************************************************** Name: AddZInformation Example Description: This script demonstrates AddZInformation on all zaware features in a target workspace. ******************************************************************''' # Import system modules import arcpy import exceptions, sys, traceback from arcpy import env try: arcpy.CheckOutExtension('3D') # Set environment settings env.workspace = 'C:/data' # Create list of feature classes fcList = arcpy.ListFeatureClasses() if fcList: for fc in fcList: desc = arcpy.Describe(fc) if desc.hasZ: # Set Local Variables noise = 'No_Filter' if desc.shapeType == 'Polygon': Prop = ['Z_MIN', 'Z_MAX', 'VERTEX_COUNT'] elif desc.shapeType == 'Point': Prop = 'Z' elif desc.shapeType == 'Multipoint': Prop = ['Z_MIN', 'Z_MAX', 'Z_MEAN'] elif desc.shapeType == 'Polyline': Prop = 'LENGTH_3D' print 'Completed adding Z information.' # Execute AddZInformation arcpy.AddZInformation_3d(inFC, Prop, noise) arcpy.CheckInExtension('3D') except arcpy.ExecuteError: print arcpy.GetMessages() except: # Get the traceback object tb = sys.exc_info()[2] tbinfo = traceback.format_tb(tb)[0] # Concatenate error information into message string pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\ .format(tbinfo, str(sys.exc_info()[1])) msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2)) # Return python error messages for script tool or Python Window arcpy.AddError(pymsg) arcpy.AddError(msgs)