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

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

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

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

Шаблон должен быть в виде файла .json.
Используйте класс сетевых объектов в качестве параметра Входные объекты маршрута.
Этот инструмент не изменяет входные данные и создает файл .csv или таблицу базы геоданных в качестве выходных данных.
Этот инструмент поддерживает выборку и определяющий запрос.
Параметр Дата вступления в силу используется для определения временного вида сети. Для расчета выходных данных будут использоваться только маршруты, активные на указанную дату.
Для продуктов данных по длине и количеству объектов можно указать несколько значений параметра Дата вступления в силу. Если задано несколько дат вступления в силу, будет рассчитана разница или изменение в длине или количестве объектов между каждой парой дат вступления в силу.
При создании продукта данных длины учитывайте следующее:
- Используйте шаблон данных LRS, в котором указаны поля суммирования и длины. Вы можете использовать шаблон location referencing для трубопроводов или дорог и автомагистралей roads and highways.
- Поля суммирования и длины должны находиться в той же базе геоданных, что сеть LRS.
- Преобразование единиц измерения поддерживается при конвертации сетевых единиц измерения в другие единицы измерения.
- Параметры Ограничивающие объекты и Поле суммирования действительны только в том случае, если в файле .json не указано поле суммирования.
- Выходные данные будут созданы на основе пересечения выбранных объектов из сети LRS, сводного слоя (слоев) и слоя (слоев) длины.
При создании продукта данных журнала маршрута учитывайте следующее:
- Используйте шаблон данных LRS, в котором заданы журнал, местоположение и базовые поля. Вы можете использовать шаблон location referencing для трубопроводов или дорог и автомагистралей roads and highways.
- Слой журнала и поля должны находиться в той же базе геоданных, что и сеть LRS.
- Слой местоположения и поля должны быть полигональным слоем и находиться в той же базе геоданных, что и сеть LRS.
- Базовый слой и поля должны быть классом пространственных объектов точечных событий LRS или классом объектов пересечений LRS и находиться в той же базе геоданных, что и сеть LRS.
- Выходные данные будут созданы на основе пересечения выбранных объектов из сети LRS, слоя (слоев) журнала, слоя (слоев) местоположения и базового слоя.
При создании продукта данных числа объектов учитывайте следующее:
- Используйте шаблон данных LRS, в котором задаются поля количества, суммирования и идентификатора маршрута. Вы можете использовать шаблон location referencing для трубопроводов или дорог и автомагистралей roads and highways.
- Поля количества, суммирования и идентификатора маршрута должны находиться в той же базе геоданных, что и сеть LRS.
- Параметры Ограничивающие объекты и Поле суммирования действительны только в том случае, если в файле .json не указано поле суммирования.
- Выходные данные будут созданы на основе пересечения выбранных объектов из сети LRS, сводного слоя (слоев) и слоя (слоев) числа объектов.

Подпись	Объяснение	Тип данных
Шаблон	Входной шаблон данных 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 [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

# 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)

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

# 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)

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

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

# Name: GenerateLrsDataProduct_ex4.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

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2000; 12/31/2010; 12/31/2020"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\LP4"

# 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)

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

Текущая рабочая область

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