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

Сводка

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

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

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

• Если включена опция Конвертировать данные в файловую базу геоданных (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')

Environments

Текущая рабочая область, Экстент

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

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