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

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

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

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

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

Параметры

Подпись	Описание	Тип данных
Входные линейные объекты	Пространственные объекты, из которых будут сформированы маршруты.	Feature Layer
Поле идентификатора маршрута	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID.	Field
Выходной класс объектов-маршрутов	Класс пространственных объектов, который будет создан. Это может быть шейп-файл или класс объектов базы геоданных.	Feature Class
Источник измерений	Поле может быть числовым, текстовым или GUID. Длина объектов:—В качестве измерений будет использоваться длина входных объектов. Это значение по умолчанию Значения из одного поля—Для вычисления измерений будут использоваться значения из одного поля атрибутов входных данных. Значения из двух полей—Для накопления измерений будут использоваться значения из двух полей атрибутов: измерения от и до.	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	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID.	Field
out_feature_class	Класс пространственных объектов, который будет создан. Это может быть шейп-файл или класс объектов базы геоданных.	Feature Class
measure_source	Поле может быть числовым, текстовым или GUID. 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.lr.CreateRoutes(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" 

# Run CreateRoutes
arcpy.lr.CreateRoutes(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

# Run CreateRoutes
arcpy.lr.CreateRoutes(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 stand-alone 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 stand-alone feature class

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

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

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

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

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

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

Отзыв по этому разделу?