Работа с примерами геообработки

Пример геообработки - это удобный способ предоставления общего доступа к инструментам геообработки и рабочим процессам. Пример геообработки - это файл .zip, содержащий наборы инструментов, скрипты, модели, данные и вспомогательные файлы, используемые для запуска инструментов геообработки в ArcGIS. Пример геообработки может быть локальным файлом .zip, расположенном на вашем компьютере или в сетевой папке. Либо пример геообработки может быть опубликован и размещен в разделе Мои ресурсы в ArcGIS Online или вашего портала ArcGIS Enterprise.

Вы, как и другие пользователи, могут воспользоваться инструментами и данными внутри примера геообработки путем его добавления к вашему проекту ArcGIS Pro.

Примечание:

Либо можно опубликовать и использовать пакеты геообработки вместо примеров. Пакеты геообработки предлагают похожие возможности без необходимости ручного создания и архивации папки, содержащей ваш набор инструментов и другие файлы.

Создать пример геообработки

После создания пользовательских инструментов-скиптов или инструментов-моделей в наборе инструментов соберите все необходимые вам ресурсы, в частности, наборы инструментов, скрипты, данные, документы, проекты и т. д., в одну папку, которую можно сжать в файл .zip.

Примечание:

Убедитесь, что инструменты-скрипты, содержащиеся в вашем наборе инструментов, переменные ваших моделей, слои вашего проекта и другие ресурсы ссылаются на относительные пути, и соответствующие пути обновились в соответствии с местоположением общей папки. Иначе для использования примера геообработки пути к ресурсам придется восстанавливать.

После сборки примера протестируйте свои модели и инструменты-скрипты, а также другие ресурсы, чтобы убедиться, что все их ссылки корректны, и инструменты работают. Кроме того, можно создать описание пользовательских инструментов, чтобы другим пользователям было удобно и легко с ними работать.

Рекомендации относительно структуры папок и ресурсов

Чтобы собрать все используемые вашими инструментами ресурсы, рекомендуется следующая структура папок. После сбора вы выполните сжатие этой папки в файл .zip, чтобы создать пример геообработки.

Имя папкиОписание содержимого

<Корневая папка>

Это корневая папка примера геообработки, содержащая все остальные каталоги и набор с инструментами геообработки. Это имя папки должно совпадать с предполагаемым именем элемента примера и именем файла .zip.

ToolData

Содержит все данные, используемые вашими инструментами, в том числе, данные примера. В этой папке обычно находятся базы геоданных, шейп-файлы, растры, проекты и файлы слоев.

Скрипты

Содержит скрипты (файлы .py) для всех инструментов-скриптов примера.

Scratch

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

Doc

Содержит всю информацию, которая поможет пользователю понять работу вашего примера, а именно: файлы .pdf, документы Microsoft Word и презентации PowerPoint.

Рекомендуемая структура папок примера геообработки

Создание файла .zip примера геообработки

После объединения ваших ресурсов примера и проверки работоспособности инструментов создайте файл .zip, выполнив следующие действия:

  1. В Проводнике выберите папку, в которой находится корневой каталог вашего собранного примера геообработки.
  2. Щелкните правой кнопкой корневую папку и выберите Отправить > Сжатая ZIP-папка. Либо воспользуйтесь любым имеющимся архиватором, чтобы создать файл .zip.

Новый файл .zip будет находиться в текущей директории. Если этот каталог предназначен только для чтения, появится диалоговое окно, которое предложит вам создать файл на вашем рабочем столе или в вашей пользовательской директории.

Публикация примера геообработки

Примеры геообработки упакованы в один файл .zip, который можно отправить по email, сохранить в общей папке или на веб-странице для загрузки. Они также являются элементом поддерживаемого типа, который можно загрузить и разместить в разделе Мои ресурсы в ArcGIS Online или на вашем портале ArcGIS Enterprise. Выгрузите свой пример геообработки, выполнив следующие действия:

  1. Откройте в веб-браузере сайт arcgis.com или домашнюю страницу своего портала ArcGIS Enterprise.
  2. Войдите под своими учетными данными.
  3. В верхней части сайта щелкните Ресурсы.
  4. Щелкните кнопку Новый элемент.
  5. Перетащите свой файл .zip в область размещения либо щелкните кнопку Ваше устройство или другую кнопку, чтобы выбрать свой файл .zip.
  6. Щёлкните ниспадающее меню Тип элемента и измените тип на Пример геообработки, а затем нажмите Далее.
  7. Введите заголовок элемента, папку, теги и краткое описание и щелкните Сохранить.

После выполнения этих действий вы попадете на страницу сведений об элементе примера геообработки, где сможете дополнительно настроить и выбрать параметры общего доступа к элементу. По умолчанию, только владелец элемента может работать с ним и выполнить его загрузку. Щелкните кнопку Общий доступ, чтобы изменить уровень публикации на Организация или Для всех (общий), чтобы другие пользователи смогли работать с примером и загружать его.

Использование примера геообработки

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

  • Локальный файл .zip
  • Размещенный элемент Пример геообработки

Локальный файл .zip

Чтобы воспользоваться ранее загруженным либо скопированным из папки на вашем компьютере или из сетевой папки примером геообработки, выполните следующие действия:

  1. В Проводнике найдите местоположение файла .zip.
  2. Щелкните правой кнопкой .zip и выберите Извлечь все для извлечения содержимого архива.
  3. В ArcGIS Pro подключитесь к папке с извлеченными данными в вашем проекте.

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

Размещенный элемент Пример геообработки

Для работы с примером геообработки, размещенном в ArcGIS Online или на вашем портале ArcGIS Enterprise, выполните описанные ниже действия.

Примечание:

Следующие действия применяются к элементу Пример кода, а также к примерам геообработки.

  1. Войдите на портал и активируйте его в ArcGIS Pro.
  2. Найдите на портале пример геообработки, который вы собираетесь использовать.
  3. Кроме того, можно отфильтровать результаты поиска, задав Тип элемента: Инструменты, чтобы было проще найти примеры геообработки.
  4. После того, как вы найдете нужный элемент, щелкните его правой кнопкой и выберите Добавить в проект.
    Размещенный пример геообработки с командой Добавить в проект

Добавив размещенный пример геообработки в свой проект, вы выполните следующие действия:

  • Загрузите и разархивируйте файл .zip образца геообработки в папку загрузки для параметра Другие пакеты и файлы, определенного в опциях загрузки. После извлечения файл .zip будет удален.
  • Добавьте наборы инструментов в Наборы инструментов проекта.
  • Добавьте подключение к корневой папке разархивированного каталога.

Инструменты в наборах, добавленных в ваш проект, можно найти в узле проекта Наборы инструментов или выполнив поиск инструментов на панели Геообработка.