Краткая информация
Создаёт аннотации для пространственных объектов-изолиний.
Этот инструмент создает класс пространственных объектов с соответствующими маскирующими полигонами на основе исходных изолиний.
Использование
Выходным слоем для этого инструмента является составной слой. Составной слой включает входные объекты изолиний, слой аннотаций, а также маскирующие полигоны.
Составной слой будет записан поверх существующего, если будет указано одинаковое имя слоя, и если явным образом указывается разрешение на перезапись.
Во время работы в ArcCatalog или ModelBuilder вы можете использовать инструмент Сохранить в файл слоя (Save_To_Layer_File), чтобы записать выходной составной слой в файл слоя. При использовании ArcMap инструмент отображает составной слой, если этот параметр выставлен в опциях геообработки. Создаваемый составной слой является временным и не сохранится по окончании сеанса редактирования, если документ не будет сохранен.
Составные слои, созданные в ArcCatalog, не могут использоваться в ArcMap, если они сохранены в файл слоя с использованием инструмента Сохранить в файл слоя (Save_To_Layer_File).
Классы объектов аннотаций не будут записаны поверх имеющихся, если инструмент будет несколько раз запущен применительно к одному и тому же классу объектов аннотаций. В этом случае к названию класса объектов аннотаций будет добавлен номер (ContourAnno, ContourAnno_1 и т.д.).
Каждая маска будет создана с двухточечным полем вокруг объекта аннотации; маска представляет собой упрощенный полигон, отражающий точную форму аннотации.
Существует три варианта выбора цвета изолиний и выходный аннотаций: черный, коричневый и синий.
Изолинии, созданные с помощью инструмента Изолинии с барьерами (Contour With Barriers), содержат поле Тип (Type). Поле Тип (Type) содержит одно или несколько следующих значений:
1 for contours 2 for indexed contours 3 for explicit contoursЭто поле Тип (Type) может быть использовано в качестве входного для параметра Поле типа изолиний (Contour Type Field). Отдельный класс аннотаций создается для аннотаций каждого типа.
Синтаксис
ContourAnnotation_cartography (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 вы можете использовать инструмент Сохранить в файл слоя (Save To Layer File), чтобы записать выходной составной слой в файл слоя. При использовании ArcMap инструмент отображает составной слой, если этот параметр выставлен в опциях геообработки. Создаваемый составной слой является временным и не сохранится по окончании сессии редактирования, если документ не будет сохранен. | Group Layer |
contour_color | Цвет выходных изолиний и аннотаций.
| String |
contour_type_field (Дополнительный) | Поле в атрибутивной таблице входного слоя, содержащее значение типа изолинии. Для каждого типа будет создан подкласс аннотаций. | Field |
contour_alignment (Дополнительный) | Аннотации могут быть согласованы со значениями высот изолиний таким образом, чтобы верх текста всегда был оринтирован в сторону увеличения высоты. Эта опция позволяет размещать аннотации вверх ногами. Можно также контролировать положение аннотаций изолиний на странице, чтобы текст никогда не располагался вверх ногами.
| String |
enable_laddering (Дополнительный) | Расположение аннотаций лестницей приведет к отображению текста вверх и вниз по прямой по ступенькам изолиний. Эти ступени будут идти от вершины холма к его подножию, не пересекать друг друга, принадлежать одному склону и не пересекать какие-либо другие склоны.
| Boolean |
Пример кода
Пример ContourAnnotation (Окно Python)
Представленный автономный скрипт демонстрирует пример использования функции ContourAnnotation.
import arcpy
from arcpy import env
env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour", 50000, "ContourGroupLayer", "BLACK",
"", "PAGE", "")
Пример #2 ContourAnnotation (скрипт рабочего процесса)
Пример запускает команду ContourWithBarriers и использует выходные данные этого инструмента в качестве входных для инструмента ContourAnnotation.
# Name: ContourAnnotation_Example2.py
# Description: Create a contour with barriers feature class and then create annotation for the contours.
# Requirements: ArcGIS Spatial Analyst
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
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)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да