Собрать линию

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

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

Иллюстрация

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

• Атрибуты пространственных объектов, которые были агрегированы этим инструментом, можно суммировать или описать с помощью различных типов статистики. Статистика, используемая для суммирования атрибутов, добавляется к выходному классу объектов как одно поле со стандартом наименования типа статистики + подчеркивание + имя входного поля. Например, если статистика SUM используется в поле с именем POP, выходные данные будут содержать поле с именем SUM_POP.

• Наличие физической памяти может ограничить число (и сложность) входных объектов, которые могут быть обработаны и объединены в один выходной линейный объект. Ограничение может вызвать ошибку, так как процесс слияния может требовать больше памяти, чем доступно. Чтобы предотвратить это, инструмент Собрать линию может разделить и обработать входные объекты с помощью адаптивного алгоритма разбивки на листы. Чтобы определить пространственные объекты, которые были разбиты на листы, обработайте результаты инструментом Частота, указав те же поля, которые использовались в параметре Поля слияния для параметра Поля частоты. Любая запись с значением частоты 2 была разбита на листы. Границы листа сохраняются в выходных пространственных объектах для предотвращения создания объектов, слишком больших для использования в ArcGIS.

  Внимание:

  Повторная обработка результатов, полученных после работы инструмента Собрать линию, вряд ли сократит число объектов, если при первой обработке данные были разделены и обработаны с помощью адаптивного алгоритма разбивки на листы. Максимальный размер любого выходного объекта определяется объемом доступной во время обработки памяти; поэтому выходные данные, содержащие листы, являются своего рода индикатором, что дальнейшая попытка сборки с теми же ресурсами может привести к нехватке памяти или к созданию объекта, использовать который будет нельзя. Кроме того, повторный запуск инструмента Собрать линию с данными, уже обработанными таким способом, могут привести к снижению производительности, вплоть до полной остановки и появления неустранимых ошибок.

• Пустые значения не включаются в расчет статистики. Например, среднее 10, 5 и null будет 7.5 ((10 + 5) / 2). Тип статистики count возвращает количество значений, включенных в статистический расчет. В данном случае это 2.

Синтаксис

UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {statistics_fields})

Параметр	Объяснение	Тип данных
in_features	Линейные объекты, которые будут агрегированы.	Feature Layer
out_feature_class	Класс пространственных объектов, который будет содержать агрегированные объекты.	Feature Class
dissolve_field [dissolve_field,...] (Дополнительный)	Поле или поля, по которым будут объединены объекты. Кнопка Добавить поле, которая используется только в ModelBuilder, позволяет вам добавлять нужные поля, так что вы можете закрыть диалоговое окно и продолжить построение модели.	Field
statistics_fields [[field, {statistic_type}],...] (Дополнительный)	Числовое поле, содержащее значения атрибута, для которого будет вычислен определенный статистический показатель. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет статистики. Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики. Доступны следующие типы статистики: SUM – Вычисляет суммарное значение атрибута в заданном поле. MEAN – Вычисляет среднее арифметическое для указанного поля. MIN – Находит наименьшее значение для всех записей заданного поля. MAX – находит максимальное среди всех значений данного поля. RANGE – вычисляет диапазон значений (от максимального до минимального) для конкретного поля. STD – Вычисляет значение среднеквадратичного отклонения для значений данного поля. COUNT – Определяет количество значений, участвующих в статистических вычислениях. Пересчитываются все значения, исключая пустые значения. Для того, чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность. FIRST – определяет первую запись входного поля и записывает это значение. LAST – определяет последнюю запись входного поля и записывает это значение.	Value Table
statistics_fields [[field, {statistic_type}],...] (Дополнительный)	Числовое поле, содержащее значения атрибута, для которого будет вычислен определенный статистический показатель. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет статистики. Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики. Доступны следующие типы статистики: SUM – Вычисляет суммарное значение атрибута в заданном поле. MEAN – Вычисляет среднее арифметическое для указанного поля. MIN – Находит наименьшее значение для всех записей заданного поля. MAX – находит максимальное среди всех значений данного поля. RANGE – вычисляет диапазон значений (от максимального до минимального) для конкретного поля. STD – Вычисляет значение среднеквадратичного отклонения для значений данного поля. COUNT – Определяет количество значений, участвующих в статистических вычислениях. Пересчитываются все значения, исключая пустые значения. Для того, чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность. FIRST – определяет первую запись входного поля и записывает это значение. LAST – определяет последнюю запись входного поля и записывает это значение.	Value Table

Пример кода

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

Следующий скрипт окна Python показывает, как использовать инструмент UnsplitLine в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.UnsplitLine_management("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])

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

В следующем автономном скрипте показано, как использовать инструмент UnsplitLine.

# Name: UnsplitLine_Example2.py
# Description: Unsplit line features based on common attributes
 
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
 
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/streets_unsplit"
dissolveFields = ["STREETNAME", "PREFIX"]
 
# Execute UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.UnsplitLine_management(inFeatures, outFeatureClass, dissolveFields)

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

• Текущая рабочая область
• Временная рабочая область
• Выходная система координат
• Географические преобразования
• Экстент
• Разрешение XY
• Допуск XY
• Выходные данные содержат M-значения
• Разрешение M
• Допуск M
• Выходные данные содержат Z значения
• Выходное Z-значение по умолчанию
• Разрешение Z
• Допуск Z
• Полноценные имена полей
• Выходное ключевое слово CONFIG
• Автоподтверждение
• Выходная пространственная сетка 1
• Выходная пространственная сетка 2
• Выходная пространственная сетка 3
• Выходной XY домен
• Выходной M домен
• Выходной Z домен

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

• Basic: Нет
• Standard: Нет
• Advanced: Да