Краткая информация
Создаёт аннотации для пространственных объектов-изолиний.
Этот инструмент создает класс пространственных объектов с соответствующими маскирующими полигонами на основе исходных изолиний.
Использование
Изолинии надписываются с помощью стиля Изолинии и размещения Центрировать по прямой.
Выходным слоем для этого инструмента является составной слой. Составной слой включает входные объекты изолиний, слой аннотаций, а также маскирующие полигоны.
Составной слой будет записан поверх существующего, если будет указано одинаковое имя слоя, и если явным образом указывается разрешение на перезапись.
Во время работы в ArcCatalog или в ModelBuilder вы можете использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании ArcMap инструмент отображает составной слой, если этот параметр выставлен в опциях геообработки. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если документ не будет сохранен.
Составные слои, созданные в ArcCatalog, не могут использоваться в ArcMap, если они сохранены в файл слоя с использованием инструмента Сохранить в файл слоя.
Классы объектов аннотаций не будут записаны поверх имеющихся, если инструмент будет несколько раз запущен применительно к одному и тому же классу объектов аннотаций. В этом случае к названию класса объектов аннотаций будет добавлен номер (ContourAnno, ContourAnno_1 и т.д.).
Каждая маска будет создана с двухточечным полем вокруг объекта аннотации; маска представляет собой упрощенный полигон, отражающий точную форму аннотации.
Существует три варианта выбора цвета изолиний и выходный аннотаций: черный, коричневый и синий.
Изолинии, созданные с помощью инструмента Изолинии с барьерами, содержат поле Type. Поле Type содержит одно или несколько следующих значений:
1 for contours 2 for indexed contours 3 for explicit contours
Это поле может быть использовано в качестве входного для параметра Поле типа изолиний. Отдельный класс аннотаций создается для аннотаций каждого типа.
Синтаксис
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 | Составной слой, включающий в себя слой изолиний, аннотации и слой масок. Во время работы в ArcCatalog вы можете использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании ArcMap инструмент отображает составной слой, если этот параметр выставлен в опциях геообработки. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если документ не будет сохранен. | Group Layer |
contour_color | Цвет выходных изолиний и аннотаций.
| String |
contour_type_field (Дополнительный) | Поле в атрибутивной таблице входного слоя, содержащее значение типа изолинии. Для каждого типа будет создан подкласс аннотаций. | Field |
contour_alignment (Дополнительный) | Аннотации могут быть согласованы со значениями высот изолиний таким образом, чтобы верх текста всегда был ориентирован в сторону увеличения высоты. Эта опция позволяет размещать аннотации вверх ногами. Можно также контролировать положение аннотаций изолиний на странице, чтобы текст никогда не располагался вверх ногами.
| String |
enable_laddering (Дополнительный) | Расположение аннотаций лестницей приведет к отображению текста вверх и вниз по прямой по ступенькам изолиний. Эти ступени будут идти от вершины холма к его подножию, не пересекать друг друга, принадлежать одному склону и не пересекать какие-либо другие склоны.
| Boolean |
Производные выходные данные
Имя | Объяснение | Тип данных |
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: Да