等值线注记 (制图)
摘要
创建等值线要素的注记。
此工具可根据输入等值线要素创建含有相应掩膜面的注记要素类。
用法
此工具的输出为图层组。图层组将包含输入等值线要素、注记图层和掩膜面。
如果指定的图层名称相同并且已明确声明允许覆盖输出，则现有图层组将被覆盖。
-
在 ArcCatalog 或模型构建器工作环境下，可使用保存至图层文件工具将输出图层组写入到图层文件中。使用 ArcMap 时，如果在地理处理选项中选中相关选项，该工具可将图层组添加到视图区域。所创建的图层组是临时性的，如果不保存文档，该图层组将在会话结束后消失。
只有使用保存至图层文件工具将图层组保存到图层文件中，ArcCatalog 中创建的图层组才能在 ArcMap 中使用。
如果此工具在单个等值线要素类上运行多次，则注记要素类将不被覆盖。在这种情况下，将向注记要素类中添加一个数字（例如，ContourAnno、ContourAnno_1 等）。
每个掩膜都将使用注记要素周围的两点边距和简化的掩膜类型创建，这意味着掩膜将是一个表示注记准确形状的概化面。
对于等值线图层和输出注记，可有三种颜色选择：黑色、褐色和蓝色。
使用含障碍的等值线工具创建的等值线包含 Type 字段。Type 字段包含以下一个或多个值：
1 for contours 2 for indexed contours 3 for explicit contoursType 字段可用作等值线类型字段参数的输入。将为各类注记分别创建注记类。
语法
| 参数 | 说明 | 数据类型 |
in_features | 要创建注记的等值线要素类。 | Feature Layer |
out_geodatabase |
用来保存输出要素类的工作空间。此工作空间可以是现有地理数据库或现有要素数据集。 | Workspace; Feature Dataset |
contour_label_field |
注记文本基于的输入图层属性表中的字段。 | Field |
reference_scale_value |
输入要用作注记参考的比例。注记中的所有符号及文本的大小都会参照此处设置的参考比例。 | Double |
out_layer |
将包含等值线图层、注记和掩膜图层的图层组。在 ArcCatalog 工作环境下，可使用保存至图层文件工具将输出图层组写入图层文件中。使用 ArcMap 时，如果在地理处理选项中选中相关选项，该工具可将图层组添加到显示中。所创建的图层组是临时性的，如果不保存文档，该图层组将在会话结束后消失。 | Group Layer |
contour_color |
输出等值线图层和注记要素的颜色。
| String |
contour_type_field (可选) |
包含等值线要素类型值的输入图层属性表中的字段。将为各类型值创建注记类。 | Field |
contour_alignment (可选) |
注记可以与等值线高程对齐，从而使文本的顶部始终朝上。该选项允许注记倒置。等值线注记还可与页面对齐，从而确保文本不会倒置。
| String |
enable_laddering (可选) | 以阶梯方式放置注记将会使文本看起来像是沿着等值线的值递增或递减的方向排成一条笔直的线。这些阶梯将按从山顶到山脚的形式排列、彼此不会交叉、同属于一个坡度且不会与任何其他坡度交叉。
| Boolean |
代码实例
以下独立脚本演示了如何使用 ContourAnnotation 函数。
import arcpy
from arcpy import env
env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour", 50000, "ContourGroupLayer", "BLACK",
"", "PAGE", "")
此示例执行 ContourWithBarriers 命令，并使用该工具的输出作为 ContourAnnotation 工具的输入。
# Name: ContourAnnotation_Example2.py
# Description: Create a contour with barriers feature class and then create annotation for the contours.
# Requirements: ArcGIS Spatial Analyst 扩展模块
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
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)