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

Краткая информация

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

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

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

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

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

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

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

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

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

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

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

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

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

    Это поле 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 

# 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: Да

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