Собрать результаты

Сводка

Объединяет один или несколько результатов геообработки в заданную выходную папку.

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

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

• После работы инструмента сведения о выполнении записываются как результат в окно Результаты. Результаты можно добавить как входные данные непосредственно из окна Результаты, просто перетащив их. Как вариант, результаты, сохраненные как файл результатов (.rlt) можно добавить как входные данные.

  Более подробно о работе с результатами

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

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

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

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

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

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

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

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

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

Синтаксис

arcpy.management.ConsolidateResult(in_result, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only})

Параметр	Объяснение	Тип данных
in_result [in_result,...]	Результат геообработки, в отношении которого выполняется сборка. Результаты, добавляемые как входные данные, могут быть либо файлом результатов (.rlt), либо результатом из окна Результаты.	File; String
output_folder	Выходная папка, которая будет содержать объединенные инструменты и данные.	Folder
convert_data (Дополнительный)	Устанавливает, будут ли входные слои конвертированы в файловую базу геоданных или сохранят свои исходные форматы. CONVERT — Данные будут преобразованы в файловую базу геоданных. Параметр не применяется к источникам данных многопользовательской базы геоданных. Чтобы конвертировать данные многопользовательской базы геоданных, задайте convert_arcsde_data = 'CONVERT_ARCSDE' . PRESERVE —Форматы данных будут по возможности сохранены. Это значение по умолчанию. Исключением для этого правила являются форматы, которые не поддерживаются в средах 64x (данные персональной базы геоданных .mdb данные VPF и таблицы на основе электронных таблиц Excel и подключений OLEDB), и растровые форматы, запись которых ArcGIS не может выполнять встроенными средствами (ADRG, CADRG/ECRG, CIB и RPF).	Boolean
convert_arcsde_data (Дополнительный)	Устанавливает, будут ли входные слои многопользовательской базы геоданных преобразованы в файловую базу геоданных или сохранят свои исходные форматы. CONVERT_ARCSDE — Данные многопользовательской базы геоданных будут преобразованы в файловую базу геоданных и включены в объединенную папку или пакет. Это значение по умолчанию. PRESERVE_ARCSDE — Данные многопользовательской базы геоданных будут сохранены, и на них будут иметься ссылки в объединенной папке или пакете.	Boolean
extent (Дополнительный)	Задает экстент, введя вручную координаты в параметре экстента, используя формат X-Min Y-Min X-Max Y-Max. Для использования экстента конкретного слоя укажите имя слоя. MAXOF —Будет использоваться объединение входных данных. MINOF —Будет использоваться пересечение входных данных. DISPLAY —Будет использоваться тот же экстент, что отображается в текущий момент. <Layer> —Будет использоваться тот же экстент, что и в указанном слое.	Extent
apply_extent_to_arcsde (Дополнительный)	Задает, будет ли указанный экстент ко всем слоям или только к многопользовательские слои базы геоданных. ALL — Указанный экстент применяется ко всем слоям. Это значение по умолчанию. ARCSDE_ONLY —Указанный экстент применяется к только к слоям многопользовательских баз геоданных.	Boolean
schema_only (Дополнительный)	Указывает, будет ли сбор или упаковка выполняться только для схемы наборов входных и выходных данных. ALL — Все записи для наборов входных и выходных данных будут собраны или упакованы. Используется по умолчанию. SCHEMA_ONLY — Объединение и упаковка выполняется только для схемы наборов входных и выходных данных.	Boolean

Пример кода

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

Следующий скрипт, представленный в окне Python, демонстрирует, как использовать инструмент ConsolidateResult в окне Python.

import arcpy
arcpy.ConsolidateResult_management(r'C:\ResultFiles\BufferPoints.rlt', r'C:\project\Buffer_Pnts', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL")

ConsolidateResult, пример 2 (автономный скрипт)

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

# Name: ConsolidateResultEx1.py
# Description:  Find all the Result files that reside in a specified folder and create a consolidated folder for each layer file.
# import system modules
import os 
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles" 
# Loop through the workspace, find all the result files (.rlt) and create a consolidated folder for each 
# result file found using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
    print("Consolidating " +  rlt)
    arcpy.ConsolidateResult_management(rlt, os.path.splitext(rlt)[0], "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL")

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

Этот инструмент не использует параметры среды геообработки

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

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