Сводка
Создаёт аннотации для пространственных объектов-изолиний.
Этот инструмент создает класс пространственных объектов с соответствующими маскирующими полигонами на основе исходных изолиний.
Использование
Изолинии надписываются с помощью стиля Изолинии и размещения Центрировать по прямой в Maplex Label Engine.
Выходным слоем для этого инструмента является составной слой. Составной слой включает входные объекты изолиний, слой аннотаций, а также маскирующие полигоны.
Составной слой будет записан поверх существующего, если будет указано одинаковое имя слоя, и если явным образом указывается разрешение на перезапись.
Во время работы в ArcCatalog или в ModelBuilder вы можете использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании инструмента в ArcMap, если эта опция отмечена в опциях геообработки, инструмент добавляет к отображению составной слой. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если документ не будет сохранен.
Составные слои, созданные в ArcCatalog, не могут быть использованы в ArcMap до тех пор, пока они не будут сохранены как файлы слоя с помощью инструмента Сохранить в файл слоя.
Классы объектов аннотаций не будут записаны поверх имеющихся, если инструмент будет несколько раз запущен применительно к одному и тому же классу объектов аннотаций. В этом случае к имени класса объектов-аннотаций будет добавлен номер (например, 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})| Параметр | Объяснение | Тип данных |
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 | Рабочая область, где сохраняется выходной класс объектов. | 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: Да