标注 | 说明 | 数据类型 |
输入要素 |
要进行缓冲的输入点、线或面要素。 | Feature Layer |
输出要素类 |
包含输出缓冲区的要素类。 | Feature Class |
距离 [值或字段] |
与要缓冲的输入要素之间的距离。 该距离可以用表示线性距离的某个值来指定,也可以用输入要素中的某个字段(包含用来对每个要素进行缓冲的距离)来指定。 如果未指定线性单位或输入了“未知”,则将使用输入要素空间参考的线性单位。 | Linear Unit; Field |
侧类型 (可选) | 指定将在输入要素的哪一侧进行缓冲。 该参数仅支持面和线要素。
许可:此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。 | String |
末端类型 (可选) | 指定线输入要素末端的缓冲区形状。 此参数对于面输入要素无效。
许可:此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。 | String |
融合类型 (可选) | 指定移除缓冲区重叠要执行的融合类型。
| String |
融合字段 (可选) |
融合输出缓冲区所依据的输入要素的字段列表。 将融合共享所列字段(传递自输入要素)属性值的所有缓冲区。 | Field |
方法 (可选) | 指定是使用平面方法还是测地线方法来创建缓冲区。
| String |
插图
使用情况
如缓冲区的工作原理所述,缓冲区工具的一个重要特征为方法参数,该参数用于确定缓冲区的构建方式。 构建缓冲区有两种基本方法(欧式方法和测地线方法),如下所示:
- 欧式缓冲区测量二维笛卡尔平面中的距离,该平面用来计算平坦表面上两点之间的距离。 欧氏缓冲区适合于分析投影坐标系中相对较小的区域(如一个 UTM 带)内要素周围的距离。
- 测地线缓冲区表示地球的形状(即椭圆体,更准确地说是大地水准面)。 并计算曲面(大地水准面)上两点间的距离。 在下列情况下,您应创建测地线缓冲区:
- 输入要素处于分散状态(覆盖多个 UTM 带、大面积区域甚至整个地球)。
- 输入要素的空间参考(地图投影)为保留其他属性(如面积)使距离发生变形。
方法参数确定了缓冲区的创建方式。
- 平面选项是默认选项。 该选项会根据输入的坐标系自动确定要使用的方法。
- 如果输入要素位于投影坐标系中,则将创建欧氏缓冲区。
- 如果输入要素位于地理坐标系中且指定的缓冲距离值单位为线性单位(米、英尺等,而非诸如度之类的角度单位),则会创建测地线缓冲区。
- 选项产生的结果与 ArcGIS 10.3 版本之前的缓冲区工具结果相同。
- 对于任何输入坐标系,测地线选项都会创建形状不变的测地线缓冲区。 增密输入要素以创建更准确地表示输入要素形状的缓冲区。 在某些情况下,与使用平面选项创建测地线缓冲区相比,使用此选项创建缓冲区可能需要花费更长的时间。 但生成的缓冲区能更加精确地匹配输入要素的形状。
使用平面方法时,利用最小化距离变形且在地理上适用于输入数据的投影(例如等距圆锥投影或等距方位投影),可提高使用经过投影了的输入数据所创建的缓冲区的精度。
如果输入是投影坐标系而输出是地理数据库要素类,则输出可能包含圆弧段。 当输入是点要素类时,输出将始终是圆弧。 如果将圆弧投影到不同的坐标系,原始缓冲区的位置和大小将会发生变形。 但缓冲区的形状将会保持不变,这会导致投影的缓冲区无法精确表示原始缓冲区所覆盖的区域。 如果投影圆弧,请使用增密工具将圆弧转化成直线,然后再对增密缓冲区进行投影。
输出要素类将包含一个 BUFF_DIST 字段,该字段包含用于缓冲各要素的缓冲距离(使用输入坐标系的线性单位)。 使用测地线方法创建缓冲区时,输入的缓冲距离单位均将转换为米。
如果输入中存在名为 BUFF_DIST 的字段,那么在输出中将覆盖该字段的值。 如果使用融合类型值全部或列表,则输出将不包含此字段。
输出要素类将包含一个 ORIG_FID 字段,该字段包含为其创建缓冲区的输入要素的要素 ID。 如果输入中存在名为 ORIG_FID 的字段,那么在输出中将覆盖该字段的值。 如果使用融合类型值全部或列表,则输出将不包含此字段。
如果对面要素进行缓冲,则可使用负缓冲距离在面要素内部创建缓冲区。 使用负缓冲距离将会使面边界向内缩减指定的距离。
警告:
如果负缓冲距离足够大,使得面缩减至不存在,则将生成空几何。 此时将出现一条警告消息,并且不会将任何空几何要素写入输出要素类。
如果使用输入中的字段来获取缓冲距离,则该字段的值可以是数字(例如,5),也可以是数字加上有效的线性单位(例如,5 千米)。 如果字段值为数字,则假定距离使用输入空间参考的线性单位(除非该输入使用地理坐标系,这时该值以米为单位)。 如果在字段值中指定的线性单位无效或无法识别,则默认情况下将使用输入空间参考的线性单位。
-
融合字段参数中的添加字段按钮仅用于 ModelBuilder。 在 ModelBuilder 中,如果先前的工具尚未运行或其派生数据不存在,则可能不会使用字段名称来填充融合字段参数。 添加字段按钮可用于将预期字段添加到融合字段列表,从而完成缓冲区工具对话框。
缓冲区操作不支持将 z 值从输入缓冲区要素传输到输出缓冲区要素。
缓冲区操作不支持将 m 值从输入缓冲区要素传输到输出缓冲区要素。
许可:
仅当具有 Desktop Advanced 许可时,才可使用侧类型参数选项左、右和从缓冲区中排除输入面以及末端类型参数选项平整。
参数
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 (可选) |
指定将在输入要素的哪一侧进行缓冲。 该参数仅支持面和线要素。
许可:此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。 | String |
line_end_type (可选) |
指定线输入要素末端的缓冲区形状。 此参数对于面输入要素无效。
许可:此可选参数不适用于 Desktop Basic 或 Desktop Standard 许可。 | String |
dissolve_option (可选) |
指定移除缓冲区重叠要执行的融合类型。
| String |
dissolve_field [dissolve_field,...] (可选) |
融合输出缓冲区所依据的输入要素的字段列表。 将融合共享所列字段(传递自输入要素)属性值的所有缓冲区。 | Field |
method (可选) |
指定是使用平面方法还是测地线方法来创建缓冲区。
| String |
代码示例
以下 Python 窗口脚本演示了如何使用 Buffer 函数。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Buffer("roads", "C:/output/majorrdsBuffered", "100 Feet", "FULL",
"ROUND", "LIST", "Distance")
查找尚未受主要道路严重影响的相应植被区域。
# 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)
环境
特殊情况
- 并行处理因子
此工具支持并行处理因子环境。 如果未设置环境(默认)或设置为 0,则将禁用并行处理;不会使用并行处理,而是按顺序进行处理。 如将环境设置为 100,则将启用并行处理;将使用并行处理,并且将进行并行处理。 启用并行处理时,最多将使用 10 个内核。
仅当缓冲线和面要素时,才支持并行处理因子环境。
许可信息
- Basic: 受限
- Standard: 受限
- Advanced: 是