等值线注记 (制图)

摘要

创建等值线要素的注记。

此工具可根据输入等值线要素创建含有相应掩膜面的注记要素类。

使用情况

  • Maplex Label Engine 中,使用等值线放置样式和平直居中放置位置标注等值线。

    了解有关等值线标注的详细信息

  • 此工具的输出为图层组。 图层组将包含输入等值线要素、注记图层和掩膜面。

  • 如果指定的图层名称相同并且已明确声明允许覆盖输出,则现有图层组将被覆盖。

  • 目录窗格或 ModelBuilder 中工作时,可使用保存至图层文件工具将输出图层组写入图层文件中。

  • 如果此工具在单个等值线要素类上运行多次,则注记要素类将不被覆盖。 在这种情况下,将向注记要素类名称中添加一个数字(例如,ContourAnno、ContourAnno_1 等)。

  • 每个掩膜都将使用注记要素周围的两点边距和简化的掩膜类型创建,这意味着掩膜将是一个表示注记准确形状的概化面。

  • 对于等值线图层和输出注记,可有三种颜色选择:黑色、棕色和蓝色。

  • 使用含障碍的等值线工具创建的等值线包含 Type 字段。 Type 字段包含以下一个或多个值:

    • 1 - 等值线
    • 2 - 计曲线
    • 3 - 建立等值线

    Type 字段可用作等值线类型字段参数的输入。 将为各类注记分别创建注记类。

  • 此工具支持注记文本字符串字段长度环境。 设置后,它将覆盖数据库中创建的所有注记要素类中 TextString 字段的默认字段长度。

参数

标注说明数据类型
输入要素

要创建注记的等值线要素类。

Feature Layer
输出地理数据库

用来保存输出要素类的工作空间。 此工作空间可以是现有地理数据库或现有要素数据集。

Workspace; Feature Dataset
等值线标注字段

注记文本基于的输入图层属性表中的字段。

Field
参考比例

将用作注记参考的比例。 注记中的所有符号及文本的大小都会参照此处设置的参考比例。

Double
输出图层名称

将包含等值线图层、注记和掩膜图层的图层组。 在目录窗格中工作时,可使用保存至图层文件工具将输出图层组写入图层文件中。 使用 ArcGIS Pro 时,如果将输出数据集添加至打开的地图选项在选项对话框的地理处理选项卡中为选中状态,则该工具会将组图层添加到显示中。 所创建的图层组是临时性的,如果不保存文档,该图层组将在会话结束后消失。

Group Layer
等值线和标注颜色

指定输出等值线图层和注记要素的颜色。

  • 黑色输出等值线图层和注记要素将以黑色绘制。 这是默认设置。
  • 褐色输出等值线图层和注记要素将以褐色绘制。
  • 蓝色输出等值线图层和注记要素将以蓝色绘制。
String
等值线类型字段
(可选)

包含等值线要素类型值的输入图层属性表中的字段。 将为各类型值创建注记类。

Field
等值线对齐
(可选)

指定注记将与等值线高程对齐的方法。 注记可以与等值线高程对齐,从而使文本的顶部始终朝上或朝下。 上述选项允许注记倒置。 等值线注记还可与页面对齐,从而确保文本不会倒置。

  • 将文本顶部对齐到页面顶部等值线注记将与页面对齐,从而确保文本不会倒置。 这是默认设置。
  • 将文本顶部朝上对齐等值线注记将与等值线高程对齐,从而使文本的顶部始终朝上。 该选项允许注记倒置。
  • 将文本顶部朝下对齐等值线注记将与等值线高程对齐,从而使文本的顶部始终朝下。 该选项允许注记倒置。
String
启用阶梯
(可选)

指定是否以阶梯方式放置注记。 以阶梯方式放置注记将会使文本看起来像是沿着等值线的值递增或递减的方向排成一条笔直的线。 这些阶梯将按从山顶到山脚的形式排列、彼此不会交叉、同属于一个坡度且不会与任何其他坡度交叉。

  • 选中 - 注记将会沿着等值线的值递增或递减的方向排成一条笔直的线。
  • 未选中 - 注记将不会沿着等值线的值递增或递减的方向排成一条笔直的线。 这是默认设置。

Boolean

派生输出

标注说明数据类型
输出工作空间

用来保存输出要素类的工作空间。

Workspace; Feature Dataset

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

指定输出等值线图层和注记要素的颜色。

  • BLACK输出等值线图层和注记要素将以黑色绘制。 这是默认设置。
  • BROWN输出等值线图层和注记要素将以褐色绘制。
  • BLUE输出等值线图层和注记要素将以蓝色绘制。
String
contour_type_field
(可选)

包含等值线要素类型值的输入图层属性表中的字段。 将为各类型值创建注记类。

Field
contour_alignment
(可选)

指定注记将与等值线高程对齐的方法。 注记可以与等值线高程对齐,从而使文本的顶部始终朝上或朝下。 上述选项允许注记倒置。 等值线注记还可与页面对齐,从而确保文本不会倒置。

  • PAGE等值线注记将与页面对齐,从而确保文本不会倒置。 这是默认设置。
  • UPHILL等值线注记将与等值线高程对齐,从而使文本的顶部始终朝上。 该选项允许注记倒置。
  • DOWNHILL等值线注记将与等值线高程对齐,从而使文本的顶部始终朝下。 该选项允许注记倒置。
String
enable_laddering
(可选)

指定是否以阶梯方式放置注记。 以阶梯方式放置注记将会使文本看起来像是沿着等值线的值递增或递减的方向排成一条笔直的线。 这些阶梯将按从山顶到山脚的形式排列、彼此不会交叉、同属于一个坡度且不会与任何其他坡度交叉。

  • ENABLE_LADDERING注记将会沿着等值线的值递增或递减的方向排成一条笔直的线。
  • NOT_ENABLE_LADDERING注记将不会沿着等值线的值递增或递减的方向排成一条笔直的线。 这是默认设置。
Boolean

派生输出

名称说明数据类型
out_geodatabase2

用来保存输出要素类的工作空间。

Workspace; Feature Dataset

代码示例

等值线注记 (ContourAnnotation) 示例(Python 窗口)

以下独立脚本演示了如何使用 ContourAnnotation 函数。

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour", 
                                    50000, "ContourGroupLayer", "BLACK", "", 
                                    "PAGE")
ContourAnnotation 示例 2(独立脚本)

此示例执行 ContourWithBarriers 函数,并使用该工具的输出作为 ContourAnnotation 函数的输入。

# Description: Create a contour with barriers feature class and then create 
#              annotation for the contours.
# Requirements: ArcGIS Spatial Analyst extension 

# 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 extension 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: 是

相关主题