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

Сводка

Собирает один или несколько слоев в одной папке, копируя в нее все связанные источники данных.

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

  • Если инструменту встречается неподдерживаемый тип слоя, появляется предупреждение. Неподдерживаемый слой не будет записан в выходные данные.

  • Если включена опция Конвертировать данные в файловую базу геоданных (convert_data = 'CONVERT' в Python), происходит следующее:

    • Каждый уникальный источник данных будет иметь уникальную файловую базу геоданных, созданную в объединенной папке или пакете.
    • Сжатые растровые и векторные форматы будут конвертированы в файловую базу геоданных, и сжатие будет утеряно.
    • Объединение для многопользовательской базы геоданных не выполняется. В целях преобразования данных многопользовательских баз данных необходимо установить отметку Вместо привязки к данным включить данные многопользовательской базы геоданных

  • Если опция Конвертировать данные в файловую базу геоданных (convert_data = 'PRESERVE' в Python) не включена, происходит следующее:

    • Формат источника данных входных слоев будет по возможности сохранен.
    • Растровые форматы ADRG, CADRG/ECRG и RPF преобразовываются в формат файловой базы геоданных. ArcGIS не может напрямую считывать эти форматы. Они всегда будут конвертироваться в растры файловой базы геоданных для повышения эффективности.
    • В структуре выходной папки файловые базы геоданных будут объединены в специфичную для версий папку, а все другие форматы будут объединены в папку commonData.
    • Сжатые растровые и векторные форматы не будут обрезаны, даже если в параметре Экстент указан экстент.

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

  • Для векторных слоев, параметр Экстент используется для выбора пространственных объектов, которые будут собраны. Для растровых слоев параметр Экстент используется для вырезания наборов растровых данных.

  • Некоторые наборы данных ссылаются на другие наборы данных. Например, у вас может быть набор данных топологи, который ссылается на четыре класса пространственных объектов. Другие примеры наборов данных, которые ссылаются на другие наборы данных, включают Геометрические сети, Сети и Локаторы. При сборе или упаковке слоя на основе этих типов наборов данных, участвующие наборы данных также будут собраны или упакованы.

  • Если включен параметр Только схема (schema_only = 'SCHEMA_ONLY' в Python), будет упакована или собрана только схема входных источников данных. Схема – это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Сбор или упаковка данных или записей не выполняется.

  • Источники данных, которые не поддерживают только схему, не будут объединены или упакованы. Если отмечен параметр Только схема и инструменту встречается слой, который поддерживается не только схемой, отображается предупреждающее сообщение и этот слой будет пропущен. Если единственный указанный слой не поддерживается только для схемы, инструмент не будет выполнен.

Синтаксис

arcpy.management.ConsolidateLayer(in_layer, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {select_related_rows})
ParameterОбъяснениеТип данных
in_layer
[in_layer,...]

Входные слои, которые будут объединены.

Layer
output_folder

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

Если заданная папка не существует, будет создана новая папка.

Folder
convert_data
(Дополнительный)

Устанавливает, будут ли входные слои конвертированы в файловую базу геоданных или сохранят свои исходные форматы.

  • CONVERT Данные будут преобразованы в файловую базу геоданных. Параметр не применяется к источникам данных многопользовательской базы геоданных. Чтобы конвертировать данные многопользовательской базы геоданных, задайте convert_arcsde_data = 'CONVERT_ARCSDE' .
  • PRESERVEФорматы данных будут по возможности сохранены. Это значение по умолчанию.
Boolean
convert_arcsde_data
(Дополнительный)

Устанавливает, будут ли входные слои многопользовательской базы геоданных преобразованы в файловую базу геоданных или сохранят свои исходные форматы.

  • CONVERT_ARCSDE Данные многопользовательской базы геоданных будут преобразованы в файловую базу геоданных и включены в объединенную папку или пакет. Это значение по умолчанию.
  • PRESERVE_ARCSDE Данные многопользовательской базы геоданных будут сохранены, и на них будут иметься ссылки в объединенной папке или пакете.
Boolean
extent
(Дополнительный)

Указывает экстент, который будет использован для выбора или вырезания объектов.

  • MAXOF - будет использоваться максимальный экстент всех входных данных.
  • MINOF - будет использоваться минимальная область, общая для всех входных данных.
  • DISPLAY– экстент будет равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent - будет использоваться тот же экстент, что и в указанном объекте.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
Extent
apply_extent_to_arcsde
(Дополнительный)

Задает, будет ли указанный экстент ко всем слоям или только к многопользовательские слои базы геоданных.

  • ALL Указанный экстент применяется ко всем слоям. Это значение по умолчанию.
  • ARCSDE_ONLYУказанный экстент применяется к только к слоям многопользовательских баз геоданных.
Boolean
schema_only
(Дополнительный)

Указывает, будет ли только схема входных слоев собрана или упакована.

  • ALL Все пространственные объекты и записи будут собраны и упакованы. Это значение по умолчанию.
  • SCHEMA_ONLY Будет собрана или упакована только схема входных слоев.
Boolean
select_related_rows
(Дополнительный)

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

  • KEEP_ONLY_RELATED_ROWSОбъединяются только связанные данные, соответствующие записям в указанном экстенте.
  • KEEP_ALL_RELATED_ROWSСвязанные источники данных будут объединены в полном объеме. Это значение по умолчанию.
Boolean

Пример кода

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

Пример скрипта Python для использования инструмента ConsolidateLayer в режиме прямого запуска.

import arcpy
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers' 
arcpy.ConsolidateLayer_management('Parcels.lyr', 'Consolidated_folder', 'PRESERVE', 'CONVERT_ARCSDE')
ConsolidateLayer, пример 2 (автономный скрипт)

Находит и создает отдельные объединенные папки для всех файлов слоев, которые находятся в указанной папке.

# import system modules
import os 
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers' 
# Loop through the workspace, find all the layer files (.lyr) and create a consolidated folder for each 
# layer file found using the same name as the original layer file.
for lyr in arcpy.ListFiles('*.lyr'):
    print('Consolidating {}'.format(lyr))
    arcpy.ConsolidateLayer_management(lyr, os.path.splitext(lyr)[0], 'PRESERVE', 'CONVERT_ARCSDE')

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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