Краткая информация
Собирает один или несколько слоев в одной папке, копируя в нее все связанные источники данных.
Использование
Если инструмент находит неподдерживаемый тип слоя, появляется предупреждение. Неподдерживаемый слой не будет записан в выходные данные.
При сборе или упаковке слоев, получившиеся слои переименовываются в соответствии с правилом <integer><layername>.lyr (например, 0000roads.lyr). Такое переименование требуется в целях обеспечения уникальных имен слоев в объединенной папке для всех слоев, ссылающихся на уникальные источники данных и содержащих одинаковые имена слоя в ArcMap.
Если включена опция Конвертировать данные в файловую базу геоданных (convert_data='CONVERT' в Python), происходит следующее:
- Каждый уникальный источник данных будет иметь уникальную файловую базу геоданных, созданную в объединенной папке или пакете.
- Сжатые растровые и векторные форматы будут конвертированы в файловую базу геоданных, и сжатие будет утеряно.
- Объединение для многопользовательской базы геоданных не выполняется. В целях преобразования данных многопользовательских баз данных необходимо включить опцию Включить данные многопользовательской базы геоданных вместо ссылки на данные.
Если опция Конвертировать данные в файловую базу геоданных (convert_data='PRESERVE' в Python) не включена, происходит следующее:
- Формат источника данных входных слоев будет сохранен. Исключением являются такие форматы как данные персональной базы геоданных (.mdb), данные VPF и таблицы на основе электронных таблиц Excel или подключений OLEDB. Эти форматы не поддерживают среды 64х и, таким образом, они всегда преобразовываются в файловые базы геоданных.
- Растровые форматы ADRG, CADRG/ECRG и RPF преобразовываются в формат файловой базы геоданных. ArcGIS не может напрямую считывать эти форматы. Они всегда будут конвертироваться в растры файловой базы геоданных для повышения эффективности.
- В структуре выходной папки файловые базы геоданных будут объединены в специфичную для версий папку, а все другие форматы будут объединены в папку commonData.
- Сжатые растровые и векторные форматы не будут вырезаться, даже если экстент задан в параметре Экстент.
Для слоев, которые содержат соединение или участвуют в классах отношений, все соединенные или связанные источники данных будут собраны в выходную папку.
Для векторных слоев, параметр Экстент используется для выбора пространственных объектов, которые будут собраны. Для растровых слоев, параметр Экстент используется для вырезания наборов растровых данных.
Некоторые наборы данных ссылаются на другие наборы данных. Например, у вас может быть набор данных топологи, который ссылается на четыре класса пространственных объектов. Другие примеры наборов данных, которые ссылаются на другие наборы данных, включают Геометрические сети, Сети и Локаторы. При сборе или упаковке слоя на основе этих типов наборов данных, участвующие наборы данных также будут собраны или упакованы.
Если включен параметр Только схема (schema_only='SCHEMA_ONLY' в Python), будет упакована или собрана только схема входных источников данных. Схема – это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Сбор или упаковка данных или записей не выполняется.
Источники данных, которые не поддерживают только схему, не будут объединены или упакованы. Если отмечен параметр Только схема и инструменту встречается слой, который поддерживается не только схемой, отображается предупреждающее сообщение и этот слой будет пропущен. Если единственный указанный слой не поддерживается только для схемы, инструмент не будет выполнен.
В результате объединения или упаковки Покрытия или слоев VPF, они будут скопированы в объединенную папку или пакет.
Синтаксис
ConsolidateLayer_management (in_layer, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only})
Параметр | Объяснение | Тип данных |
in_layer [in_layer,...] | Входные слои, которые будут объединены. | Layer |
output_folder | Выходная папка, которая будет содержать файлы слоев и объединенные данные. | Folder |
convert_data (Дополнительный) | Устанавливает, будут ли входные слои конвертированы в файловую базу геоданных или сохранят свои исходные форматы.
| Boolean |
convert_arcsde_data (Дополнительный) | Устанавливает, будут ли входные слои многопользовательской базы геоданных преобразованы в файловую базу геоданных или сохранят свои исходные форматы.
| Boolean |
extent (Дополнительный) | Задайте экстент, введя вручную координаты в параметре экстента, используя формат X-Min Y-Min X-Max Y-Max. Для использования экстента конкретного слоя укажите имя слоя.
| Extent |
apply_extent_to_arcsde (Дополнительный) | Определяет, будет ли указанный экстент применяться ко всем слоям или только к слоям многопользовательской базы геоданных.
| Boolean |
schema_only (Дополнительный) | Указывает, будет ли только схема входных слоев собрана или упакована.
| Boolean |
Пример кода
Пример 1 функции ConsolidateLayer (окно 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')
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да