Вычислить общую сумму длин в системе линейных координат (Инструменты Location Referencing)

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

Cоздает продукт данных длины для маршрутов в сети LRS без шаблона данных LRS.

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

Этот инструмент поддерживает данные из файловой базы геоданных или многопользовательской базы геоданных (подключение сервис-ориентированных версий), или из сервисов объектов (опубликованных из сервис-ориентированных версий).
Этот инструмент не изменяет входные данные и создает файл .csv или таблицу базы геоданных в качестве выходных данных.
Параметр Дата вступления в силу используется для определения временного вида сети. Для расчета выходных данных будут использоваться только маршруты, активные на эту дату.
Слой суммирования должен быть классом полигональных объектов, классом объектов линейных событий LRS, зарегистрированным в указанной сети LRS, или сетью LRS.
Слой длины должен быть сетью LRS или классом пространственных объектов линейных событий LRS, зарегистрированным в указанной сети LRS.
Слои суммирования и длины должны храниться в одной и той же базе геоданных или сервисе объектов и иметь ту же систему координат, что и указанная сеть LRS.
Значение Неклассифицированный будет включено в выходное поле суммирования для маршрутов, которые не пересекаются со слоями суммирования.
Вы можете добавить несколько полей суммирования.
Выходные данные будут созданы на основе пересечения выбранных объектов из сети LRS, сводных слоев и слоев длины.
You can add multiple length fields from the same feature class by creating selection layers и указывает каждый слой выборки как поле длины. Например, если у вас есть класс объектов линейных событий LRS, вы можете создать два слоя выборки— класс A и класс B — и указать каждый из этих слоев выборки в качестве поля длины.

Подпись	Объяснение	Тип данных
Входные объекты-маршруты	Объекты маршрута, которые будут использоваться для расчета продукта данных длины LRS.	Feature Layer
Дата вступления в силу	Дата, которая будет использоваться для определения временного представления сети. Значение по умолчанию — сегодняшняя дата.	Date
Единицы длины	Указывает единицы измерения, которые будут использоваться для полей длины в выходных данных. Дюймы (США)–Единицами измерения будут дюймы. Футы (США)–Единицами измерения – футы Ярды (США)–Единицами измерения – ярды. Мили (США)–Единицами измерения – мили. Морские мили (США)–Единицами измерения будут морские мили. Футы (Международные)–Единицами измерения будут международные футы. Сухопутные мили–Единицами измерения будут сухопутные мили. Миллиметры–Единицами измерения будут миллиметры. Сантиметры–Единицами измерения будут сантиметры. Метры–Единицей измерения – метры. Километры–Единицами измерения – километры. Дециметры–Единицами измерения будут дециметры.	String
Поля суммирования (Дополнительный)	Поля из слоев, которые будут использоваться для отображения имен строк суммирования в выходных данных. Столбцы таблицы значений: Layer–The feature layer that will be used as the summary layer. Field–The field that will be used to summarize the length. Output Field Name–The summary field's display name in the output.	Value Table
Поля длины (Дополнительный)	Поля из слоев, которые будут использоваться для отображения длины маршрутов в выходных данных. Столбцы таблицы значений: Layer–The feature layer that will be used as the basis for calculating the length. Output Field Name–The length field's display name in the output.	Value Table
Исключить пустые суммарные строки (Дополнительный)	Задает, будут ли пустые суммарные строки исключены из выходных данных. Отмечено–Строки с нулевой длиной (пустые суммарные строки) будут исключены из выходных данных. Используется по умолчанию. Не отмечено–Строки с нулевой длиной (пустые суммарные строки) не будут исключены из выходных данных.	Boolean
Вычислить длину доминирующих маршрутов (Дополнительный)	Примечание: Поддержка этого параметра появится в будущих версиях.	Boolean
Выходной формат (Дополнительный)	Задает формат выходных данных. CSV–Выходными данными будет файл `.csv`. Используется по умолчанию. Таблица–Выходными данными будет таблица базы геоданных.	String
Выходной файл (Дополнительный)	Выходной файл `.csv`, который будет содержать продукт данных длины.	File
Выходная таблица (Дополнительный)	Выходная таблица базы геоданных, которая будет содержать продукт данных длины.	Table

arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, {summary_fields}, {length_fields}, {exclude_null_summary_rows}, {calculate_length_for_dominant_routes}, {output_format}, {out_file}, {out_table})

Имя	Объяснение	Тип данных
in_route_features	Объекты маршрута, которые будут использоваться для расчета продукта данных длины LRS.	Feature Layer
effective_date	Дата, которая будет использоваться для определения временного представления сети. Значение по умолчанию — сегодняшняя дата.	Date
units	Указывает единицы измерения, которые будут использоваться для полей длины в выходных данных. `INCHES`–Единицами измерения будут дюймы. `FEET`–Единицами измерения – футы `YARDS`–Единицами измерения – ярды. `MILES`–Единицами измерения – мили. `NAUTICAL_MILES`–Единицами измерения будут морские мили. `INTFEET`–Единицами измерения будут международные футы. `INTMILES`–Единицами измерения будут сухопутные мили. `MILLIMETERS`–Единицами измерения будут миллиметры. `CENTIMETERS`–Единицами измерения будут сантиметры. `METERS`–Единицей измерения – метры. `KILOMETERS`–Единицами измерения – километры. `DECIMETERS`–Единицами измерения будут дециметры.	String
summary_fields [summary_fields,...] (Дополнительный)	Поля из слоев, которые будут использоваться для отображения имен строк суммирования в выходных данных. Столбцы таблицы значений: `Layer`–The feature layer that will be used as the summary layer. `Field`–The field that will be used to summarize the length. `Output Field Name`–The summary field's display name in the output.	Value Table
length_fields [length_fields,...] (Дополнительный)	Поля из слоев, которые будут использоваться для отображения длины маршрутов в выходных данных. Столбцы таблицы значений: `Layer`–The feature layer that will be used as the basis for calculating the length. `Output Field Name`–The length field's display name in the output.	Value Table
exclude_null_summary_rows (Дополнительный)	Задает, будут ли пустые суммарные строки исключены из выходных данных. `EXCLUDE`–Строки с нулевой длиной (пустые суммарные строки) будут исключены из выходных данных. Используется по умолчанию. `DO_NOT_EXCLUDE`–Строки с нулевой длиной (пустые суммарные строки) не будут исключены из выходных данных.	Boolean
calculate_length_for_dominant_routes (Дополнительный)	Примечание: Поддержка этого параметра появится в будущих версиях.	Boolean
output_format (Дополнительный)	Задает формат выходных данных. `CSV`–Выходными данными будет файл `.csv`. Используется по умолчанию. `TABLE`–Выходными данными будет таблица базы геоданных.	String
out_file (Дополнительный)	Выходной файл `.csv`, который будет содержать продукт данных длины.	File
out_table (Дополнительный)	Выходная таблица базы геоданных, которая будет содержать продукт данных длины.	Table

Пример кода

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

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

# Name: GenerateLRLengthSummary_ex1.py
# Description: Create a length data product that provides the length of routes for three class types, summarized by counties with a population of more than 50,000
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Set current workspace
arcpy.env.workspace = r"C:\Data\SampleData.gdb"

# Create a feature layer of counties that have more than 50,000 population, to be used as summary field
arcpy.management.MakeFeatureLayer("counties", "counties_50K", "POPULATION > 50000")

# Create 3 feature layers, each representing a class type, to be used as length fields
arcpy.management.MakeFeatureLayer("Class", "Class_A", "classtype = 1")
arcpy.management.MakeFeatureLayer("Class", "Class_B", "classtype = 2")
arcpy.management.MakeFeatureLayer("Class", "Class_C", "classtype = 3")

# Set tool variables
in_route_features = "Network"
effective_date = "12/31/2024"
units = "METERS"
summary_fields = "counties_50K NAME Counties"
length_fields = "Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV"
out_file = r"C:\Data\LP1.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table)

GenerateLRLengthSummary, пример 2 (окно Python)

Пример скрипта для использования функции GenerateLRLengthSummary в окне Python.

# Name: GenerateLRLengthSummary_ex2.py
# Description: Create a length data product that provides the length of routes for all class types, summarized by counties
# Requirements: ArcGIS Location Referencing

# Set tool variables
in_route_features = "Network"
effective_date = "12/31/2024"
units = "METERS"
summary_fields = "Counties NAME Counties"
length_fields = "'Class' 'Class'"
exclude_null_summary_rows = "DO_NOT_EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV"
out_file = r"C:\Data\LP2.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table)

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

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

# Name: GenerateLRLengthSummary_ex3.py
# Description: Using LRS data in a feature service, create a length data product that provides the length of routes
# for three class types, summarized by counties with a population of more than 50,000
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Data is in a feature service. Signing in to the Enterprise 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 LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Map the Counties layer from the feature service. Here, 39 corresponds to the Counties layer's layer ID
counties = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/39"

# Create a feature layer of counties that have more than 50,000 population, to be used as summary field
arcpy.management.MakeFeatureLayer(counties, "counties_50K", "POPULATION > 50000")

# Map the Class layer from the feature service. Here, 22 corresponds to the Class layer's layer ID
classlayer = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/22"

# Create 3 feature layers, each representing a class type, to be used as length fields
arcpy.management.MakeFeatureLayer(classlayer, "Class_A", "classtype = 1")
arcpy.management.MakeFeatureLayer(classlayer, "Class_B", "classtype = 4")
arcpy.management.MakeFeatureLayer(classlayer, "Class_C", "classtype = 7")

# Set tool variables
effective_date = "12/31/2024"
units = "METERS"
summary_fields = "counties_50K NAME Counties"
length_fields = "Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV"
out_file = r"C:\Data\LP3.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table)

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

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

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

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)