| Подпись | Описание | Тип данных |
Входные объекты | Линейные объекты, которые будут агрегированы. | Feature Layer |
Выходной класс пространственных объектов | Класс пространственных объектов, который будет содержать агрегированные объекты. | Feature Class |
Поля слияния (Дополнительный) | Поле или поля, по которым будут агрегированы объекты. Если поля не указаны, инструмент выполнит слияние всех объектов вместе. | Field |
Поля статистики (Дополнительный) | Указывает поле или поля, содержащие значения атрибутов, которые будут использованы для вычисления определенных статистических показателей. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в вычисления. По умолчанию инструмент не вычисляет никаких статистических показателей. Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики. Доступны следующие типы статистики:
| Value Table |
Разделитель конкатенации (Дополнительный) | Символ или символы, которые будут использоваться для конкатенации значений, когда для параметра Поля статистики используется опция Конкатенация. По умолчанию инструмент соединяет значения без разделителей. | String |
Краткая информация
Агрегирует линейные объекты, имеющие совпадающие конечные точки и, дополнительно, общие атрибуты.
Иллюстрация
Использование
Атрибуты объектов, которые агрегируются с помощью этого инструмента, могут быть представлены или описаны с помощью статистики. Статистика, используемая для суммирования атрибутов, добавляется к выходному классу объектов как отдельное поле со стандартом наименования тип статистики + подчеркивание + имя входного поля. Например, если тип статистики SUM применяется для поля с именем POP, выходные данные будут содержать поле с именем SUM_POP.
Наличие физической памяти может ограничить число (и сложность) входных объектов, которые могут быть обработаны и агрегированы в один выходной линейный объект. Ограничение может вызвать ошибку, так как процесс слияния может требовать больше памяти, чем доступно. Чтобы предотвратить это, инструмент Собрать линию может разделить и обработать входные объекты с помощью адаптивного алгоритма разбивки на листы. Чтобы определить пространственные объекты, которые были разбиты на листы, обработайте результаты инструментом Частота, указав те же поля, которые использовались в параметре Поля слияния для параметра Поля частоты. Любая запись с значением частоты 2 была разбита на листы. Границы листа сохраняются в выходных пространственных объектах для предотвращения создания объектов, слишком больших для использования в ArcGIS.
Внимание:
Повторная обработка результатов, полученных после работы инструмента Собрать линию, вряд ли сократит число объектов, если при первой обработке данные были разделены и обработаны с помощью адаптивного алгоритма разбивки на листы. Максимальный размер любого выходного объекта определяется объемом доступной во время обработки памяти; выходные данные, содержащие листы, являются своего рода индикатором, что дальнейшая попытка агрегации с доступными ресурсами может привести к нехватке памяти или к созданию объекта, использовать который будет нельзя. Кроме того, повторный запуск инструмента Собрать линию с данными, уже обработанными таким способом, могут привести к снижению производительности, вплоть до полной остановки и появления неустранимых ошибок.
Пустые значения не включаются в расчет статистики. Например, среднее 10, 5 и null будет 7.5 ((10 + 5) / 2). Тип статистики Количество возвращает количество значений, включенных в статистический расчет. В данном случае это 2.
Параметры
arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {concatenation_separator})| Имя | Описание | Тип данных |
in_features | Линейные объекты, которые будут агрегированы. | Feature Layer |
out_feature_class | Класс пространственных объектов, который будет содержать агрегированные объекты. | Feature Class |
dissolve_field [dissolve_field,...] (Дополнительный) | Поле или поля, по которым будут агрегированы объекты. Если поля не указаны, инструмент выполнит слияние всех объектов вместе. | Field |
statistics_fields [[field, {statistic_type}],...] (Дополнительный) | Указывает поле или поля, содержащие значения атрибутов, которые будут использованы для вычисления определенных статистических показателей. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в вычисления. По умолчанию инструмент не вычисляет никаких статистических показателей. Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики. Доступны следующие типы статистики:
| Value Table |
concatenation_separator (Дополнительный) | Символ или символы, которые будут использоваться для конкатенации значений, когда для параметра statistics_fields используется опция CONCATENATION. По умолчанию инструмент соединяет значения без разделителей. | String |
Пример кода
В следующем скрипте окна Python показано, как используется функция UnsplitLine в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.management.UnsplitLine("streets", "C:/output/output.gdb/streets_unsplit",
["STREETNAME", "PREFIX"])В следующем автономном скрипте показано использование функции 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"]
# Run UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.management.UnsplitLine(inFeatures, outFeatureClass, dissolveFields)