ArcMap

Modify Underlying Polygon

获得 Production Mapping 许可后可用。

描述

Determines which polygon features are directly below a line feature. If the type of feature is valid, which is determined by the subtype or feature class, the tool expands the feature to ensure that it meets minimum distance requirements. If it does not meet the minimum distance requirement, the part of the polygon feature under the line is removed and replaced with an appropriate type of feature.

插图

Modify Underlying Polygon example

使用

  • 如果输入要素未使用投影坐标系，则会发出一条警告消息。该工具基于线性距离单位，如果使用非投影坐标系，则将创建意外的结果。因此，强烈建议您对使用投影坐标系的数据运行此工具，以确保获得有效的结果。如果坐标系缺失或未知，则会生成一条错误消息并且工具将不执行处理操作。

  • This tool is mainly useful for enhancing the cartographic appearance of data at different scales. For example, suppose you have powerlines overlaying a vegetation area. If the forest symbol is complex and is composed of several small symbols that represent trees, the points representing the power poles may be difficult to see. To avoid this, you can simplify the symbology by replacing the forest symbol with a more general, solid green symbol so it is still understood that vegetation exists there.

  • This tool works with simple geometries such as squares, rectangles, and circles. It does not work with more complex shapes, such as ellipses.

  • Only polygons that are coincident with line features are affected by this tool.

  • The buffer distance can be used to ensure that the line can be clearly seen on the map when there are lines and polygons in the same area.

  • When replacement features are defined, you can also indicate which features will be created using the Replace Value (Replace_Value) parameter. For example, if the forest symbol contains a stipple that obscures line features that overlay it, you can replace it with the shrub subtype or the grass feature class, which are represented by solid green symbols.

  • If this tool is run in an edit session in ArcMap, you can stop the edit session without saving changes to restore features that have been deleted.

语法

arcpy.production.ModifyUnderlyingPolygon(Input_Line_Features, Buffer_Distance, Input_Features_Under_Line, {Keep_features_underneath_lines}, {Replace_Features}, {Replace_Value})
参数说明数据类型
Input_Line_Features

Lines that serve as a reference point for the polygons under them. The tool searches behind these lines to identify polygons that need to be modified or deleted.

Feature Layer
Buffer_Distance

The minimum distance the edge of the valid polygon features can be from the line. If the polygon is closer than the minimum distance, parts will be deleted until it is within the buffer distance. If the polygon is farther away than the minimum distance, it is expanded until it meets the buffer distance.

Linear unit
Input_Features_Under_Line

The polygons that will be checked to determine whether they have features that lie under the lines.

Feature Layer
Keep_features_underneath_lines
（可选）

Specifies whether the types of features directly under the lines, based on either the subtype or feature class, are allowed to be under the line or will be replaced.

  • KEEP_FEATURES —The feature type is valid. Valid features less than the buffer distance from the line will be expanded to the buffer distance.
  • REPLACE_FEATURES —The feature type is invalid and should not be within the buffer distance of the line. Parts of the features within the buffer distance will be removed and replaced with the features from Replace_Features. This is the default.
Boolean
Replace_Features
（可选）

The polygon features that will fill the buffer distance under the line if the features in Input_Features_Under_Line are not valid.

Feature Class
Replace_Value
（可选）

The subtype code or description to be assigned to the features in the Replace_Features feature class.

String

代码示例

ModifyUnderlyingPolygon (stand-alone script)

The following stand-alone script sample demonstrates how to use the ModifyUnderlyingPolygon function.

# Name: ModifyUnderlyingPolygon_Example.py
# Description: Executes Modify Underlying Polygon against LocalGovernment
# sample data
# Author: Esri
# Date: February 2014

# Import arcpy module
import arcpy

# Check out Production Mapping license
arcpy.CheckOutExtension("Foundation")

# Set environment
arcpy.env.workspace="c:/data/LocalGovernment.gdb"

# Define variables
inFeatures="ReferenceData/RoadCenterline"
inFeatureLyr="RoadLayer"
inPolys="ReferenceData/FacilitySite"
inPolysLyr="FaciltyLayer"
bufferIncrease="100 Feet"
replace="REPLACE_FEATURES"

# create feature layers for ModifyUnderlyingPolygon
arcpy.MakeFeatureLayer_management(inFeatures,inFeatureLyr)
arcpy.MakeFeatureLayer_management(inPolys,inPolysLyr)

# execute ModifyUnderlyingPolygon
arcpy.ModifyUnderlyingPolygon_production(inFeatureLyr,bufferIncrease,inPolysLyr,replace)

环境

许可信息

  • Basic: 否
  • Standard: 需要 Production Mapping
  • Advanced: 需要 Production Mapping

相关主题