简化线—帮助 | ArcGIS for Desktop

摘要
插图
用法
语法
代码实例
环境
许可信息

摘要

在不改变基本几何形状的情况下，通过移除多余的弯曲简化线。

了解有关“简化线”工作原理的详细信息

插图

用法

存在两种简化方法：
- 保留关键点方法（Python 中的 POINT_REMOVE算法POINT_REMOVE）速度较快，但没有另一种方法精细。它可移除多余的折点。此方法用于数据压缩或更为粗糙的简化。随着容差的增大，生成的线中有棱角的部分将显著增加，所以，输出的线可能不如输入的线美观。
- 保留关键折弯方法（Python 中的 BEND_SIMPLIFY）速度较慢，但通常会生成与原始要素更为接近的结果。其操作方式为消除沿线方向上不太重要的弯曲。此方法多用于更为精细的简化。
简化容差值用于确定简化程度。将容差设置为等于或大于图形元素之间允许的最小间距。在容差相同的前提下，保留关键点生成的结果比保留关键折弯生成的结果更粗糙、更简化。
此工具最终生成两个输出要素类：一个是存储简化后的线的线要素类；一个是存储用来表示任意折叠于一点的线的那些点的点要素类。点的输出名称和位置自动从输出的线的名称获得，并加 _Pnt 作为后缀。输出线要素类包含输入要素类中的所有字段。输出点要素类不包含任何这些字段。
以下为处理输出中的拓扑错误的选项：
- 检查拓扑错误参数用于标识简化过程所引入的拓扑错误。选中此选项时，解决拓扑错误参数也将激活。检查拓扑错误会降低处理速度。
- 输出线要素类包含两个表示要素是否存在拓扑错误的字段。InLine_FID 和 SimLnFlag 分别包含输入要素 ID 和拓扑错误。值 1 表示已引入错误；值 0（零）表示未引入错误。
- 拓扑错误解决之后，标记值仍将保持不变。SimLnFlag 字段用于检查包含拓扑错误的要素。
检查拓扑错误和解决拓扑错误参数不能在编辑会话内使用。要在编辑会话内运行此工具，请禁用检查拓扑错误参数。
注:
ArcGIS Pro 允许在任何时候设置这些参数，即使编辑始终可用。

语法

SimplifyLine_cartography (in_features, out_feature_class, algorithm, tolerance, {error_resolving_option}, {collapsed_point_option}, {error_checking_option})

参数	说明	数据类型
in_features	要进行简化的线要素。	Feature Layer
out_feature_class	要创建的输出线要素类。	Feature Class
algorithm	指定线的简化算法。 POINT_REMOVE —保留构成线的基本形状的关键点，而移除所有其他点。这是默认设置。 BEND_SIMPLIFY —保留线中的关键折弯，而移除多余折弯。	String
tolerance	用于确定简化程度的容差。必须指定一个容差，且值必须大于零。可以选择首选单位；默认为要素单位。对于 POINT_REMOVE 算法，指定的容差表示每个折点与其原始位置的最大允许偏移量。使用该选项解决拓扑错误时，可在某些区域局部减小此值。对于 BEND_SIMPLIFY 算法，指定的容差表示参考弯曲基线的长度。	Linear unit
error_resolving_option (可选)	指定处理拓扑错误的方式（这些拓扑错误可能是在处理时引入的，其中包括交叉的线、重叠的线和折叠为零长度的线）。当 error_checking_option = "CHECK" 时（默认设置），该参数生效。 FLAG_ERRORS —指定标记拓扑错误（如果发现拓扑错误）。这是默认设置。 RESOLVE_ERRORS —指定解决拓扑错误（如果发现拓扑错误）。	Boolean
collapsed_point_option (可选)	指定是否将处理中发现的任何折叠的零长度线作为点保留下来。只有指定了 NO_CHECK 或者同时指定了 FLAG_ERRORS 和 CHECK 选项时，该选项才适用。 KEEP_COLLAPSED_POINTS —指定将折叠的零长度线作为点保留下来。折叠线的端点将存储在位于输出要素类位置的点要素类中，以输出要素类的名称加上后缀 _Pnt 作为其名称。这是默认设置。 NO_KEEP —指定折叠的零长度线不作为点保留下来，即使在处理中发现也不保留；因此，点要素类将为空。	Boolean
error_checking_option (可选)	指定处理拓扑错误的方式（这些拓扑错误可能是在处理时引入的，其中包括交叉的线、重叠的线和折叠为零长度的线）。 CHECK —指定检查拓扑错误并启用 error_resolving_option 参数。这是默认设置。 NO_CHECK —指定不检查拓扑错误并禁用 error_resolving_option 参数。	Boolean

代码实例

SimplifyLine 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 SimplifyLine 工具。

import arcpy
from arcpy import env
import arcpy.cartography as CA
env.workspace = "C:/data"
CA.SimplifyLine("roads.shp", 
                "C:/output/output.gdb/simplified_roads", 
                "POINT_REMOVE", 
                20)

SimplifyLine 示例 2（独立脚本）

以下独立脚本演示了如何使用 SimplifyLine 工具。

# Name: SimplifyLine_Example2.py
# Description: Simplify line features from two feature classes, rivers and coastlines,
# while maintaining their connections

 
# Import system modules
import arcpy
from arcpy import env
import arcpy.management as DM
import arcpy.cartography as CA
 
# Set environment settings
env.workspace = "C:/data/Portland.gdb/Hydrography"
 
# Set local variables
inRiverFeatures = "rivers"
inCoastlineFeatures = "coastlines"

mergedFeatures = "C:/data/PortlandOutput.gdb/merged_lines"
simplifiedFeatures = "C:/data/PortlandOutput.gdb/merged_lines_simplified"
tempLayer = "tempLyr"

outRiverFeatureClass = "C:/data/PortlandOutput.gdb/rivers_final"
outCoastlineFeatureClass = "C:/data/PortlandOutput.gdb/coastlines_final"

# Merge rivers and coastlines into one feature class, 
# assuming that they have a common f-code field 
# with value 40 for rivers and 80 for coastlines.
DM.Merge(inRiverFeatures, inCoastlineFeatures, mergedFeatures)

# Simplify all lines.
CA.SimplifyLine(mergedFeatures, 
                simplifiedFeatures, 
                "BEND_SIMPLIFY", 
                100, 
                "RESOLVE_ERRORS", 
                "KEEP_COLLAPSED_POINTS", 
                "CHECK")
 
# Select rivers and coastlines by their f-code values 
# and put them in separate feature classes.
DM.MakeFeatureLayer(simplifiedFeatures, tempLayer, "f-code = 40")
DM.CopyFeatures(tempLayer, outRiverFeatureClass)

DM.MakeFeatureLayer(simplifiedFeatures, tempLayer, "f-code = 80")
DM.CopyFeatures(tempLayer, outCoastlineFeatureClass)

环境

许可信息

ArcGIS for Desktop Basic: 否
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是

摘要

插图

用法

语法

代码实例

SimplifyLine 示例（Python 窗口）

SimplifyLine 示例 2（独立脚本）

环境

许可信息

相关主题