Подпись | Описание | Тип данных |
Шаблон | Входной шаблон данных LRS, который задает поля суммирования и длины (продукт данных длины); идентификатора маршрута, журнала, местоположения и базовые поля (продукт данных журнала маршрута); или поля количества, суммирования и идентификатора маршрута (продукт данных количества объектов). | File |
Входные объекты-маршруты | Сеть LRS, которая будет использоваться для вычисления длины, журнала маршрута или числа объектов. | Feature Layer |
Дата вступления в силу | Дата, которая будет использоваться для определения временного представления сети. | Date |
Единицы длины (Дополнительный) | Определяет единицы измерения, которые будут использоваться для поля длины в выходных данных. Этот параметр доступен только при создании продукта данных длины.
| String |
Ограничивающие объекты (Дополнительный) | Ограничивающий слой, который будет использоваться для суммирования данных. Этот параметр доступен только при создании продукта данных длины или числа объектов. | Feature Layer |
Поле суммирования (Дополнительный) | Поле из ограничивающего слоя, которое содержит имена для суммарных строк. Этот параметр доступен только при создании продукта данных длины или числа объектов. | Field |
Исключить пустые суммарные строки (Дополнительный) | Задает, будут ли пустые суммарные строки исключены из выходных данных.
Этот параметр доступен только при создании продукта данных длины или числа объектов. | Boolean |
Выходной формат (Дополнительный) | Задает формат выходного файла.
| String |
Выходной файл (Дополнительный) | Выходной файл .csv, в который будет записана вычисленная длина, журнал маршрута или число объектов. | File |
Выходная таблица (Дополнительный) | Создаваемая таблица базы геоданных, содержащая вычисленную длину, журнал маршрутов или количество объектов. | Table |
Доступно с лицензией 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 не указано поле суммирования.
Параметры
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 (Дополнительный) | Определяет единицы измерения, которые будут использоваться для поля длины в выходных данных. Этот параметр доступен только при создании продукта данных длины.
| String |
boundary_features (Дополнительный) | Ограничивающий слой, который будет использоваться для суммирования данных. Этот параметр доступен только при создании продукта данных длины или числа объектов. | Feature Layer |
summary_field (Дополнительный) | Поле из ограничивающего слоя, которое содержит имена для суммарных строк. Этот параметр доступен только при создании продукта данных длины или числа объектов. | Field |
exclude_null_summary_rows (Дополнительный) | Задает, будут ли пустые суммарные строки исключены из выходных данных.
Этот параметр доступен только при создании продукта данных длины или числа объектов. | Boolean |
output_format (Дополнительный) | Задает формат выходного файла.
| String |
out_file (Дополнительный) | Выходной файл .csv, в который будет записана вычисленная длина, журнал маршрута или число объектов. | File |
out_table (Дополнительный) | Создаваемая таблица базы геоданных, содержащая вычисленную длину, журнал маршрутов или количество объектов. | Table |
Пример кода
Этот автономный скрипт демонстрирует пример использования функции 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 в окне 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 с данными сервиса объектов.
# 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)