Краткая информация
Создает ряд прямоугольных полигонов или индексных объектов, который следует вдоль единственного линейного объекта или группы линейных объектов. Данные индексные объекты можно использовать вместе с многостраничной компоновкой в маршрутной карте или наборе карт, следующих вдоль линейного объекта. Результирующие объекты индекса содержат атрибуты, которые можно применять при повороте и ориентировании карты на странице и определении того, какие индексные объекты или страницы будут следующими после текущей страницы (слева и справа или сверху и снизу).
Использование
Система координат выходного класса пространственных объектов определяется следующим образом:
- Если определен параметр Выходная система координат (Output Coordinate System в Параметрах среды (Environment Settings), выходному классу объектов присваивается эта система координат.
- Если параметр Выходная система координат (Output Coordinate System) не определен, выходной класс объектов использует систему координат входного класса объектов.
Только линейные объекты допустимы в качестве исходных данных.
Если выбрана опция Использовать единицы и масштаб страницы (Use Page Unit and Scale Map), Масштаб карты (Map Scale) является обязательным параметром. Если ArcMap открыт, будет использован масштаб карты активного фрейма данных, если не открыт - значение по умолчанию равно 1. Если вы указываете размер индексных объектов в пространстве карты и опция Использовать единицы и масштаб страницы (Use Page Unit and Scale) не выбрана, параметр Масштаб карты (Map Scale) не нужен.
Полученные индексные объекты имеют набор атрибутов. PageNumber, GroupId, SeqId, PrevPage, NextPage, LeftPage, RightPage, TopPage, BottomPage и Angle.
- Angle - числовое значение, выражающее угол поворота, необходимый для карты (фрейма данных) в целях выравнивания границ индексных объектов с границами листов компоновки карты. В целях соблюдения картографических традиций углы рассчитываются таким образом, чтобы максимально сохранить ориентацию верхней границы листов на север. Углы рассчитываются в обратном по отношению к стандартной ориентации листов направлению:0 градусов соответствует направлению на Север, 90 градусов - на Восток, 180 градусов - на Юг, а -90 градусов - на Запад.
- PageNumber - порядковый номер, присвоенный каждому индексному объекту.
- GroupId - целочисленное значение, присвоенное всем индексным объектам внутри соединенной цепи или группе линейных объектов. Результаты применения инструмента Класс объектов индексной сетки маршрутной карты (Strip Map Index Features) могут включать несколько групп объектов. Обычно группа состоит из соединенных между собой линейных объектов или из одной линии с набором несоединенных частей. Индексные объекты, создаваемые из отдельных, несоединенных между собой линий, будут относиться к отдельным группам. Значения GroupId являются уникальными и высчитываются, исходя из OID первого в цепочке линейного объекта.
- SeqId - порядковый номер, присваиваемый каждому индексному объекту внутри каждой группы.Порядок присвоения номера соответствует порядку создания объекта.
- PrevPage соответствует значению PageNumber для индексного объекта, созданного непосредственно перед текущим. Это поле используется для установления порядка создания индексных объектов. Не используйте это поле для динамического текста в многостраничной компоновке. Для динамического текста используйте поля LeftPage, RightPage, TopPage и BottomPage.
- NextPage соответствует значению PageNumber для индексного объекта, созданного сразу после текущего. Это поле используется для установления порядка создания индексных объектов. Не используйте это поле для динамического текста в многостраничной компоновке. Для динамического текста используйте поля LeftPage, RightPage, TopPage и BottomPage.
- Поля LeftPage, RightPage, TopPage, и BottomPage могут использоваться в многостраничной компоновке. LeftPage соответствует значению PageNumber индексного объекта, которое появляется слева от текущего индексного объекта после применения вращения. RightPage соответствует значению PageNumber правого, по отношению к текущему, индексного объекта. TopPage и BottomPage - соответственно, номера правого и левого объекта по отношению к текущему.
Когда выбрана опция Использовать единицы и масштаб страницы (Use Page Unit and Scale), единицы измерения Длины вдоль линии (Length Along the Line) и Длины перпендикуляра к линии (Length Perpendicular to the Line) автоматически приводятся в соответствие с единицами измерения страницы, выставленными в активном документе карты (если открыт ArcMap).В случае использования инструмента вне сессии ArcMap единицами измерения считаются дюймы. Для получения наилучших результатов единицы измерения должны соответствовать единицам измерения страницы:могут быть установлены, например, дюймы или сантиметры. Если опция Использовать единицы и масштаб страницы (Use Page Units and Scale) не выбрана, единицы измерения должны соответствовать единицам измерения карты:могут быть установлены, например, метры, футы, километры, мили или десятичные градусы.
Синтаксис
StripMapIndexFeatures_cartography (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})| Параметр | Объяснение | Тип данных |
in_features | Входная полилиния или несколько полилиний, которые определяют направление построения индексных объектов маршрутной карты. | Feature Layer |
out_feature_class | Выходной класс пространственных объектов, содержащий полигональные индексные объекты. Система координат выходного класса пространственных объектов определяется следующим образом:
| Feature Class |
use_page_unit (дополнительно) | Указывает, в единицах ли измерения страницы вводится размер индексных объектов. Значение по умолчанию - NO_USEPAGEUNIT.
| Boolean |
scale (дополнительно) | Масштаб карты должен быть указан в случае, если длины индексных объектов (вдоль линии и перпендикулярно линии) вычисляются в единицах измерения страницы. Если открыт ArcMap, значением по умолчанию будет масштаб активного фрейма данных. Если ArcMap не открыт, значение по умолчанию равно 1. | Long |
length_along_line (дополнительно) | Длина индексного полигонального объекта по направлению входного линейного объекта может быть указана в единицах измерения карты либо единицах измерения страницы. Значение по умолчанию определяется пространственной привязкой входного линейного объекта (объектов). Это значение составляет 1/100 от протяженности входного класса объектов вдоль оси X. | Linear unit |
length_perpendicular_to_line (дополнительно) | Длина индексного полигонального объекта по направлению, перпендикулярному входному линейному объекту, может быть указана в единицах измерения карты либо единицах измерения страницы. Значение по умолчанию определяется пространственной привязкой входного линейного объекта (объектов). Это число составляет 1/2 от значения, используемого для длины вдоль линии. | Linear unit |
page_orientation (дополнительно) | Используется для определения ориентации входных линейных объектов в компоновке страницы. Значение по умолчанию - HORIZONTAL.
| String |
overlap_percentage (дополнительно) | Приблизительный процент перекрытия соседних листов карты. Значение по умолчанию равно 10. | Double |
starting_page_number (дополнительно) | Каждому индексному объекту сетки присваивается порядковый номер страницы, начиная с указанного номера. Значение по умолчанию равно 1. | Long |
direction_type (дополнительно) | Индексные объекты создаются в порядке возрастания, поэтому необходима стартовая точка. Установка типа направления маршрутной карты обеспечивает стартовую точку. Значение по умолчанию - WE_NS. Такое значение означает, что стартовая точка маршрутной карты является либо западным концом линейного объекта - в случае, если линия направлена с Запада на Восток (с Востока на Запад), либо северным концом линейного объекта - для линий, направленных с Севера на Юг (с Юга на Север). Тип направления применяется также для второстепенных линейных объектов.
| String |
Пример кода
Пример 1 инструмента StripMapIndexFeatures (окно Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures",
USEPAGEUNIT, "500000",
"7 inches", "5 inches")
Пример 1 инструмента StripMapIndexFeatures (автономный скрипт Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы.
# stripmapindexfeatures_example1.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout page.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# 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)
Пример 2 инструмента StripMapIndexFeatures (окно Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными в единицах измерения карты с нулевым перекрытием.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "",
"", "10 kilometers", "5 kilometers")
Пример 2 инструмента StripMapIndexFeatures (автономный скрипт Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными в единицах измерения карты с нулевым перекрытием.
# stripmapindexfeatures_example2.py
# 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.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# 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)
Пример 3 инструмента StripMapIndexFeatures (окно Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы с использованием вертикальной ориентации страницы.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures",
USEPAGEUNIT, "500000", "5 inches",
"7 inches", VERTICAL)
Пример 3 инструмента StripMapIndexFeatures (автономный скрипт Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с размерами объектов, указанными для компоновки страницы с использованием вертикальной ориентации страницы.
# stripmapindexfeatures_example3.py
# 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.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# 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 #4 (Окно Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с указанием размеров объектов, указанных в единицах измерения карты, начала нумерации страниц и направления маршрутной карты.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "", "",
"10 kilometers", "5 kilometers",
"", "", "5", "EW_SN")
Пример инструмента StripMapIndexFeatures #4 (автономный скрипт Python)
Создает индексные объекты маршрутной карты на основе входных линейных объектов с указанием размеров объектов, указанных в единицах измерения карты, начала нумерации страниц и направления маршрутной карты.
# stripmapindexfeatures_example4.py
# 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.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# 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)
Параметры среды
Этот инструмент не использует параметры среды геообработки
Информация о лицензировании
- ArcGIS for Desktop Basic: Да
- ArcGIS for Desktop Standard: Да
- ArcGIS for Desktop Advanced: Да