Подпись | Описание | Тип данных |
Шаблон | Шаблон входных данных LRS, который определяет поля суммирования и длины. | File |
Входные объекты-маршруты | Сеть LRS, которая будет использоваться для вычисления длины. | Feature Layer |
Дата вступления в силу | Дата, которая будет использоваться для определения временного представления сети. | Date |
Единицы длины | Определяет единицы измерения, которые будут использоваться для поля длины в выходных данных.
| String |
Ограничивающие объекты (Дополнительный) | Ограничивающий слой, который будет использоваться для суммирования данных. | Feature Layer |
Поле суммирования (Дополнительный) | Поле из ограничивающего слоя, которое содержит имена для суммарных строк. | Field |
Исключить пустые суммарные строки (Дополнительный) | Задает, будут ли пустые суммарные строки исключены из выходных данных.
| Boolean |
Выходной формат (Дополнительный) | Задает формат выходного файла.
| String |
Выходной файл (Дополнительный) | Выходной файл .csv, в который будет записана вычисленная длина. | File |
Выходная таблица (Дополнительный) | Таблица, которая будет создана с учетом вычисленной длины. | Table |
Доступно с лицензией Location Referencing.
Краткая информация
Преобразует данные LRS для создания продукта длины для выбранных маршрутов в сети LRS. Например, используйте этот инструмент для суммирования пробега по набору маршрутов или линий по границе округа.
Использование
Используйте шаблон данных LRS, в котором указаны поля суммирования и длины. Вы можете использовать шаблон location referencing для трубопроводов или дорог и автомагистралей Roads and Highways.
Поля суммирования и длины должны находиться в той же базе геоданных, что и слой сети LRS.
Шаблон должен быть в виде файла .json.
Используйте класс сетевых объектов в качестве значения параметра Входные объекты маршрута.
Этот инструмент не изменяет входные данные и создает файл .csv в качестве выходных данных.
Этот инструмент поддерживает выборку и определяющий запрос.
Параметр Дата вступления в силу используется для определения временного вида сети. Для расчета выходных данных будут использоваться только маршруты, активные на эту дату.
Этот инструмент поддерживает преобразование единиц измерения при преобразовании сетевых единиц измерения в другие единицы измерения.
Параметры Ограничивающие объекты и Поле суммирования действительны только в том случае, если в файле .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 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 в окне 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 в сервисе объектов.
# 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)