面转线 (Data Management)

摘要

创建的要素类中将包含由面边界转换而来的线（无论是否考虑邻近面）。

插图

用法

• 如果选中识别和存储面邻域信息复选框（在脚本环境下 neighbor_option 将设置为 IDENTIFY_NEIGHBORS），则会分析面邻域关系。如上图所示，将边界转换为线时将考虑相交线段或公共线段；向输出要素类添加两个新字段 LEFT_FID 和 RIGHT_FID，然后将这两个字段分别设定为位于各输出线左右两侧的输入面的要素 ID。输入要素的属性并不会保留在输出要素类中。下述情境将有助于您更加详细地了解操作过程和输出结果：

  • 在面几何中，将始终以顺时针方向存储外边界。如果面内含有孔洞，那么将始终以逆时针方向存储孔洞（或内部）边界。因此，如果某面的外边界左侧（外部）和孔洞边界左侧（内部）均没有相邻点，则生成线的 LEFT_FID 值为 -1，而 RIGHT_FID 则设为面要素 ID。
  • 如果面内包含另一个面，则会生成一条顺时针方向的输出线来表示公共边界，该线的 LEFT_FID 将设置为外部面要素 ID ，而 RIGHT_FID 将设置为内部面要素 ID。
  • 如果两个面共用一部分边界，则将生成一条输出线表示该公共线段。该线的方向可以是任意的；LEFT_FID 和 RIGHT_FID 将相应地设置为左侧或右侧面要素 ID。
  • 如果一个面与另一个面重叠，那么将生成两条输出线以便两次表示每个相交边界：第一条线表示其中一个重叠面的外边界，因此该线的 LEFT_FID 为与其相交的面的要素 ID，而 RIGHT_FID 将为它自己的面要素 ID；第二条线呈反方向，并会分割另一个面，因此该线的 LEFT_FID 和 RIGHT_FID 将与这第二个面的要素 ID 相同。
  • 输入面中的多部分 (Multipart) 不会得到保留；输出线均为单部分 (singlepart)。

• 如果取消选中识别和存储面邻域信息复选框（在脚本环境下 neighbor_option 将设置为 IGNORE_NEIGHBORS），则会忽略面邻域关系。各输入面边界将写出为封闭线要素。多部分面在输出中将变为多部分线。输入要素的属性将保留在输出要素类中。向输出添加新字段 ORIG_FID，并设置为各个线的输入要素 ID。

• 对于参数（真）曲线输入要素，即使真曲线被分割，输出线仍将保留这些真曲线。但这一点不适用于 shapefile 数据。

• 此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息，请参阅对大型数据集进行地理处理。

语法

PolygonToLine_management (in_features, out_feature_class, {neighbor_option})

参数	说明	数据类型
in_features	几何必须为面的输入要素。	Feature Layer
out_feature_class	输出线要素类。	Feature Class
neighbor_option (可选)	指定是否识别并存储面邻域信息。 IDENTIFY_NEIGHBORS —识别面邻域关系并将该关系存储在输出中。如果某个面的不同线段与不同的面共用边界，那么该边界将被分割成各个唯一公用的线段，这些线段的两个邻近面 FID 值将存储在输出中。这是默认设置。 IGNORE_NEIGHBORS —忽略面邻域关系；每个面边界均将变为线要素，并且边界原始面要素 ID 将存储在输出中。	Boolean

代码实例

面转线 (PolygonToLine) 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 PolygonToLine 函数。

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.PolygonToLine_management("Habitat_Analysis.gdb/vegtype", 
                               "C:/output/Output.gdb/vegtype_lines",
                               "IGNORE_NEIGHBORS")

面转线 (PolygonToLine) 示例 2（独立脚本）

以下独立脚本是如何在脚本环境中应用 PolygonToLine 函数的简单示例。

# Name: PolygonToLine_Example2.py
# Description: Use PolygonToLine function to convert polygons to lines,
#              and report how many shared or overlapping boundary lines
#              were found.
# Author: ESRI

# import system modules 
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data/landcovers.gdb"
 
# Create variables for the input and output feature classes
inFeatureClass = "bldgs"
outFeatureClass = "bldgs_lines"
 
# Use error trapping in case a problem occurs when running the tool
try:
    # Run PolygonToLine to convert polygons to lines using default neighbor_option
    arcpy.PolygonToLine_management(inFeatureClass, outFeatureClass)
 
    # Select lines that have LEFT_FID values greater than -1
    arcpy.MakeFeatureLayer_management(outFeatureClass, "selection_lyr", 
                                      "\"LEFT_FID\" > -1")
    result = arcpy.GetCount_management("selection_lyr")

    if (result.getOutput(0) == "0"):
        print "No overlapping or shared boundary lines were found."
    else:
        print result.getOutput(0) + " overlapping or shared " +\
              "boundary lines were found."
 
except Exception, e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print "Line %i" % tb.tb_lineno
    print e.message

环境

当前工作空间, 临时工作空间, 默认输出 Z 值, M 分辨率, M 容差, 输出 M 属性域, 输出 Z 属性域, 输出坐标系, 范围, 输出包含 M 值, 输出包含 Z 值, 输出空间格网 1；输出空间格网 2；输出空间格网 3, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

ArcGIS for Desktop Basic: 否

ArcGIS for Desktop Standard: 否

ArcGIS for Desktop Advanced: 是