Объекты индексной сетки маршрутной карты (Картография)

Сводка

Создает ряд прямоугольных полигонов или индексных объектов, который следует вдоль единственного линейного объекта или группы линейных объектов. Данные индексные объекты можно использовать вместе с сериями пространственных карт для определения страниц в маршрутной карте или наборе карт следующих вдоль линейного объекта. Результирующие объекты индекса содержат атрибуты, которые можно применять при повороте и ориентировании карты на странице и определении того, какие индексные объекты или страницы будут следующими после текущей страницы (слева и справа или сверху и снизу).

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

  • Линейные объекты не могут входить в геометрическую сеть.

  • Если используется параметр Использовать единицы и масштаб страницы, Масштаб карты становится обязательным параметром. Если ArcGIS Pro открыт, будет использован масштаб карты активного фрейма данных, иначе используется значение по умолчанию, равное 1. Если вы задаете размер индексных объектов в пространстве карты, а параметр Использовать единицы и масштаб страницы не выбран, Масштаб карты не требуется.

  • Полученные индексные объекты имеют набор атрибутов. Эти атрибуты включают: PageNumber, GroupId, SeqId, Previous, Next, LeftPage, RightPage, TopPage, BottomPage и Angle.

    • Angle – числовое значение, выражающее угол поворота, необходимый для карты (фрейма данных) в целях выравнивания границ индексных объектов с границами листов компоновки карты. Для соблюдения картографических традиций углы рассчитываются таким образом, чтобы максимально сохранить ориентацию верхней границы листов на север. Углы рассчитываются в обратном по отношению к стандартной ориентации листов направлению: 0 градусов соответствует направлению на Север, 90 градусов – на Восток, 180 градусов – на Юг, а -90 градусов – на Запад.
    • PageNumber – порядковый номер, присвоенный каждому индексному объекту.
    • GroupId – целочисленное значение, присвоенное всем индексным объектам внутри соединенной цепи или группе линейных объектов. Результаты применения инструмента Объекты индексной сетки маршрутной карты могут включать несколько групп объектов. Обычно группа состоит из соединенных между собой линейных объектов или из одной линии с набором несоединенных частей. Индексные объекты, созданные из отдельных, несоединенных линейных объектов, будут назначены в отдельные группы. Значения GroupId являются уникальными и получаются из ObjectID первого линейного объекта в заданной цепочке.
    • SeqId – порядковый номер, присваиваемый каждому индексному объекту внутри каждой группы. Порядок присвоения номера соответствует порядку создания объекта.
    • PrevPage соответствует значению PageNumber для индексного объекта, созданного непосредственно перед текущим. Это поле используется для установления порядка создания индексных объектов. Не используйте это поле для динамического текста в сериях карт. Используйте поля LeftPage, RightPage, TopPage и BottomPage для динамического текста.
    • Next соответствует значению PageNumber для индексного объекта, созданного сразу после текущего. Это поле используется для установления порядка создания индексных объектов. Не используйте это поле для динамического текста в сериях карт. Используйте поля LeftPage, RightPage, TopPage и BottomPage для динамического текста.
    • LeftPage, RightPage, TopPage и BottomPage применяются, когда результаты используются в серии карт. LeftPage соответствует значению PageNumber индексного объекта, который появляется слева от текущего индексного объекта после применения вращения. RightPage является PageNumber индексного объекта справа. TopPage и BottomPage – значения для индексных объектов сверху и снизу соответственно.

  • Когда выбрана опция Использовать единицы и масштаб страницы, единицы измерения Длины вдоль линии и Длины перпендикулярно линии автоматически приводятся в соответствие с единицами измерения страницы, выставленными в активной компоновке (если открыт ArcGIS Pro), или с дюймами, если инструмент используется вне сеанса ArcGIS Pro. Для получения наилучших результатов единицы измерения должны соответствовать единицам измерения страницы:могут быть установлены, например, дюймы или сантиметры. Если опция Использовать единицы и масштаб страницы не выбрана, единицы измерения должны соответствовать единицам измерения карты, таким как, метры, футы, километры, мили или десятичные градусы.

Синтаксис

StripMapIndexFeatures(in_features, out_feature_class, {use_page_unit}, {scale}, {length_along_line}, {length_perpendicular_to_line}, {page_orientation}, {overlap_percentage}, {starting_page_number}, {direction_type})
ParameterОбъяснениеТип данных
in_features

Входные полилинейные объекты, которые определяют направление построения индексных объектов маршрутной карты.

Feature Layer
out_feature_class

Выходной класс пространственных объектов, содержащий полигональные индексные объекты.

Feature Class
use_page_unit
(Дополнительный)

Определяет, в единицах ли измерения страницы вводится размер индексного объекта.

  • USEPAGEUNITВысота и ширина индексного полигона вычисляются в единицах измерения страницы.
  • NO_USEPAGEUNITВысота и ширина индексного полигона вычисляются в единицах измерения карты. Это значение по умолчанию.
Boolean
scale
(Дополнительный)

Масштаб карты должен быть указан в случае, если длины индексных объектов (вдоль линии и перпендикулярно линии) вычисляются в единицах измерения страницы. Если используется ArcGIS Pro, значением по умолчанию будет масштаб активного фрейма данных, иначе используется значение по умолчанию, равное 1.

Long
length_along_line
(Дополнительный)

Длина индексного полигонального объекта по направлению входного линейного объекта может быть указана в единицах измерения карты либо единицах измерения страницы. Значение по умолчанию определяется пространственной привязкой входного линейного объекта (объектов). Это значение составляет 1/100 от протяженности входного класса объектов вдоль оси x.

Linear Unit
length_perpendicular_to_line
(Дополнительный)

Длина индексного полигонального объекта по направлению, перпендикулярному входному линейному объекту, может быть указана в единицах измерения карты либо единицах измерения страницы. Значение по умолчанию определяется пространственной привязкой входного линейного объекта (объектов). Это число составляет половину значения, используемого для длины вдоль линии.

Linear Unit
page_orientation
(Дополнительный)

Задает ориентацию входных линейных объектов в компоновке страницы.

  • VERTICALНаправление построения индексных объектов маршрутной карты на листе – сверху вниз
  • HORIZONTALНаправление построения индексных объектов маршрутной карты на листе – слева направо. Это значение по умолчанию.
String
overlap_percentage
(Дополнительный)

Приблизительный процент перекрытия соседних листов карты. Значение по умолчанию равно 10.

Double
starting_page_number
(Дополнительный)

Номер начальной страницы. Каждому объекту индексной сетки присваивается порядковый номер страницы, начиная с указанного номера. Значение по умолчанию равно 1.

Long
direction_type
(Дополнительный)

Определяет начальное направление маршрутных карт.

  • WE_NSЕсли линия имеет направляющий тренд с запада на восток, то начальная точка будет находиться на самом западном конце линии, а если линия имеет направляющий тренд с севера на юг, то начальная точка будет находиться на самом северном конце линии. Это значение по умолчанию.
  • WE_SNЕсли линия имеет направляющий тренд с запада на восток, то начальная точка будет находиться на самом западном конце линии, а если линия имеет направляющий тренд с юга на север, то начальная точка будет находиться на самом южном конце линии.
  • EW_NSЕсли линия имеет направляющий тренд с востока на запад, то начальная точка будет находиться на самом восточном конце линии, а если линия имеет направляющий тренд с севера на юг, то начальная точка будет находиться на самом северном конце линии.
  • EW_SNЕсли линия имеет направляющий тренд с востока на запад, то начальная точка будет находиться на самом восточном конце линии, а если линия имеет направляющий тренд с юга на север, то начальная точка будет находиться на самом южном конце линии.
String

Пример кода

StripMapIndexFeatures, пример 1 (окно Python)

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

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
                                        'USEPAGEUNIT', 500000,
                                        '7 inches', '5 inches')
StripMapIndexFeatures, пример 2 (автономный скрипт)

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

# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout page.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "500000"
lenA = "7 Inches"
lenP = "5 Inches"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography(inFeatures, outFeatureClass,
                                        usePageUnit, scale, lenA, lenP)
StripMapIndexFeatures, пример 3 (окно Python)

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

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '',
                                        '', '10 kilometers', '5 kilometers')
StripMapIndexFeatures, пример 4 (автономный скрипт)

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

# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified in map units with an
# overlap set at 0.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
lenA = "10 Kilometers"
lenP = "5 Kilometers"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography(inFeatures, outFeatureClass, "",
                                        "", lenA, lenP)
StripMapIndexFeatures, пример 5 (окно Python)

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

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
                                        'USEPAGEUNIT', 500000, '5 inches',
                                        '7 inches', 'VERTICAL')
StripMapIndexFeatures, пример 6 (автономный скрипт)

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

# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout and
# the page orientation set as vertical.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "500000"
lenA = "7 Inches"
lenP = "5 Inches"
pageOrientation = "VERTICAL"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography(inFeatures, outFeatureClass,
                                        usePageUnit, scale, lenA, lenP,
                                        pageOrientation)
StripMapIndexFeatures, пример 7 (окно Python)

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

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '', '',
                                        '10 kilometers', '5 kilometers',
                                        '', '', 5, 'EW_SN')
StripMapIndexFeatures, пример 8 (автономный скрипт)

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

# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified in map units, the
# starting page number is 5 and the strip map direction is
# East-West/South-North.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
lenA = "10 Kilometers"
lenP = "5 Kilometers"
startingPageNum = "5"
directionType = "EW_SN"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography(inFeatures, outFeatureClass, "", "",
                                        lenA, lenP, "", "", startingPageNum,
                                        directionType)

Environments

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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