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

Уровень лицензии:BasicStandardAdvanced

Резюме

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

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

Синтаксис

CreateRoutes_lr (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 (Окно Python)

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

import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
Пример №2 инструмента CreateRoutes (автономный скрипт Python)

Следующий автономный скрипт демонстрирует порядок использования функции 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.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
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 (автономный скрипт Python

Следующий автономный скрипт демонстрирует порядок использования функции 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
from arcpy import env

# Set workspace
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 the result to the roads feature dataset

# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
Пример №4 инструмента CreateRoutes Example 4 (автономный скрипт Python)

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

# Name: CreateRoutes_Example4.py
# Description: Create routes from lines. The lines are in a personal geodatabase.
# The ONE_FIELD option will be used to set the measures.
# Author: ESRI

# Import system modules 
import arcpy
from arcpy import env

# Set workspace
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 the result to the roads feature dataset 

# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
Пример №5 инструмента CreateRoutes (автономный скрипт Python)

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

# Name CreateRoutes_Example5.py
# Description:  Create routes from lines. The lines are in an enterprise geodatabase.
# The TWO_FIELD option will be used to set the measures.
# Author: ESRI
 
# Import system modules
import arcpy
from arcpy import env

# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"

# Set local variables
in_lines = gp.QualifyTableName("base_roads", wkspc)   # base_roads is a standalone feature class
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)

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

Связанные темы

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

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
9/11/2013