Сводка
Упаковывает один или несколько результатов геообработки, включая все инструменты и наборы входных и выходных данных в один сжатый файл (.gpkx).
Использование
После выполнения инструмента в раздел История геообработки на панели Каталог добавляется элемент истории геообработки. Используйте этот элемент в качестве входных данных для инструмента Упаковать результат.
Когда инструмент выполняется из Python, объект Result возвращается из выполнения инструмента. Свойство объекта Result resultID можно использовать в качестве входных данных для этого инструмента. В разделе Пример кода второй пример демонстрирует, как использовать свойство объекта Result resultID.
Если включена Поддержка ArcGIS Runtime (arcgisruntime="RUNTIME" в Python), созданный пакет геообработки можно использовать в среде ArcGIS Runtime SDK. Для поддержки среды выполнения выполняются следующие действия:
- Все источники данных не из баз геоданных будут конвертированы в файловую базу геоданных.
- Копия инструмента, для которого выполняется упаковка, создается в новом наборе инструментов, настроенном для публикации.
Примечание:
Начиная с ArcGIS Pro 2.1, могут быть созданы пакеты геообработки, которые поддерживают ArcGIS Runtime.
Если включена опция Конвертировать данные в файловую базу геоданных (convert_data='CONVERT' в Python), происходит следующее:
- Каждый уникальный источник данных будет иметь уникальную файловую базу геоданных, созданную в объединенной папке или пакете.
- Сжатые растровые и векторные форматы будут конвертированы в файловую базу геоданных, и сжатие будет утеряно.
- Объединение для многопользовательской базы геоданных не выполняется. В целях преобразования данных многопользовательских баз данных необходимо установить отметку Вместо привязки к данным включить данные многопользовательской базы геоданных
Если опция Конвертировать данные в файловую базу геоданных (convert_data='PRESERVE' в Python) не включена, происходит следующее:
- Формат источника данных входных слоев будет по возможности сохранен.
- Растровые форматы ADRG, CADRG/ECRG и RPF преобразовываются в формат файловой базы геоданных. ArcGIS не может напрямую считывать эти форматы. Они всегда будут конвертироваться в растры файловой базы геоданных для повышения эффективности.
- В структуре выходной папки файловые базы геоданных будут объединены в специфичную для версий папку, а все другие форматы будут объединены в папку commonData.
- Сжатые растровые и векторные форматы не будут обрезаны, даже если в параметре Экстент указан экстент.
Для слоев, которые содержат соединение или участвуют в классах отношений, все соединенные или связанные источники данных будут объединены в выходную папку. По умолчанию соединенные или связанные источники данных будут объединены полностью или в зависимости от параметра Выбрать связанные строки на основе экстента, указанного с помощью параметра Экстент.
Для векторных слоев, параметр Экстент используется для выбора пространственных объектов, которые будут собраны. Для растровых слоев, параметр Экстент используется для вырезания наборов растровых данных.
Некоторые наборы данных ссылаются на другие наборы данных. Например, у вас может быть набор данных топологи, который ссылается на четыре класса пространственных объектов. Другие примеры наборов данных, которые ссылаются на другие наборы данных, включают Геометрические сети, Сети и Локаторы. При сборе или упаковке слоя на основе этих типов наборов данных, участвующие наборы данных также будут собраны или упакованы.
Если выбрано Только схема, то собирается или упаковывается только схема источников входных и выходных данных. Схема – это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Сбор или упаковка данных или записей не выполняется.
Источники данных, которые не поддерживают только схему, не будут объединены или упакованы. Если отмечен параметр Только схема и инструменту встречается слой, который поддерживается не только схемой, отображается предупреждающее сообщение и этот слой будет пропущен. Если единственный указанный слой не поддерживается только для схемы, инструмент не будет выполнен.
При распаковке пакета геообработки используйте инструмент Извлечь пакет, чтобы выложить содержимое в папку. Можно переместиться к папке и изучить инструмент и данные. Или щелкните правой кнопкой на пакете в папке на панели Каталог и извлеките его в текущую карту. Инструмент будет доступен из Истории геообработки.
По умолчанию при извлечении пакета в панели Каталог содержимое будет извлечено в профиль пользователя.
Синтаксис
PackageResult(in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version}, {select_related_rows})| Parameter | Объяснение | Тип данных |
in_result [in_result,...] | Упаковываемый результат. Входными данными может быть либо результат, взятый из истории вашего текущего проекта, либо свойство объектаResult resultID при использовании инструмента в скрипте Python . | File; String |
output_file | Имя и местоположение выходного файла пакета (.gpkx). | 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 |
select_related_rows (Дополнительный) | Указывает, будет ли указанный экстент применяться к связанным источникам данных.
| Boolean |
Пример кода
Пример скрипта 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")Следующий скрипт 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.resultID, "c:/gpks/parcelgpk.gpkx",
"PRESERVE", "CONVERT_ARCSDE", "#", "ALL",
"ALL", "DESKTOP", "#", "Summary text", "Tag1")Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да