ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Buffer 3D

  • Summary
  • Illustration
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Creates a 3-dimensional buffer around points or lines to produce spherical or cylindrical multipatch features.

Illustration

Buffer 3D illustration

Usage

  • The output of this tool is closed multipatch features which can be used in volumetric computations and other 3D set operator tools.

  • Consider specifying a Simplification value to improve performance with complex line features, such as curved lines with a large number of vertices.

  • This tool may not be able to generate a closed multipatch for certain line features if the geometry of the line and the buffer distance produces overlapping regions with dense vertices. As a general rule, it is best to avoid buffer distances that may result in the creation of overlapping regions within the same feature.

Syntax

Buffer3D_3d (in_features, out_feature_class, buffer_distance_or_field, {buffer_joint_type}, {buffer_quality}, {simplification_tolerance})
ParameterExplanationData Type
in_features

The line or point features to be buffered.

Feature Layer
out_feature_class

The output multipatch containing the 3D buffers.

Feature Class
buffer_distance_or_field

The distance of the buffer around the input features, which can be provided as either a linear distance or be derived from a numeric field in the input feature's attribute table. If the buffer distance is specified from an input field, its unit of measurement will be derived from the feature's spatial reference. If the linear distance is specified as a numeric value, the following units of measure are supported:

  • UNKNOWN
  • INCHES
  • FEET
  • YARDS
  • MILES
  • MILLIMETERS
  • CENTIMETERS
  • DECIMETERS
  • METERS
  • KILOMETERS
Linear Unit; Field
buffer_joint_type
(Optional)

The shape of the buffer between the vertices of the line segments. This parameter is only valid for input line features.

  • STRAIGHT —The shape of connections between vertices will be straight. This is the default.
  • ROUND —The shape of connections between vertices will be round.
String
buffer_quality
(Optional)

The number of segments used to represent the resulting multipatch features. The default is 20, but any number between the range of 6 to 60 can be entered. A higher Buffer Quality value produces smoother 3D features, but also lengthens the processing time.

Long
simplification_tolerance
(Optional)

Simplifies the input lines by maintaining their shape within the specified offset of its original form. Simplification will not take place if no value is specified. The following units of measurement are supported:

  • UNKNOWN
  • INCHES
  • FEET
  • YARDS
  • MILES
  • MILLIMETERS
  • CENTIMETERS
  • DECIMETERS
  • METERS
  • KILOMETERS
Linear Unit

Code Sample

Buffer3D 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.Buffer3D_3d('lineFC.shp', 'buffer3d.shp', '15 Meters', 
                 'Round', 30, '1 Meters')
Buffer3D example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script.

'''****************************************************************************
Name: Buffer 3D Example
Description: This script demonstrates an application of 
             the Buffer 3D and Inside 3D tools.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    env.workspace = 'C:/data'
    # Set Local Variables
    inFC = 'lineFC.shp'
    bufferOut = 'buffer3d.shp'
    # Execute Buffer 3D
    arcpy.Buffer3D_3d(inFC, bufferOut, '15 Meters', 'Round', '30', '1 Meters')
    arcpy.Inside3D_3d(bufferOut, 'survey_pts.shp', 'inside_analysis.dbf')

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)

Environments

  • Current Workspace
  • Extent
  • Output Coordinate System
  • Geographic Transformations
  • Output CONFIG Keyword
  • Output XY Domain
  • Output Z Domain

Licensing Information

  • ArcGIS for Desktop Basic: Requires 3D Analyst
  • ArcGIS for Desktop Standard: Requires 3D Analyst
  • ArcGIS for Desktop Advanced: Requires 3D Analyst

Related Topics

  • An overview of the 3D Features toolset
  • About 3D features
  • Fundamentals of geoprocessing with the ArcGIS 3D Analyst extension
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal