Пользовательские функции растра Python

Функции растра Python - это пользовательские скрипты, которые можно использовать для обработки и анализа растровых данных в ArcGIS. Хотя ArcGIS предоставляет полный набор встроенных функций растра, некоторые аналитические требования могут потребовать пользовательских реализаций. Эти пользовательские функции, разработанные в Python, могут быть интегрированы в последовательности функций растра для расширения аналитических возможностей стандартной аналитики растра.

В ArcGIS Enterprise 11.5 был представлен новый административный API для упрощения регистрации, развертывания и управления пользовательскими функциями растра Python. Этот API предоставляет администраторам простой интерфейс для управления пользовательскими функциями в многопользовательской среде.

Дополнительные сведения об использовании этого административного API находятся в документации к ArcGIS Enterprise.

Требования упаковки для пользовательских функций растра Python

Для успешного развертывания пользовательской функции растра Python в ArcGIS Enterprise, убедитесь, что соблюдены следующие условия:

  1. Требуемые файлы
    • Шаблон функции растра (.rft.xml) — определяет последовательность функций растра и ссылается на связанный скрипт Python.
    • Скрипт Python (.py) - содержит реализацию пользовательских функций растра.

    Оба файла должны быть включены в пакет развертывания.

  2. Правила присвоения имен
    • Согласованность - имя скрипта Python должно соответствовать имени, указанному в файле шаблона функции растра.
    • Допустимые символы - имена файлов должны начинаться с буквы и могут содержать буквы, цифры и знаки нижнего подчеркивания.
      Внимание:

      Не используйте специальные символы и не начинайте имена с цифр.

  3. Спецификация пути к файлу

    В шаблоне функции растра, чтобы сослаться на скрипт Python, необходимо использовать префикс [functions], а затем указать относительный путь. Например:

    [functions]Custom\Subfolder\script_name.py

    Этот синтаксис позволяет ArcGIS найти скрипт в назначенной директории функций.

  4. Структура каталога

    Расположите файлы в подпапке в соответствии с директорией в пути к файлу, указанной в шаблоне функции растра. Например:

    "PythonModule": "[functions]Custom\\Tree_Health.py"

    Для этого примера файл zip должен содержать файл rft и файл Python.

    Схема содержания папки
    Концептуальная графика содержания папки.
  5. Пакет развертывания

    Сожмите подпапку, содержащую файлы .rft.xml и .py, в архив .zip. Этот пакет можно зарегистрировать и развернуть с помощью административного API, представленного в ArcGIS Enterprise 11.5.

Развертывание пользовательской функции растра Python в ArcGIS Enterprise

Чтобы выполнить развертывание пользовательской функции растра Python в ArcGIS Enterprise, выполните следующие действия:

  1. Выполните доступ к директории API администратора
    • Перейдите к директории API администратора ArcGIS Enterprise.
    • Войдите под учетной записью с правами администратора.
  2. Регистрация пользовательской функции растра
    • В директории административного API перейдите к Сервисы>Типы.
    • Выберите Пользовательские функции растра.
    • Щелкните кнопку Регистрация.
    • Используйте опцию Выбрать файл, чтобы найти и выбрать файл .zip, содержащий пользовательскую функцию растра.
    • Щелкните Зарегистрировать, чтобы завершить процесс регистрации.
  3. Проверка регистрации
    • После успешной регистрации пользовательская функция растра появится в разделе Зарегистрированные пользовательские функции растра в директории административного API.
  4. Использование Зарегистрированной функции на портале
    • Вход на портал ArcGIS Enterprise
    • Перейдите в Мои ресурсы или в Мою организацию, чтобы найти зарегистрированный элемент шаблона пользовательской функции растра.
  5. Использование пользовательской функции растра
    • Зарегистрированную пользовательскую функцию растра теперь можно использовать аналогично системным шаблонам функций растра.
    • Ее можно включить в рабочие процессы обработки растра с помощью таких инструментов, как Редактор функций растра.