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

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

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

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

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

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

  • Если Выходной класс объектов-маршрутов будет записан в базу геоданных должны быть установлены соответствующие параметры среды Допуск M, Разрешение M и Домен М.

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

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

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

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

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

  • Атрибутивный индекс на поле идентификатора маршрута ускоряет процесс динамической сегментации (dynamic segmentation). Если вы будете использовать значение параметра Выходной класс объектов-маршрутов для динамической сегментации, рекомендуется выбрать создание атрибутивного индекса.

  • Если какие-либо пространственные объекты не смогут быть использованы в инструменте Создать маршруты, то во временной папке создается временный текстовый файл для хранения информации об этих объектах. Например, C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (где Create_Output – это имя выходного класса объектов маршрутов).

  • Параметр среды Выходные данные содержат M-значения будет игнорироваться. Значение параметра Выходной класс объектов-маршрутов будет содержать значения М (измерение).

Параметры

ПодписьОписаниеТип данных
Входные линейные объекты

Пространственные объекты, из которых будут сформированы маршруты.

Feature Layer
Поле идентификатора маршрута

Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут.

Field
Выходной класс объектов-маршрутов

Класс пространственных объектов, который должен быть создан. Это может быть шейп-файл или класс объектов базы геоданных.

Feature Class
Источник измерений

Определяет, каким образом будут получены измерения.

  • Длина объектов:В качестве измерений будет использоваться длина входных объектов. Это значение по умолчанию
  • Значения из одного поляДля вычисления измерений будут использоваться значения из одного поля атрибутов входных данных.
  • Значения из двух полейДля вычисления измерений будут использоваться значения из двух полей атрибутов: измерения от и до.
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

Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут.

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.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 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: Да

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