Сводка
Упаковывает один или несколько результатов геообработки, включая все инструменты и наборы входных и выходных данных в один сжатый файл (.gpk).
Использование
После работы инструмента сведения о выполнении записываются как результат в окно Результаты. Результаты можно добавить как входные данные, перетащив их непосредственно из окна Результаты, или результаты, которые были сохранены как файлы результатов (.rlt), также можно добавить как входные данные.
Если включена Поддержка ArcGIS Runtime (arcgisruntime="RUNTIME" в Python), созданный пакет геообработки можно использовать в среде ArcGIS Runtime SDK. Поддержка среды выполнения
- Все источники данных не из баз геоданных будут конвертированы в файловую базу геоданных.
- Копия инструмента, для которого выполняется упаковка, создается в новом наборе инструментов, настроенном для публикации.
Если включена опция Конвертировать данные в файловую базу геоданных (convert_data = 'CONVERT' в Python), происходит следующее:
- Каждый уникальный источник данных будет иметь уникальную файловую базу геоданных, созданную в объединенной папке или пакете.
- Сжатые растровые и векторные форматы будут конвертированы в файловую базу геоданных, и сжатие будет утеряно.
- Объединение для многопользовательской базы геоданных не выполняется. В целях преобразования данных многопользовательских баз данных необходимо установить отметку Вместо привязки к данным включить данные многопользовательской базы геоданных
Если опция Конвертировать данные в файловую базу геоданных (convert_data = 'PRESERVE' в Python) не включена, происходит следующее:
- Формат источника данных входных слоев будет сохранен. Исключением являются такие форматы как данные персональной базы геоданных (.mdb), данные VPF и таблицы на основе электронных таблиц Excel или подключений OLEDB. Эти форматы не поддерживают среды 64х, и поэтому они всегда преобразовываются в файловые базы геоданных.
- Растровые форматы ADRG, CADRG/ECRG и RPF преобразовываются в формат файловой базы геоданных. ArcGIS не может напрямую считывать эти форматы. Они всегда будут конвертироваться в растры файловой базы геоданных для повышения эффективности.
- В структуре выходной папки файловые базы геоданных будут объединены в специфичную для версий папку, а все другие форматы будут объединены в папку commonData.
- Сжатые растровые и векторные форматы не будут обрезаны, даже если в параметре Экстент указан экстент.
Для слоев, которые содержат соединение или участвуют в классах отношений, все соединенные или связанные источники данных будут объединены в выходную папку. По умолчанию соединенные или связанные источники данных будут объединены полностью или в зависимости от параметра Выбрать связанные строки на основе экстента, указанного с помощью параметра Экстент.
Для векторных слоев, параметр Экстент используется для выбора пространственных объектов, которые будут собраны. Для растровых слоев параметр Экстент используется для вырезания наборов растровых данных.
Некоторые наборы данных ссылаются на другие наборы данных. Например, у вас может быть набор данных топологи, который ссылается на четыре класса пространственных объектов. Другие примеры наборов данных, которые ссылаются на другие наборы данных, включают Геометрические сети, Сети и Локаторы. При сборе или упаковке слоя на основе этих типов наборов данных, участвующие наборы данных также будут собраны или упакованы.
Если включен параметр Только схема, будет собрана или упакована только схема входных и выходных источников данных. Схема – это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Сбор или упаковка данных или записей не выполняется.
Источники данных, которые не поддерживают только схему, не будут объединены или упакованы. Если отмечен параметр Только схема и инструменту встречается слой, который поддерживается не только схемой, отображается предупреждающее сообщение и этот слой будет пропущен. Если единственный указанный слой не поддерживается только для схемы, инструмент не будет выполнен.
Создание пакета из ошибочного результата невозможно. Однако можно использовать инструмент Собрать результат для создания папки, содержащей все данные и инструменты, используемые ошибочным результатом.
Для распаковки пакета геообработки перетащите файл .gpk в ArcMap или щёлкните правой кнопкой .gpk и воспользуйтесь командой Распаковать. Или же вы можете воспользоваться инструментом Распаковать и задать выходную папку.
По умолчанию упаковки будут извлечены в профиль пользователя.
Чтобы изменить папку, в которую по умолчанию распаковывается содержимое пакетов, выберите пункт Опции ArcMap в меню Настройка. На вкладке Общий доступ найдите раздел Упаковкаи выберите пункт Использовать определенное пользователем местоположение, после чего перейдите в новую папку.
Синтаксис
arcpy.management.PackageResult(in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version})| Параметр | Объяснение | Тип данных |
in_result [in_result,...] | Упаковываемый результат. Входные данные могут быть либо результатом, добавленным путем перетаскивания непосредственно из окна Результаты, или к ним переходят через файл результатов (.rlt). | File; String |
output_file | Имя и местоположение выходного файла пакета (.gpk) . | File |
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 |
arcgisruntime (Дополнительный) | Определяет, будет ли пакет поддерживать ArcGIS Runtime. Для поддержки ArcGIS Runtime все источники данных многопользовательских баз геоданных будут преобразованы в файловую базу геоданных.
| Boolean |
additional_files [additional_files,...] (Дополнительный) | Добавляет дополнительные файлы в пакет. Дополнительные файлы, например, .doc, .txt, .pdf и т.п., используются для предоставления дополнительной информации о содержании и назначении пакета. | File |
summary (Дополнительный) | Добавление краткого описания в свойства пакета. | String |
tags (Дополнительный) | Добавление информации о тегах в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой. | String |
version [version,...] (Дополнительный) | Указывает версию базы геоданных, которая будет создана в результирующем пакете. Указание версии позволяет осуществлять общий доступ к пакетам из предыдущих версий ArcGIS и поддерживает обратную совместимость. | String |
Пример кода
PackageResult, пример 1 (окно Python)
Пример скрипта Python для использования инструмента PackageResult в окне Python.
import arcpy
arcpy.env.workspace = "C:/ResultFiles"
arcpy.PackageResult_management('Parcel.rlt', 'Parcel.gpk', "PRESERVE",
"CONVERT_ARCSDE", "#", "ALL", "ALL",
"DESKTOP", r"C:\docs\readme.txt",
"Summary text", "Tag1; tag2; tag3")
PackageResult, пример 2 (автономный скрипт Python)
Следующий скрипт Python показывает, как использовать инструмент PackageResult из окна Python или из скрипта с объектом Result пользовательского инструмента.
import arcpy
# Import toolbox with custom model inside
arcpy.ImportToolbox("c:/gisworkflows/ParcelTools.tbx")
# Run the tool and assign to a result variable
parcelUpdate = arcpy.ParcelUpdater_ParcelTools("c:/data/parcels.gdb/ward3", "UPDATE")
arcpy.PackageResult_management(parcelUpdate, "c:/gpks/parcelgpk.gpkx",
"PRESERVE", "CONVERT_ARCSDE", "#", "ALL",
"ALL", "DESKTOP", "#", "Summary text", "Tag1")
PackageResult, пример 3 (автономный скрипт)
Находит и создает отдельные пакеты геообработки для всех файлов результатов, которые находятся в указанной папке.
# Name: PackageResultEx1.py
# Description: Find all the result files that reside in a specified
# folder and create a geoprocessing package for each
# result 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 geoprocessing package using the same name as the original
# result file.
for rlt in arcpy.ListFiles("*.rlt"):
print("Packaging " + rlt)
arcpy.PackageResult_management(rlt, os.path.splitext(lyr)[0] + '.gpk',
"PRESERVE", "CONVERT_ARCSDE", "#", "ALL",
"ALL", "DESKTOP", r"C:\docs\readme.txt",
"Summary text", "Tag1; tag2; tag3")
PackageResult, пример 4 (автономный скрипт)
Находит и создает один пакет геообработки для всех файлов результатов, которые находятся в указанной папке.
# Name: PackageResultEx2.py
# Description: Find all the result files that reside in a specified
# folder and create a single geoprocessing package.
# import system modules
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles"
# Find all the result files (.rlt) in a workspace and create a single
# geoprocessing package.
rlts = arcpy.ListFiles("*.rlt")
arcpy.PackageResult_management(rlts, "all_layers.gpk", "PRESERVE",
"CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP",
r"C:\docs\readme.txt", "Summary text",
"Tag1; tag2; tag3")
Параметры среды
Этот инструмент не использует параметры среды геообработки
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да