缓冲区 (分析)—ArcGIS Pro

摘要

在输入要素周围某一指定距离内创建缓冲区多边形。

备用工具可用于缓冲操作。有关详细信息，请参阅成对缓冲和图形缓冲区工具文档。

了解有关缓冲区工作原理的详细信息

插图

使用情况

如缓冲区的工作原理所述，缓冲区工具的一个重要特征为方法参数，该参数用于确定缓冲区的构建方式。构建缓冲区有两种基本方法（欧式方法和测地线方法），如下所示：
- 欧式缓冲区测量二维笛卡尔平面中的距离，该平面用来计算平坦表面上两点之间的距离。欧氏缓冲区适合于分析投影坐标系中相对较小的区域（如一个 UTM 带）内要素周围的距离。
- 测地线缓冲区表示地球的形状（即椭圆体，更准确地说是大地水准面）。并计算曲面（大地水准面）上两点间的距离。测地线缓冲区适用于以下情况：
  - 输入要素处于分散状态（覆盖多个 UTM 带、大面积区域或整个地球）。
  - 输入要素的空间参考（地图投影）为保留其他属性（如面积）使距离发生变形。
  测地线缓冲区在平面地图上可能会显示异常。但当显示在地球上时，这些缓冲区的外观将正常。有关详细信息，请参阅缓冲区的工作原理。
方法参数确定了缓冲区的创建方式。
- 平面选项是默认选项。该选项将基于输入的坐标系自动确定要使用的方法。
  - 如果输入要素位于投影坐标系中，则将创建欧氏缓冲区。
  - 如果输入要素位于地理坐标系中且指定的缓冲距离值单位为线性单位（米、英尺等，而非诸如度之类的角度单位），则会创建测地线缓冲区。
  - 选项产生的结果与 ArcGIS 10.3 版本之前的缓冲区工具结果相同。
- 对于任何输入坐标系，测地线选项都会创建形状不变的测地线缓冲区。增密输入要素以创建更准确地表示输入要素形状的缓冲区。在某些情况下，与使用平面选项创建测地线缓冲区相比，使用此选项创建缓冲区可能需要花费更长的时间。但生成的缓冲区能更加精确地匹配输入要素的形状。
注：
您可以使用投影工具更改要素类的坐标系，或在运行缓冲区工具之前对输出坐标系环境进行设置，这一坐标系将用于创建缓冲区。
使用平面选项时，利用最小化距离变形且在地理上适用于输入数据的投影（例如等距圆锥投影或等距方位投影），可提高使用经过投影了的输入数据所创建的缓冲区的精度。
如果输入是投影坐标系而输出是地理数据库要素类，则输出可能包含圆弧段。当输入是点要素类时，输出将始终是圆弧。如果将圆弧投影到不同的坐标系，原始缓冲区的位置和大小将会发生变形。但缓冲区的形状将会保持不变，这会导致投影的缓冲区无法精确表示原始缓冲区所覆盖的区域。如果投影圆弧，请使用增密工具将圆弧转化成直线，然后再对增密缓冲区进行投影。
输出要素类将包含一个 BUFF_DIST 字段，该字段包含用于缓冲各要素的缓冲距离（使用输入坐标系的线性单位）。当使用测地线选项创建缓冲区时，会将提供的缓冲距离单位转换为米。
如果输入中存在 BUFF_DIST 字段，那么在输出中将覆盖该字段的值。如果使用融合类型值全部或列表，则输出将不包含此字段。
输出要素类将包含一个 ORIG_FID 字段，该字段包含为其创建缓冲区的输入要素的要素 ID。如果输入中存在 ORIG_FID 字段，那么在输出中将覆盖该字段的值。如果使用融合类型值全部或列表，则输出将不包含此字段。
如果对面要素进行缓冲，则可使用负缓冲距离在面要素内部创建缓冲区。使用负缓冲距离将会使面边界向内缩减指定的距离。
警告：
如果负缓冲距离足够大，使得面缩减至不存在，则将生成空几何。此时将出现一条警告消息，并且不会将任何空几何要素写入输出要素类。
可以使用输入中的字段来设置缓冲距离。接受数值和文本字段。在文本字段中，缓冲距离可以为数值（例如 5）或者有效的线性单位，例如 5 千米。

如果使用不带线性单位的数值，则缓冲区将采用输入空间参考的线性单位。如果输入位于地理坐标系中，则缓冲区将以米为单位。

如果无法识别线性单位，则缓冲区将采用输入空间参考的线性单位。有关有效线性单位的详细信息，请参阅线性单位。
缓冲区操作不支持将 z 值从输入缓冲区要素传输到输出缓冲区要素。
缓冲区操作不支持将 m 值从输入缓冲区要素传输到输出缓冲区要素。

许可：

仅当具有 Desktop Advanced 许可时，才可使用侧类型参数选项左、右和从缓冲区中排除输入面以及末端类型参数选项平整。

参数

标注	说明	数据类型
输入要素	将进行缓冲的输入点、线或面要素。	Feature Layer
输出要素类	包含输出缓冲区的要素类。	Feature Class
距离 [值或字段]	与要缓冲的输入要素之间的距离。该距离可以用表示线性距离的某个值来指定，也可以用输入要素中的某个字段（包含用来对每个要素进行缓冲的距离）来指定。如果未指定线性单位或输入了“未知”，则将使用输入要素空间参考的线性单位。	Linear Unit; Field
侧类型 (可选)	指定将在输入要素的哪一侧进行缓冲。该参数仅支持面和线要素。全部—对于线，将在线两侧生成缓冲区。对于面，将在面周围生成缓冲区，并且这些缓冲区将包含并叠加输入要素的区域。这是默认设置。左侧—对于线，将在线的拓扑左侧生成缓冲区。此选项不支持面输入要素。右侧—对于线，将在线的拓扑右侧生成缓冲区。此选项不支持面输入要素。从缓冲区中排除输入面—对于面，仅在输入面的外部生成缓冲区（输入面内部的区域将在输出缓冲区中被擦除）。此选项不支持线输入要素。许可：此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。	String
末端类型 (可选)	指定线输入要素末端的缓冲区形状。此参数对于面输入要素无效。圆形—缓冲区的末端为圆形，即半圆形。这是默认设置。平整—缓冲区的末端很平整或者为方形，并且在输入线要素的端点处终止。许可：此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。	String
融合类型 (可选)	指定移除缓冲区重叠要执行的融合类型。未融合—不考虑重叠，将保持每个要素的独立缓冲区。这是默认设置。将全部输出要素融合为一个要素—将所有缓冲区融合为单个要素，从而移除所有重叠。使用所列字段唯一值或值的组合来融合要素—将融合共享所列字段（传递自输入要素）属性值的所有缓冲区。	String
融合字段 (可选)	融合输出缓冲区所依据的输入要素的字段列表。将融合共享所列字段（传递自输入要素）属性值的所有缓冲区。	Field
方法 (可选)	指定是使用平面方法还是测地线方法来创建缓冲区。平面—如果输入要素位于投影坐标系中，则将创建欧氏缓冲区。如果输入要素位于地理坐标系中且缓冲距离的单位为线性单位（米、英尺等，而非诸如度之类的角度单位），则会创建测地线缓冲区。这是默认设置。您可以使用输出坐标系环境设置指定要使用的坐标系。例如，如果输入要素位于投影坐标系中，您可以将环境设置为地理坐标系，以便创建测地线缓冲区。测地线（形状保持不变）—无论使用哪种输入坐标系，均使用形状不变的测地线缓冲区方法创建所有缓冲区。	String

arcpy.analysis.Buffer(in_features, out_feature_class, buffer_distance_or_field, {line_side}, {line_end_type}, {dissolve_option}, {dissolve_field}, {method})

名称	说明	数据类型
in_features	将进行缓冲的输入点、线或面要素。	Feature Layer
out_feature_class	包含输出缓冲区的要素类。	Feature Class
buffer_distance_or_field	与要缓冲的输入要素之间的距离。该距离可以用表示线性距离的某个值来指定，也可以用输入要素中的某个字段（包含用来对每个要素进行缓冲的距离）来指定。如果未指定线性单位或输入了“未知”，则将使用输入要素空间参考的线性单位。指定距离时，如果线性单位含有两个单词，如 Decimal Degrees，请将两个单词合并成一个词（例如，20 DecimalDegrees）。	Linear Unit; Field
line_side (可选)	指定将在输入要素的哪一侧进行缓冲。该参数仅支持面和线要素。 FULL—对于线，将在线两侧生成缓冲区。对于面，将在面周围生成缓冲区，并且这些缓冲区将包含并叠加输入要素的区域。这是默认设置。 LEFT—对于线，将在线的拓扑左侧生成缓冲区。此选项不支持面输入要素。 RIGHT—对于线，将在线的拓扑右侧生成缓冲区。此选项不支持面输入要素。 OUTSIDE_ONLY—对于面，仅在输入面的外部生成缓冲区（输入面内部的区域将在输出缓冲区中被擦除）。此选项不支持线输入要素。许可：此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。	String
line_end_type (可选)	指定线输入要素末端的缓冲区形状。此参数对于面输入要素无效。 ROUND—缓冲区的末端为圆形，即半圆形。这是默认设置。 FLAT—缓冲区的末端很平整或者为方形，并且在输入线要素的端点处终止。许可：此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。	String
dissolve_option (可选)	指定移除缓冲区重叠要执行的融合类型。 NONE—不考虑重叠，将保持每个要素的独立缓冲区。这是默认设置。 ALL—将所有缓冲区融合为单个要素，从而移除所有重叠。 LIST—将融合共享所列字段（传递自输入要素）属性值的所有缓冲区。	String
dissolve_field [dissolve_field,...] (可选)	融合输出缓冲区所依据的输入要素的字段列表。将融合共享所列字段（传递自输入要素）属性值的所有缓冲区。	Field
method (可选)	指定是使用平面方法还是测地线方法来创建缓冲区。 PLANAR—如果输入要素位于投影坐标系中，则将创建欧氏缓冲区。如果输入要素位于地理坐标系中且缓冲距离的单位为线性单位（米、英尺等，而非诸如度之类的角度单位），则会创建测地线缓冲区。这是默认设置。您可以使用输出坐标系环境设置指定要使用的坐标系。例如，如果输入要素位于投影坐标系中，您可以将环境设置为地理坐标系，以便创建测地线缓冲区。 GEODESIC—无论使用哪种输入坐标系，均使用形状不变的测地线缓冲区方法创建所有缓冲区。	String

代码示例

Buffer 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何使用 Buffer 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Buffer("roads", "C:/output/majorrdsBuffered", "100 Feet", "FULL", 
                      "ROUND", "LIST", "Distance")

Buffer 示例 2（独立脚本）

查找尚未受主要道路严重影响的相应植被区域。

# Name: Buffer.py
# Description: Find areas of suitable vegetation that exclude areas heavily 
# impacted by major roads

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"

# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1" 
arcpy.analysis.Select(veg, suitableVeg, whereClause)

# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
sideType = "FULL"
endType = "ROUND"
dissolveType = "LIST"
dissolveField = "Distance"
arcpy.analysis.Buffer(roads, roadsBuffer, distanceField, sideType, endType, 
                      dissolveType, dissolveField)

# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
xyTol = "1 Meters"
arcpy.analysis.Erase(suitableVeg, roadsBuffer, eraseOutput, xyTol)

环境

默认输出 Z 值, M 分辨率, M 容差, 输出 M 值域, 输出 XY 值域, 输出 Z 值域, 输出坐标系, 范围, 并行处理因子, 当前工作空间, 地理变换, 临时工作空间, 输出包含 M 值, 输出包含 Z 值, XY 分辨率, XY 容差, Z 分辨率, Z 容差

特殊情况

并行处理因子

此工具支持并行处理因子环境。如果未设置环境（默认）或设置为 0，则将禁用并行处理；不会使用并行处理，而是按顺序进行处理。如将环境设置为 100，则将启用并行处理；将使用并行处理，并且将进行并行处理。启用并行处理时，最多将使用 10 个内核。

仅当缓冲线和面要素时，才支持并行处理因子环境。

许可信息

Basic: 受限
Standard: 受限
Advanced: 是

摘要

插图

使用情况

注：

警告：

许可：

参数

许可：

许可：

许可：

许可：

代码示例

环境

特殊情况

许可信息

相关主题

在本主题中