Создать маршруты (Системы линейных координат)—ArcGIS Pro

Краткая информация

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

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

Уникальные значения в Поле идентификатора маршрута записываются в Выходной класс объектов-маршрутов.
Используйте инструменты Создать векторный слой или Создать таблицу запроса, чтобы эффективно уменьшить количество линий, которые будут использоваться при создании маршрутов.
Если Выходной класс объектов-маршрутов будет записан в базу геоданных должны быть установлены соответствующие параметры среды Допуск M, Разрешение M и Домен М.
Используйте коэффициент измерения для конвертации между единицами измерений маршрута. Например, чтобы конвертировать футы в мили, используйте коэффициент 0.00018939394.
Используйте Сдвиг измерения в случаях, где значение начального измерения каждого маршрута должно быть отличным от 0.
Параметр Игнорировать пространственные разрывы не используется, если была определена опция Значения из двух полей в Источник измерений. Это происходит потому, что значения измерений определяются значениями Поле измерения От и Поле измерения До.
Если используется опция Длина объектов или Значения из одного поля в Источник измерений, то Приоритет координат определяется путем размещения минимального прямоугольника, охватывающего входные объекты, которые будут объединяться в единый маршрут.
Если используется опция Значения из двух полейв Источник измерений, приоритет координат указывать необязательно, так как направление измерений берется на основании значений Поле измерений От и Поле измерений До.
Атрибутивный индекс на поле идентификатора маршрута ускоряет процесс динамической сегментации (dynamic segmentation). Если вы будете использовать значение параметра Выходной класс объектов-маршрутов для динамической сегментации, рекомендуется выбрать создание атрибутивного индекса.
Если какие-либо пространственные объекты не смогут быть использованы в инструменте Создать маршруты, то во временной папке создается временный текстовый файл для хранения информации об этих объектах. Например, C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (где Create_Output – это имя выходного класса объектов маршрутов).
Параметр среды Выходные данные содержат M-значения будет игнорироваться. Значение параметра Выходной класс объектов-маршрутов будет содержать значения М (измерение).

Параметры

Подпись	Описание	Тип данных
Входные линейные объекты	Пространственные объекты, из которых будут сформированы маршруты.	Feature Layer
Поле идентификатора маршрута	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут.	Field
Выходной класс объектов-маршрутов	Класс пространственных объектов, который должен быть создан. Это может быть шейп-файл или класс объектов базы геоданных.	Feature Class
Источник измерений	Определяет, каким образом будут получены измерения. Длина объектов:—В качестве измерений будет использоваться длина входных объектов. Используется по умолчанию. Значения из одного поля—Для вычисления измерений будут использоваться значения из одного поля атрибутов входных данных. Значения из двух полей—Для вычисления измерений будут использоваться значения из двух полей атрибутов: измерения от и до.	String
Поле измерения "От" (Дополнительный)	Поле, содержащее значения измерений. Это поле должно быть числовым и обязательным, если источником измерения являются Значения из одного поля или значения из двух полей.	Field
Поле измерения "До" (Дополнительный)	Поле, содержащее значения измерений. Это поле должно быть числовым, и используется, когда источник измерения Значения из двух полей.	Field
Приоритет координат (Дополнительный)	Точка, от которой будет вестись отсчет измерений. Этот параметр не учитывается, если в качестве источника измерений используется Значения из двух полей. Левый верхний угол—Вычисление измерений будет производиться от ближайшей к левому верхнему углу минимального ограничивающего прямоугольника точки. Используется по умолчанию. Левый нижний угол—Вычисление измерений будет производиться от ближайшей к левому нижнему углу минимального ограничивающего прямоугольника точки. Правый верхний угол—Вычисление измерений будет производиться от ближайшей к правому верхнему углу минимального ограничивающего прямоугольника точки. Правый нижний угол—Вычисление измерений будет производиться от ближайшей к правому нижнему углу минимального ограничивающего прямоугольника точки.	String
Коэффициент измерения (Дополнительный)	Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1.	Double
Сдвиг измерения (Дополнительный)	Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. Значение по умолчанию равно 0.	Double
Игнорировать разрывы (Дополнительный)	Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если в качестве источника измерений используется Длина объектов или Значения из одного поля. Отмечено – разрывы будут проигнорированы. Для разорванных маршрутов измерения будут непрерывными. Используется по умолчанию. Не отмечено – разрывы маршрутов не будут проигнорированы. Значения измерений на разорванных маршрутах также будут иметь разрывы. Величина разрыва будет вычисляться как расстояние по прямой между конечными точками частей разорванного маршрута.	Boolean
Построить индекс (Дополнительный)	Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов. Отмечено – создается атрибутивный индекс. Используется по умолчанию. Не отмечено – атрибутивный индекс не создается.	Boolean

arcpy.lr.CreateRoutes(in_line_features, route_id_field, out_feature_class, measure_source, {from_measure_field}, {to_measure_field}, {coordinate_priority}, {measure_factor}, {measure_offset}, {ignore_gaps}, {build_index})

Имя	Описание	Тип данных
in_line_features	Пространственные объекты, из которых будут сформированы маршруты.	Feature Layer
route_id_field	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут.	Field
out_feature_class	Класс пространственных объектов, который должен быть создан. Это может быть шейп-файл или класс объектов базы геоданных.	Feature Class
measure_source	Определяет, каким образом будут получены измерения. LENGTH—В качестве измерений будет использоваться длина входных объектов. Используется по умолчанию. ONE_FIELD—Для вычисления измерений будут использоваться значения из одного поля атрибутов входных данных. TWO_FIELDS—Для вычисления измерений будут использоваться значения из двух полей атрибутов: измерения от и до.	String
from_measure_field (Дополнительный)	Поле, содержащее значения измерений. Это поле должно быть числовым, и используется, когда источник измерения ONE_FIELD или TWO_FIELDS.	Field
to_measure_field (Дополнительный)	Поле, содержащее значения измерений. Это поле должно быть числовым, и используется, когда источник измерения TWO_FIELDS.	Field
coordinate_priority (Дополнительный)	Точка, от которой будет вестись отсчет измерений. Этот параметр не учитывается, если в качестве источника измерений используется TWO_FIELDS. UPPER_LEFT—Вычисление измерений будет производиться от ближайшей к левому верхнему углу минимального ограничивающего прямоугольника точки. Используется по умолчанию. LOWER_LEFT—Вычисление измерений будет производиться от ближайшей к левому нижнему углу минимального ограничивающего прямоугольника точки. UPPER_RIGHT—Вычисление измерений будет производиться от ближайшей к правому верхнему углу минимального ограничивающего прямоугольника точки. LOWER_RIGHT—Вычисление измерений будет производиться от ближайшей к правому нижнему углу минимального ограничивающего прямоугольника точки.	String
measure_factor (Дополнительный)	Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1.	Double
measure_offset (Дополнительный)	Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. Значение по умолчанию равно 0.	Double
ignore_gaps (Дополнительный)	Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если в качестве источника измерений используется LENGTH или ONE_FIELD. IGNORE—Разрывы будут проигнорированы. Для разорванных маршрутов измерения будут непрерывными. Используется по умолчанию. NO_IGNORE—Не игнорировать разрывы маршрутов. Значения измерений на разорванных маршрутах также будут иметь разрывы. Величина разрыва будет вычисляться как расстояние по прямой между конечными точками частей разорванного маршрута.	Boolean
build_index (Дополнительный)	Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов. INDEX—Создается атрибутивный индекс. Используется по умолчанию. NO_INDEX—Атрибутивный индекс не создается.	Boolean

Пример кода

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

Пример скрипта окна Python для использования функции CreateRoutes с запуском из окна Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", 
                      "LOWER_LEFT", 0.00018939394)

CreateRoutes, пример 2 (автономный скрипт)

Следующий автономный скрипт демонстрирует порядок использования функции CreateRoutes с данными шейп-файлов.

# Name CreateRoutes_Example2.py
# Description: Create routes from lines. The lines are in a shapefile workspace.
# The LENGTH option will be used to set the measures, and a measure factor
# will be used to convert measure units from feet to miles.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
in_lines = "base_roads.shp"
rid = "route1" 
out_routes = "create_output1" 
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "LENGTH", "#", "#", 
                      "LOWER_LEFT", 0.00018939394)

CreateRoutes, пример 3 (автономный скрипт)

Следующий автономный скрипт демонстрирует порядок использования функции CreateRoutes с данными файловой базы геоданных.

# Name CreateRoutes_Example3.py
# Description: Create routes from lines. The lines are in a file geodatabase.
# The ONE_FIELD option will be used to set the measures.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
in_lines = "roads/base_roads"  # base_roads exists in the roads feature dataset
rid = "route1"
m_fld = "len_mile"
out_routes = "roads/create_output2"  # write result to the roads feature dataset
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", 
                      "LOWER_LEFT")

CreateRoutes, пример 4 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции CreateRoutes с данными многопользовательской базы геоданных.

# Name CreateRoutes_Example4.py
# Description:  Create routes from lines. The lines are in an enterprise 
# geodatabase. The TWO_FIELD option will be used to set the measures.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
# base_roads is a standalone feature class
in_lines = arcpy.ValidateTableName("base_roads", wkspc)
rid = "route1"
fr_fld = "begmp1"
to_fld = "endmp1" 
out_routes = "create_output3"  # write the result to a standalone feature class
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

Параметры среды

Текущая рабочая область, Разрешение M, Допуск M, Выходное ключевое слово CONFIG, Выходной домен M, Выходной XY домен, Выходной домен Z, Выходная система координат, Экстент, Выходные данные имеют Z-значения, Временная рабочая область

Краткая информация

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

Параметры

Пример кода

Параметры среды

Особые случаи

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

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

В этом разделе