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

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

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

Иллюстрация

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

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

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

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

    Внимание:

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

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

Параметры

ПодписьОписаниеТип данных
Входные объекты

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

Feature Layer
Выходной класс пространственных объектов

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

Feature Class
Поля слияния
(Дополнительный)

Поле или поля, по которым будут агрегированы объекты. Если поля не указаны, инструмент выполнит слияние всех объектов вместе.

Field
Поля статистики
(Дополнительный)

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

По умолчанию инструмент не вычисляет никаких статистических показателей.

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

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

  • Сумма – будут сложены все значения указанного поля.
  • Среднее – будет вычислено среднее значение для указанного поля.
  • Минимум – будет определено наименьшее значение во всех записях указанного поля.
  • Максимум – будет определено наибольшее значение во всех записях указанного поля.
  • Диапазон – будет вычислен диапазон значений (от максимального до минимального) для указанного поля.
  • Стандартное отклонение – будет вычислено среднеквадратическое отклонение для значений в указанном поле.
  • Количество – будет найдено число значений, участвующих в вычислениях. Пересчитываются все значения, исключая пустые значения. Для того чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность.
  • Первое – будет использоваться значение первой записи указанного поля во входных данных.
  • Последнее – будет использоваться значение последней записи указанного поля во входных данных.
  • Медиана – будет вычислена медиана всех записей указанного поля.
  • Дисперсия – будет вычислена дисперсия значений в указанном поле.
  • Уникальные — будет найдено количество уникальных значений в указанном поле.
  • Конкатенация — значения указанного поля будут объединены. Значения можно разделить с помощью параметра Разделитель конкатенации.
Value Table
Разделитель конкатенации
(Дополнительный)

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

String

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}],...]
(Дополнительный)

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

По умолчанию инструмент не вычисляет никаких статистических показателей.

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

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

  • SUM – значения для указанного поля будут суммироваться.
  • MEAN – будет вычислено среднее значение для указанного поля.
  • MIN - будет определено наименьшее значение для всех записей заданного поля.
  • MAX - будет определено наибольшее значение для всех записей заданного поля.
  • RANGE – будет вычислен диапазон значений (от максимального до минимального) для указанного поля.
  • STD - будет вычислено среднеквадратическое отклонение значений в указанном поле.
  • COUNT – будет найдено число значений, участвующих в вычислениях. Пересчитываются все значения, исключая пустые значения. Для того чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность.
  • FIRST – будет использоваться значение из первой записи указанного поля во входных данных.
  • LAST – будет использоваться значение из последней записи указанного поля во входных данных.
  • MEDIAN – будет вычислена медиана всех записей указанного поля.
  • VARIANCE – будет вычислена дисперсия значений в указанном поле.
  • UNIQUE — будет посчитано количество уникальных значений в указанном поле.
  • CONCATENATE — значения указанного поля будут объединены. Значения можно разделить с помощью параметра concatenation_separator.
Value Table
concatenation_separator
(Дополнительный)

Символ или символы, которые будут использоваться для конкатенации значений, когда для параметра statistics_fields используется опция CONCATENATION. По умолчанию инструмент соединяет значения без разделителей.

String

Пример кода

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

В следующем скрипте окна 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, пример 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"]
 
# Run UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.management.UnsplitLine(inFeatures, outFeatureClass, dissolveFields)

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