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

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

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

Преобразует данные LRS для создания продукта длины, журнала маршрута или числа объектов для выбранных маршрутов в сети LRS.

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

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

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

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

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

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

  • При создании продукта данных длины учитывайте следующее:

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

  • При создании продукта данных журнала маршрута учитывайте следующее:

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

  • При создании продукта данных числа объектов учитывайте следующее:

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

Параметры

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

Входной шаблон данных LRS, который задает поля суммирования и длины (продукт данных длины); идентификатора маршрута, журнала, местоположения и базовые поля (продукт данных журнала маршрута); или поля количества, суммирования и идентификатора маршрута (продукт данных количества объектов).

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

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

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

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

Date
Единицы длины
(Дополнительный)

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

Этот параметр доступен только при создании продукта данных длины.

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

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

Этот параметр доступен только при создании продукта данных длины или числа объектов.

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

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

Этот параметр доступен только при создании продукта данных длины или числа объектов.

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

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

  • Отмечено — строки с нулевой длиной или числом объектов будут исключены из выходных данных. Это значение по умолчанию
  • Не отмечено — строки с нулевой длиной или числом объектов не будут исключены из выходных данных.

Этот параметр доступен только при создании продукта данных длины или числа объектов.

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Строки с нулевой длиной или числом объектов не будут исключены из выходных данных.

Этот параметр доступен только при создании продукта данных длины или числа объектов.

Boolean
output_format
(Дополнительный)

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

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

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

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

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

Table

Пример кода

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

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

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a data 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 = "12/31/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 data 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 = "12/31/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 data 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 = "12/31/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)

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