描述
创建等值线要素的注记。
此工具可根据输入等值线要素创建含有相应掩膜面的注记要素类。
使用方法
等值线使用 Maplex Label Engine 中的等值线放置样式和平直居中放置位置进行标注。
此工具的输出为图层组。图层组将包含输入等值线要素、注记图层和掩膜面。
如果指定的图层名称相同并且已明确声明允许覆盖输出,则现有图层组将被覆盖。
在目录窗格或 ModelBuilder 中工作时,可使用保存至图层文件工具将输出图层组写入图层文件中。
如果此工具在单个等值线要素类上运行多次,则注记要素类将不被覆盖。在这种情况下,将向注记要素类中添加一个数字(例如,ContourAnno、ContourAnno_1 等)。
每个掩膜都将使用注记要素周围的两点边距和简化的掩膜类型创建,这意味着掩膜将是一个表示注记准确形状的概化面。
对于等值线图层和输出注记,可有三种颜色选择:黑色、棕色和蓝色。
使用含障碍的等值线工具创建的等值线包含 Type 字段。Type 字段包含以下一个或多个值:
- 1 - 等值线
- 2 - 计曲线
- 3 - 建立等值线
Type 字段可用作等值线类型字段参数的输入。将为各类注记分别创建注记类。
语法
arcpy.cartography.ContourAnnotation(in_features, out_geodatabase, contour_label_field, reference_scale_value, out_layer, contour_color, {contour_type_field}, {contour_alignment}, {enable_laddering})
参数 | 说明 | 数据类型 |
in_features | 要创建注记的等值线要素类。 | Feature Layer |
out_geodatabase | 用来保存输出要素类的工作空间。此工作空间可以是现有地理数据库或现有要素数据集。 | Workspace; Feature Dataset |
contour_label_field | 注记文本基于的输入图层属性表中的字段。 | Field |
reference_scale_value | 要用作注记参考的比例。注记中的所有符号及文本的大小都会参照此处设置的参考比例。 | Double |
out_layer |
将包含等值线图层、注记和掩膜图层的图层组。在目录窗格中工作时,可使用保存至图层文件工具将输出图层组写入图层文件中。使用 ArcGIS Pro 时,如果在选项对话框的地理处理选项卡中,选项将输出数据集添加至打开的地图为选中状态,则该工具会将图层组添加到显示中。所创建的图层组是临时性的,如果不保存文档,该图层组将在会话结束后消失。 | Group Layer |
contour_color | 指定输出等值线图层和注记要素的颜色。
| String |
contour_type_field (可选) | 包含等值线要素类型值的输入图层属性表中的字段。将为各类型值创建注记类。 | Field |
contour_alignment (可选) | 指定注记将与等值线高程对齐的方法。注记可以与等值线高程对齐,从而使文本的顶部始终朝上或朝下。上述选项允许注记倒置。等值线注记还可与页面对齐,从而确保文本不会倒置。
| String |
enable_laddering (可选) | 指定是否以阶梯方式放置注记。以阶梯方式放置注记将会使文本看起来像是沿着等值线的值递增或递减的方向排成一条笔直的线。这些阶梯将按从山顶到山脚的形式排列、彼此不会交叉、同属于一个坡度且不会与任何其他坡度交叉。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
out_geodatabase2 | 用来保存输出要素类的工作空间。 | 工作空间;要素数据集 |
代码示例
以下独立脚本演示了如何使用 ContourAnnotation 函数。
import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour",
50000, "ContourGroupLayer", "BLACK", "",
"PAGE")
此示例执行 ContourWithBarriers 函数,并使用该工具的输出作为 ContourAnnotation 函数的输入。
# Description: Create a contour with barriers feature class and then create
# annotation for the contours.
# Requirements: ArcGIS Spatial Analyst 扩展模块
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"
# Set local variables
inRaster = "elevation"
inBarrier = "ridges"
inTextFile = ""
explicitValues = "NO_EXPLICIT_VALUES_ONLY"
contourInterval = 200
indexInterval = 1000
contourList = [1500, 3000]
baseContour = 0
outContours = "C:/data/data.gdb/outcontourwithbarriers"
# Check out the ArcGIS ArcGIS Spatial Analyst 扩展模块 license
arcpy.CheckOutExtension("Spatial")
# Execute ContourWithBarriers
arcpy.sa.ContourWithBarriers(inRaster, outContours, inBarrier, "POLYLINES",
inTextFile, explicitValues, baseContour,
contourInterval, indexInterval, contourList)
# Set local variables
inFeatures = "C:/data/data.gdb/outcontourwithbarriers"
inWorkspace = "C:/data/data.gdb"
LabelField = "Contour"
RefScaleValue = 50000
outLayer = "Contours"
Color = "BROWN"
TypeField = "Type"
Alignment = "PAGE"
Laddering = "NOT_ENABLE_LADDERING"
# Execute ContourAnnotation
arcpy.ContourAnnotation_cartography(inFeatures, inWorkspace, LabelField,
RefScaleValue, outLayer, Color, TypeField,
Alignment, Laddering)
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是