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

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

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

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

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

• Изолинии надписываются с помощью стиля Изолинии и размещения Центрировать по прямой в 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

Python

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