Собрать линию (Управление данными)

Сводка

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

Иллюстрация

Иллюстрация инструмента Собрать линию

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

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

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

    Внимание:

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

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

Синтаксис

arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields})
ParameterОбъяснениеТип данных
in_features

Линейные объекты, которые будут агрегированы.

Feature Layer
out_feature_class

Класс пространственных объектов, который будет содержать агрегированные объекты.

Feature Class
dissolve_field
[dissolve_field,...]
(Дополнительный)

Поле или поля, по которым будут объединены объекты.

Field
statistics_fields
[[field, {statistic_type}],...]
(Дополнительный)

Указывает числовое поле, содержащее значения атрибута, для которого будет вычислен определенный статистический показатель. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет статистики.

Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики.

Доступны следующие типы статистики:

  • SUM – Вычисляет суммарное значение атрибута в заданном поле.
  • MEAN – Вычисляет среднее арифметическое для указанного поля.
  • MIN – Находит наименьшее значение для всех записей заданного поля.
  • MAX – находит максимальное среди всех значений данного поля.
  • RANGE – вычисляет диапазон значений (от максимального до минимального) для конкретного поля.
  • STD – Вычисляет значение среднеквадратичного отклонения для значений данного поля.
  • COUNT – Определяет количество значений, участвующих в статистических вычислениях. Пересчитываются все значения, исключая пустые значения. Для того, чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность.
  • FIRST – определяет первую запись входного поля и записывает это значение.
  • LAST – определяет последнюю запись входного поля и записывает это значение.
  • MEDIAN – вычисляет медиану всех записей указанного поля.
  • VARIANCE – вычисляет дисперсию по значениям указанного поля.
  • UNIQUE – рассчитывает число уникальных в указанном поле.
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)

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

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

Связанные разделы