Создать маршруты

Сводка

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

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

• Уникальные значения в Поле идентификатора маршрута записываются в Выходной класс объектов-маршрутов.

• Используйте инструменты Создать векторный слой (Make Feature Layer) или Создать таблицу запроса (Make Query Table), чтобы значительно сократить число линий, используемых для создания маршрутов.

• Если Выходной класс объектов-маршрутов (Output Route Feature Class) записывается в базу геоданных, следует установить соответствующие параметры среды – Допуск М (M Tolerance), Разрешение M (M Resolution) и Домен М (M Domain).

• Используйте коэффициент измерения для конвертации между единицами измерений маршрута. Например, чтобы конвертировать футы в мили, используйте коэффициент 0.00018939394.

• Используйте Сдвиг измерения в случаях, где значение начального измерения каждого маршрута должно быть отличным от 0.

• Параметр Игнорировать пространственные разрывы не используется, если была определена опция TWO_FIELDS в Источник измерений. Это происходит потому, что значения измерений определяются значениями Поле измерения От и Поле измерения До.

• Если используются значения LENGTH или ONE_FIELD для Источник измерений, то Приоритет координат определяется путем размещения минимального прямоугольника, охватывающего входные объекты, которые будут объединяться в единый маршрут.

• Если используется опция TWO_FIELDS в Источник измерений, то приоритет координат указывать необязательно, так как направление измерений берется на основании значений Поле измерений От и Поле измерений До.

• Атрибутивный индекс на поле идентификатора маршрута ускоряет процесс динамической сегментации (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	Определяет, каким образом будут получены измерения. 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)

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

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

# Name: CreateRoutes_Example5.py
# Description: Create routes from lines. The lines are in a personal 
# 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.mdb"
# 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")

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

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

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

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