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

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

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

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

Уникальные значения в параметре Поле идентификатора маршрута записываются в параметр Выходной класс объектов маршрутов.
Используйте инструменты Создать векторный слой или Создать таблицу запроса, чтобы уменьшить число линий, которые будут использоваться при создании маршрутов.
Если Выходной класс объектов-маршрутов будет записан в базу геоданных, задайте соответствующие параметры среды Допуск M, Разрешение M, и Домен М.
При установке длины объектов в качестве источника измерения для накапливания измерений с помощью геометрических длин, доступны 2D и 3D длины. Для значений длины 2D используется длина объекта. Для значений длины 3D создайте правило атрибута расчета для нового поля с триггерами вставки или обновления, которое возвращает функцию ArcGIS Arcade 'Length3D'.

Узнайте больше о создании правил атрибутов и управлении ими
Используйте параметр Коэффициент измерения для конвертации между единицами измерений маршрута. Например, чтобы конвертировать футы в мили, используйте коэффициент 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 (Дополнительный)	Поле, содержащее значения измерений. Этот параметр обязателен, если значением параметра `measure_source` является `ONE_FIELD` или `TWO_FIELDS`.	Field
to_measure_field (Дополнительный)	Числовое поле, содержащее значения измерений. Этот параметр является обязательным, если значением параметра `measure_source` является `TWO_FIELDS`.	Field
coordinate_priority (Дополнительный)	Указывает позицию, от которой будет вестись отсчет измерений. Этот параметр игнорируется, если значением параметра `measure_source` является `TWO_FIELDS`. `UPPER_LEFT`–Вычисление измерений будет производиться от ближайшей к левому верхнему углу минимального ограничивающего прямоугольника точки. Используется по умолчанию. `LOWER_LEFT`–Вычисление измерений будет производиться от ближайшей к левому нижнему углу минимального ограничивающего прямоугольника точки. `UPPER_RIGHT`–Вычисление измерений будет производиться от ближайшей к правому верхнему углу минимального ограничивающего прямоугольника точки. `LOWER_RIGHT`–Вычисление измерений будет производиться от ближайшей к правому нижнему углу минимального ограничивающего прямоугольника точки.	String
measure_factor (Дополнительный)	Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1.	Double
measure_offset (Дополнительный)	Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. Значение по умолчанию равно 0.	Double
ignore_gaps (Дополнительный)	Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если значением параметра `measure_source` является `LENGTH` или `ONE_FIELD`. `IGNORE`–Пространственные разрывы будут проигнорированы. Для разорванных маршрутов измерения будут непрерывными. Используется по умолчанию. `NO_IGNORE`–Пространственные разрывы будут проигнорированы. Значения измерений на разорванных маршрутах также будут иметь разрывы. Величина разрыва будет вычисляться как расстояние по прямой между конечными точками частей разорванного маршрута.	Boolean
build_index (Дополнительный)	Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов. `INDEX`–Будет создан атрибутивный индекс. Используется по умолчанию. `NO_INDEX`–Не будет создан атрибутивный индекс.	Boolean

Пример кода

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

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

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

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

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

# 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", None, None,
                      "LOWER_LEFT", 0.00018939394)

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

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

# 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, None,
                      "LOWER_LEFT")

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

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

# Description:  Create routes from lines. The lines are in an enterprise
# geodatabase. The TWO_FIELDS 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, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Выходная система координат, Экстент, Выходные данные содержат Z значения, Временная рабочая область

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