Сводка
Создает ряд прямоугольных полигонов или индексных объектов, который следует вдоль единственного линейного объекта или группы линейных объектов. Данные индексные объекты можно использовать вместе с сериями пространственных карт для определения страниц в маршрутной карте или наборе карт следующих вдоль линейного объекта. Результирующие объекты индекса содержат атрибуты, которые можно применять при повороте и ориентировании карты на странице и определении того, какие индексные объекты или страницы будут следующими после текущей страницы (слева и справа или сверху и снизу).
Использование
Линейные объекты не могут входить в геометрическую сеть.
Если используется параметр Использовать единицы и масштаб страницы, Масштаб карты становится обязательным параметром. Если 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. Для получения наилучших результатов единицы измерения должны соответствовать единицам измерения страницы:могут быть установлены, например, дюймы или сантиметры. Если опция Использовать единицы и масштаб страницы не выбрана, единицы измерения должны соответствовать единицам измерения карты, таким как, метры, футы, километры, мили или десятичные градусы.
Синтаксис
arcpy.cartography.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 (Дополнительный) | Определяет, в единицах ли измерения страницы вводится размер индексного объекта.
| Boolean |
scale (Дополнительный) |
Масштаб карты должен быть указан в случае, если длины индексных объектов (вдоль линии и перпендикулярно линии) вычисляются в единицах измерения страницы. Если используется ArcGIS Pro, значением по умолчанию будет масштаб активного фрейма данных, иначе используется значение по умолчанию, равное 1. | Long |
length_along_line (Дополнительный) | Длина индексного полигонального объекта по направлению входного линейного объекта может быть указана в единицах измерения карты либо единицах измерения страницы. Значение по умолчанию определяется пространственной привязкой входного линейного объекта (объектов). Это значение составляет 1/100 от протяженности входного класса объектов вдоль оси x. | Linear Unit |
length_perpendicular_to_line (Дополнительный) | Длина индексного полигонального объекта по направлению, перпендикулярному входному линейному объекту, может быть указана в единицах измерения карты либо единицах измерения страницы. Значение по умолчанию определяется пространственной привязкой входного линейного объекта (объектов). Это число составляет половину значения, используемого для длины вдоль линии. | Linear Unit |
page_orientation (Дополнительный) | Задает ориентацию входных линейных объектов в компоновке страницы.
| String |
overlap_percentage (Дополнительный) | Приблизительный процент перекрытия соседних листов карты. Значение по умолчанию равно 10. | Double |
starting_page_number (Дополнительный) | Номер начальной страницы. Каждому объекту индексной сетки присваивается порядковый номер страницы, начиная с указанного номера. Значение по умолчанию равно 1. | Long |
direction_type (Дополнительный) | Определяет начальное направление маршрутных карт.
| String |
Пример кода
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы.
import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
'USEPAGEUNIT', 500000,
'7 inches', '5 inches')
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы.
# 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)
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными в единицах измерения карты с нулевым перекрытием.
import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '',
'', '10 kilometers', '5 kilometers')
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными в единицах измерения карты с нулевым перекрытием.
# 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)
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы с использованием вертикальной ориентации страницы.
import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
'USEPAGEUNIT', 500000, '5 inches',
'7 inches', 'VERTICAL')
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы с использованием вертикальной ориентации страницы.
# 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)
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с указанием размеров объектов, указанных в единицах измерения карты, начала нумерации страниц и направления маршрутной карты.
import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '', '',
'10 kilometers', '5 kilometers',
'', '', 5, 'EW_SN')
В следующем примере создаются индексные объекты маршрутной карты на основе входных линейных объектов с указанием размеров объектов, указанных в единицах измерения карты, начала нумерации страниц и направления маршрутной карты.
# 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: Да