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

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

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

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

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

  • Если включен параметр Конвертировать данные в файловую базу геоданных, происходит следующее:

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

  • Если включен параметр Конвертировать данные в файловую базу геоданных, происходит следующее:

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной слой

Входные слои, которые должны быть собраны.

Layer
Выходная папка

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

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

Folder
Конвертировать данные в файловую базу геоданных
(Дополнительный)

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

  • Отмечено – все данные будут конвертированы в файловую базу геоданных. Параметр не применяется к источникам данных многопользовательской базы геоданных. Для включения данных многопользовательской базы геоданных поставьте отметку для параметра Включить данные многопользовательской базы геоданных вместо ссылки на данные.
  • Не отмечено – форматы данных будут по возможности сохранены. Это значение по умолчанию
Boolean
Включить данные многопользовательской базы геоданных вместо ссылки на данные
(Дополнительный)

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

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

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

  • Текущий экстент отображения Вид карты — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты.
  • Экстент слоя Layer — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями.
  • Обзор Обзор — Экстент будет основан на существующем наборе данных.
  • Пересечение входных данных Пересечение — Экстент будет основан на минимальном или пересекающемся экстенте всех входных данных. Если никакие входные данные не перекрываются, получится пустой экстент со всеми нулями.
  • Объединение входных данных Объединить — Экстент будет основан на максимальном или объединенном экстенте всех входных данных.
  • Сбросить экстент Сбросить — Экстент будет сброшен до значения по умолчанию.
  • Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты.

    На карте могут использоваться разные единицы отображения

Extent
Применить экстент только к слоям многопользовательской базы геоданных
(Дополнительный)

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

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

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

  • Не отмечено – все объекты и записи слоев наборов входных будут включены в объединенную папку или пакет. Это значение по умолчанию
  • Отмечено – только схема входных слоев будет собрана и упакована. Объекты или записи не будут собраны или упакованы в выходной папке.
Boolean
Сохранить только те строки, которые связаны с объектами в пределах экстента
(Дополнительный)

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

  • Не отмечено — связанные источники данных будут объединены в полном объеме. Это значение по умолчанию
  • Отмечено — будут объединены только связанные данные, соответствующие записям в указанном экстенте.
Boolean
Сохранить мобильную базу геоданных
(Дополнительный)

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

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

  • Не отмечено - данные мобильной базы геоданных будут конвертированы в формат файловой базы геоданных. Это значение по умолчанию
  • Отмечено - данные мобильной базы геоданных будут сохранены как мобильные базы геоданных в выходных данных. База геоданных будет включена полностью.
Boolean
Исключить набор сетевых данных
(Дополнительный)

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

  • Не отмечено — набор сетевых данных также будет участвовать в процедуре сбора. Это значение по умолчанию
  • Отмечено — набор сетевых данных не будет участвовать в процедуре сбора. Будут собраны только выбранные слои сетевого анализа.
Boolean

arcpy.management.ConsolidateLayer(in_layer, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {select_related_rows}, {preserve_sqlite}, {exclude_network_dataset})
ИмяОписаниеТип данных
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-мин, y-мин, x-макс, y-макс.
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
preserve_sqlite
(Дополнительный)

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

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

  • CONVERT_SQLITEДанные мобильной базы геоданных будут конвертированы в формат файловой базы геоданных. Это значение по умолчанию
  • PRESERVE_SQLITEДанные мобильной базы геоданных будут сохранены в выходных данных. База геоданных будет включена полностью.
Boolean
exclude_network_dataset
(Дополнительный)

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

  • INCLUDE_NETWORK_DATASETНабор сетевых данных будет участвовать в процедуре сбора. Это значение по умолчанию
  • EXCLUDE_NETWORK_DATASETНабор сетевых данных не будет участвовать в процедуре сбора. Будут собраны только слои сетевого анализа.
Boolean

Пример кода

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

В следующем скрипте окна Python показано, как используется функция ConsolidateLayer в режиме прямого запуска.

import arcpy
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers' 
arcpy.management.ConsolidateLayer('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.management.ConsolidateLayer(lyr, os.path.splitext(lyr)[0], 'PRESERVE', 'CONVERT_ARCSDE')

Параметры среды

Особые случаи

Коэффициент параллельной обработки

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