| Подпись | Описание | Тип данных |
Входные линейные объекты | Пространственные объекты, из которых будут сформированы маршруты. | Feature Layer |
Поле идентификатора маршрута | Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID. | Field |
Выходной класс объектов-маршрутов | Класс пространственных объектов, который будет создан. Класс объектов может быть шейп-файлом или классом объектов базы геоданных. | Feature Class |
Источник измерений | Поле может быть числовым, текстовым или GUID.
| String |
Поле измерения "От" (Дополнительный) | Поле, содержащее значения измерений. Этот параметр является обязательным, если значением параметра Источник измерения являются Значения из одного поля или Значения из двух полей. | Field |
Поле измерения "До" (Дополнительный) | Числовое поле, содержащее значения измерений. Этот параметр является обязательным, если значением параметра Источник измерения является Значения из двух полей. | Field |
Приоритет координат (Дополнительный) | Указывает позицию, от которой будет вестись отсчет измерений. Этот параметр игнорируется, если значением параметра Источник измерения является Значения из двух полей.
| String |
Коэффициент измерения (Дополнительный) | Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1. | Double |
Сдвиг измерения (Дополнительный) | Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. По умолчанию - 0. | Double |
Игнорировать разрывы (Дополнительный) | Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если значением параметра Источник измерений является Длина объектов или Значения из одного поля.
| Boolean |
Построить индекс (Дополнительный) | Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов.
| Boolean |
Краткая информация
Создает маршруты из существующих линий. Входные линейные объекты, имеющие общий идентификатор, будут объединены в единый объект-маршрут.
Использование
Уникальные значения в параметре Поле идентификатора маршрута записываются в параметр Выходной класс объектов маршрутов.
Используйте инструменты Создать векторный слой или Создать таблицу запроса, чтобы уменьшить количество линий, которые будут использоваться при создании маршрутов.
Если Выходной класс объектов-маршрутов будет записан в базу геоданных, задайте соответствующие параметры среды Допуск M, Разрешение M и Домен М.
При установке длины объектов в качестве источника измерения для накапливания измерений с помощью геометрических длин, доступны 2D и 3D длины. Для значений 2D длины используйте длину объекта. Для значений 3D длины создайте правило вычисления атрибутов на новом поле с триггерами на вставку или обновление, которые возвращают функцию Length3D ArcGIS Arcade.
Используйте параметр Коэффициент измерения для конвертации между единицами измерений маршрута. Например, чтобы конвертировать футы в мили, используйте коэффициент 0.00018939394.
Используйте значение параметра Сдвиг измерения в случаях, где значение начального измерения каждого маршрута должно быть отличным от 0.
Параметр Игнорировать пространственные разрывы не используется, если для параметра Источник измерений задано Значения из двух полей. Это происходит потому, что значения измерений определяются значениями Поле измерения От и Поле измерения До.
Если для параметра Источник измерений заданы Длина объектов или Значения из одного поля, то значение параметра Приоритет координат определяется путем размещения минимального прямоугольника, охватывающего входные объекты, которые будут объединяться в единый маршрут.
Если для параметра Источник измерений задано Значения из двух полей, то приоритет координат указывать необязательно, так как направление измерений берется на основании значений Поле измерений От и Поле измерений До.
Атрибутивный индекс на поле идентификатора маршрута ускоряет процесс динамической сегментации (dynamic segmentation). Если вы будете использовать значение параметра Выходной класс объектов-маршрутов для динамической сегментации, рекомендуется создать атрибутивный индекс.
Если какие-либо пространственные объекты обрабатываются с помощью этого инструмента, создается временный текстовый файл для хранения информации об этих объектах, например, C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (где Create_Output - это имя выходного класса объектов маршрутов).
Параметр среды Выходные данные содержат M-значения будет игнорироваться. Значение параметра Выходной класс объектов-маршрутов будет содержать значения М (значения измерений).
Параметры
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.
| 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.
| String |
measure_factor (Дополнительный) | Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1. | Double |
measure_offset (Дополнительный) | Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. По умолчанию - 0. | Double |
ignore_gaps (Дополнительный) | Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если значением параметра measure_source является LENGTH или ONE_FIELD.
| Boolean |
build_index (Дополнительный) | Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов.
| Boolean |
Пример кода
Скрипт окна Python, демонстрирующий использование функции CreateRoutes.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", None, None,
"LOWER_LEFT", 0.00018939394)Следующий автономный скрипт Python демонстрирует порядок использования функции 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)Следующий автономный скрипт Python демонстрирует порядок использования функции 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")Следующий автономный скрипт Python демонстрирует использование функции 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)Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да