Аннотации изолиний (Картография)

Сводка

Создаёт аннотации для пространственных объектов-изолиний.

Этот инструмент создает класс пространственных объектов с соответствующими маскирующими полигонами на основе исходных изолиний.

Использование

  • Изолинии надписываются с помощью стиля Размещение изолиний и размещения Центрировать по прямой в Maplex Label Engine.

    Более подробно о надписывании изолиний

  • Выходным слоем для этого инструмента является составной слой. Составной слой включает входные объекты изолиний, слой аннотаций, а также маскирующие полигоны.

  • Составной слой будет записан поверх существующего, если будет указано одинаковое имя слоя, и если явным образом указывается разрешение на перезапись.

  • Во время работы на панели Каталог или в ModelBuilder вы можете использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя.

  • Классы объектов аннотаций не будут записаны поверх имеющихся, если инструмент будет несколько раз запущен применительно к одному и тому же классу объектов аннотаций. В этом случае к класса объектов-аннотаций будет добавлен номер (например, CitiesAnno10000, ContourAnno_1 и т.д.).

  • Каждая маска будет создана с двухточечным полем вокруг объекта аннотации; маска представляет собой упрощенный полигон, отражающий точную форму аннотации.

  • Существует три варианта выбора цвета изолиний и выходных аннотаций: черный, коричневый и синий.

  • Изолинии, созданные с помощью инструмента Изолинии с барьерами, содержат поле Type. Поле Type содержит одно или несколько следующих значений:

    • 1—Contours
    • 2—Indexed contours
    • 3—Explicit contours

    Это поле 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})
ParameterОбъяснениеТип данных
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

Производные выходные данные

NameОбъяснениеТип данных
out_geodatabase2

Рабочая область, где сохраняется выходной класс объектов.

Рабочая область; Набор классов объектов

Пример кода

Пример 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: Да

Связанные разделы