Создать продукт данных LRS (Location Referencing)

Доступно с лицензией Location Referencing.

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

Преобразует данные LRS для создания продукта длины для выбранных маршрутов в сети LRS. Например, используйте этот инструмент для суммирования пробега по набору маршрутов или линий по границе округа.

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

  • Используйте шаблон данных LRS, в котором указаны поля суммирования и длины. Вы можете использовать шаблон location referencing для трубопроводов или дорог и автомагистралей Roads and Highways.

  • Поля суммирования и длины должны находиться в той же базе геоданных, что и слой сети LRS.

  • Шаблон должен быть в виде файла .json.

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

  • Этот инструмент не изменяет входные данные и создает файл .csv в качестве выходных данных.

  • Этот инструмент поддерживает выборку и определяющий запрос.

  • Параметр Дата вступления в силу используется для определения временного вида сети. Для расчета выходных данных будут использоваться только маршруты, активные на эту дату.

  • Этот инструмент поддерживает преобразование единиц измерения при преобразовании сетевых единиц измерения в другие единицы измерения.

  • Параметры Ограничивающие объекты и Поле суммирования действительны только в том случае, если в файле .json не указано поле суммирования.

  • Если в сети есть маршруты с ошибками калибровки или нулевой длиной, отметьте Исключить пустые суммарные строки, чтобы исключить эти маршруты из выходных данных. В противном случае эти маршруты будут включены в выходные данные с нулевой длиной.

Параметры

ПодписьОписаниеТип данных
Шаблон

Шаблон входных данных LRS, который определяет поля суммирования и длины.

File
Входные объекты-маршруты

Сеть LRS, которая будет использоваться для вычисления длины.

Feature Layer
Дата вступления в силу

Дата, которая будет использоваться для определения временного представления сети.

Date
Единицы длины

Определяет единицы измерения, которые будут использоваться для поля длины в выходных данных.

  • ДюймыЕдиницами измерения будут дюймы.
  • ФутыЕдиницами измерения будут футы.
  • ЯрдыЕдиницами измерения будут ярды.
  • МилиЕдиницами измерения будут мили.
  • Морские милиЕдиницами измерения будут морские мили.
  • Международные милиЕдиницами измерения будут международные мили.
  • Международные футыЕдиницами измерения будут международные футы.
  • МиллиметрыЕдиницами измерения будут миллиметры.
  • СантиметрыЕдиницами измерения будут сантиметры.
  • МетрыЕдиницами измерения будут метры.
  • КилометрыЕдиницами измерения будут километры.
  • ДециметрыЕдиницами измерения будут дециметры.
String
Ограничивающие объекты
(Дополнительный)

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

Feature Layer
Поле суммирования
(Дополнительный)

Поле из ограничивающего слоя, которое содержит имена для суммарных строк.

Field
Исключить пустые суммарные строки
(Дополнительный)

Задает, будут ли пустые суммарные строки исключены из выходных данных.

  • Отмечено — некалиброванные маршруты или маршруты с нулевой длиной будут исключены из выходных данных. Это значение по умолчанию
  • Не отмечно — некалиброванные маршруты или маршруты с нулевой длиной не будут исключены из выходных данных; они будут включены в выходные данные с пробегом, равным 0.
Boolean
Выходной формат
(Дополнительный)

Задает формат выходного файла.

  • CSVВыходным будет файл .csv. Это значение по умолчанию
String
Выходной файл
(Дополнительный)

Выходной файл .csv, в который будет записана вычисленная длина.

File
Выходная таблица
(Дополнительный)

Таблица, которая будет создана с учетом вычисленной длины.

Table

arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, {boundary_features}, {summary_field}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})
ИмяОписаниеТип данных
in_template

Шаблон входных данных LRS, который определяет поля суммирования и длины.

File
in_route_features

Сеть LRS, которая будет использоваться для вычисления длины.

Feature Layer
effective_date

Дата, которая будет использоваться для определения временного представления сети.

Date
units

Определяет единицы измерения, которые будут использоваться для поля длины в выходных данных.

  • INCHESЕдиницами измерения будут дюймы.
  • FEETЕдиницами измерения будут футы.
  • YARDSЕдиницами измерения будут ярды.
  • MILESЕдиницами измерения будут мили.
  • NAUTICAL_MILESЕдиницами измерения будут морские мили.
  • INTMILESЕдиницами измерения будут международные мили.
  • INTFEETЕдиницами измерения будут международные футы.
  • MILLIMETERSЕдиницами измерения будут миллиметры.
  • CENTIMETERSЕдиницами измерения будут сантиметры.
  • METERSЕдиницами измерения будут метры.
  • KILOMETERSЕдиницами измерения будут километры.
  • DECIMETERSЕдиницами измерения будут дециметры.
String
boundary_features
(Дополнительный)

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

Feature Layer
summary_field
(Дополнительный)

Поле из ограничивающего слоя, которое содержит имена для суммарных строк.

Field
exclude_null_summary_rows
(Дополнительный)

Задает, будут ли пустые суммарные строки исключены из выходных данных.

  • EXCLUDEНекалиброванные маршруты или маршруты с нулевой длиной будут исключены из выходных данных. Это значение по умолчанию
  • DO_NOT_EXCLUDEНекалиброванные маршруты или маршруты с нулевой длиной не будут исключены из выходных данных; они будут включены в выходные данные с пробегом, равным 0.
Boolean
output_format
(Дополнительный)

Задает формат выходного файла.

  • CSVВыходным будет файл .csv. Это значение по умолчанию
String
out_file
(Дополнительный)

Выходной файл .csv, в который будет записана вычисленная длина.

File
out_table
(Дополнительный)

Таблица, которая будет создана с учетом вычисленной длины.

Table

Пример кода

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

Этот автономный скрипт демонстрирует пример использования функции GenerateLrsDataProduct.

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a Length product for the selected routes in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_template=r"C:\Data\Template.json"
in_route_features=r"C:\Data\SampleData.gdb\LRS\Network"
effective_date="06/03/2024"
units="METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows="EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP1.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
GenerateLrsDataProduct, пример 2 (окно Python)

В следующем скрипте показано, как использовать функцию GenerateLrsDataProduct в окне Python.

# Name: GenerateLrsDataProduct_ex2.py
# Description: Transforms LRS data to create a Length product for the selected routes in an LRS Network in the inline Python window in ArcGIS Pro.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_template=r"C:\Data\Template.json"
in_route_features=r"C:\Data\SampleData.gdb\LRS\Network"
effective_date="06/03/2024"
units="METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows="DO_NOT_EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP2.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)
GenerateLrsDataProduct, пример 3 (автономный скрипт)

Следующий автономный скрипт показывает, как использовать функцию GenerateLrsDataProduct в сервисе объектов.

# Name: GenerateLrsDataProduct_Ex3.py
# Description: Transforms LRS data to create a Length product for the selected routes using a feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Check out the license
arcpy.CheckOutExtension("LocationReferencing")

# Input event and target LRS network are in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the LRS network from the feature service. Here, 1 corresponds to the target LRS Network's layer ID.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Set tool variables
in_template=r"C:\Data\Template.json"
effective_date="06/03/2024"
units="FEET"
boundary_features = None
summary_field = None
exclude_null_summary_rows="EXCLUDE"
output_format="CSV"
out_file= r"C:\Data\LP3.csv"
out_table=None

# Run the tool
arcpy.locref.GenerateLrsDataProduct (in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

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

  • Basic: Обязательно ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)
  • Standard: Обязательно ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)
  • Advanced: Обязательно ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)

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