Подпись | Описание | Тип данных |
Входные линейные объекты | Пространственные объекты, из которых будут сформированы маршруты. | Feature Layer |
Поле идентификатора маршрута | Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. | Field |
Выходной класс объектов-маршрутов | Класс пространственных объектов, который должен быть создан. Это может быть шейп-файл или класс объектов базы геоданных. | Feature Class |
Источник измерений | Определяет, каким образом будут получены измерения.
| String |
Поле измерения "От" (Дополнительный) | Поле, содержащее значения измерений. Это поле должно быть числовым и обязательным, если источником измерения являются Значения из одного поля или значения из двух полей. | Field |
Поле измерения "До" (Дополнительный) | Поле, содержащее значения измерений. Это поле должно быть числовым, и используется, когда источник измерения Значения из двух полей. | Field |
Приоритет координат (Дополнительный) | Точка, от которой будет вестись отсчет измерений. Этот параметр не учитывается, если в качестве источника измерений используется Значения из двух полей.
| String |
Коэффициент измерения (Дополнительный) | Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1. | Double |
Сдвиг измерения (Дополнительный) | Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. По умолчанию - 0. | Double |
Игнорировать разрывы (Дополнительный) |
Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если в качестве источника измерений используется Длина объектов или Значения из одного поля.
| Boolean |
Построить индекс (Дополнительный) | Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов.
| Boolean |
Краткая информация
Создает маршруты из существующих линий. Входные линейные объекты, имеющие общий идентификатор, объединяются в единый объект-маршрут.
Использование
Уникальные значения в Поле идентификатора маршрута записываются в Выходной класс объектов-маршрутов.
Используйте инструменты Создать векторный слой или Создать таблицу запроса, чтобы эффективно уменьшить количество линий, которые будут использоваться при создании маршрутов.
Если Выходной класс объектов-маршрутов будет записан в базу геоданных должны быть установлены соответствующие параметры среды Допуск M, Разрешение M и Домен М.
Используйте коэффициент измерения для конвертации между единицами измерений маршрута. Например, чтобы конвертировать футы в мили, используйте коэффициент 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 | Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. | Field |
out_feature_class | Класс пространственных объектов, который должен быть создан. Это может быть шейп-файл или класс объектов базы геоданных. | Feature Class |
measure_source | Определяет, каким образом будут получены измерения.
| String |
from_measure_field (Дополнительный) | Поле, содержащее значения измерений. Это поле должно быть числовым, и используется, когда источник измерения ONE_FIELD или TWO_FIELDS. | Field |
to_measure_field (Дополнительный) | Поле, содержащее значения измерений. Это поле должно быть числовым, и используется, когда источник измерения TWO_FIELDS. | Field |
coordinate_priority (Дополнительный) | Точка, от которой будет вестись отсчет измерений. Этот параметр не учитывается, если в качестве источника измерений используется TWO_FIELDS.
| String |
measure_factor (Дополнительный) | Число, на которое будет умножена длина каждой входной линии перед их слиянием для формирования маршрута. Значение по умолчанию равно 1. | Double |
measure_offset (Дополнительный) | Число, которое будет добавлено к измерениям маршрута после слияния исходных линий для создания маршрута. По умолчанию - 0. | Double |
ignore_gaps (Дополнительный) | Определяет, будут ли учитываться пространственные разрывы при вычислении измерений для разорванных маршрутов. Этот параметр будет использоваться, если в качестве источника измерений используется LENGTH или ONE_FIELD.
| Boolean |
build_index (Дополнительный) | Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в выходной класс объектов маршрутов.
| Boolean |
Пример кода
Пример скрипта окна Python для использования функции CreateRoutes с запуском из окна Python.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#",
"LOWER_LEFT", 0.00018939394)
Следующий автономный скрипт демонстрирует порядок использования функции 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 с данными файловой базы геоданных.
# 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")
Следующий автономный скрипт 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
# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да