自定义 Python 栅格函数

Python 栅格函数是可用于在 ArcGIS 中处理和分析栅格数据的自定义脚本。 虽然 ArcGIS 提供了一套全面的内置栅格函数,但某些分析要求可能需要自定义实现。 这些在 Python 中开发的自定义函数可以集成到栅格函数链中,以扩展标准栅格分析的分析功能。

ArcGIS Enterprise 11.5 中,引入了新管理 API,以简化自定义 Python 栅格函数的注册、部署和管理。 该 API 为管理员提供了直观界面来管理整个企业环境中的自定义函数。

有关使用此管理 API 的详细信息,请参阅 ArcGIS Enterprise 文档

自定义 Python 栅格函数的打包要求

要在 ArcGIS Enterprise 中成功部署自定义 Python 栅格函数,请确保满足以下先决条件:

  1. 所需文件
    • 栅格函数模板 (.rft.xml) - 定义栅格函数链并引用相关 Python 脚本。
    • Python 脚本 (.py) - 包含自定义栅格函数的实现。

    两个文件都必须包含在部署包中。

  2. 命名约定
    • 一致性 - Python 脚本的名称必须与栅格函数模板文件中指定的名称相匹配。
    • 有效字符 - 文件名应以字母开头,可以包含字母、数字和下划线。
      警告:

      避免使用以数字开头的特殊字符。

  3. 文件路径规格

    在栅格函数模板中,使用 [functions] 前缀后跟相对路径引用 Python 脚本。 例如:

    [functions]Custom\Subfolder\script_name.py

    语法可确保 ArcGIS 在指定的函数目录中找到脚本。

  4. 目录结构

    按照您在栅格函数模板中指定的文件路径目录来组织子文件夹中的文件。 例如:

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

    对于此示例 zip 文件,内容应包含 rft 文件和 Python 文件。

    文件夹内容概念
    文件夹内容的概念图。
  5. 部署包

    将包含 .rft.xml 和 .py 文件的子文件夹压缩为 .zip 存档文件。 可以使用 ArcGIS Enterprise 11.5 中引入的管理 API 来注册和部署该包。

ArcGIS Enterprise 中部署自定义 Python 栅格函数

要在 ArcGIS Enterprise 中部署自定义 Python 栅格函数,请按照以下步骤操作:

  1. 访问管理员 API 目录
    • 导航至 ArcGIS Enterprise 管理员 API 目录。
    • 使用具有管理权限的帐户登录。
  2. 注册自定义栅格函数
    • 在管理员 API 目录中,转至服务> 类型
    • 选择自定义栅格函数
    • 单击注册按钮。
    • 使用选择文件选项浏览并选择包含自定义栅格函数的 .zip 文件。
    • 单击注册完成注册过程。
  3. 验证注册
    • 注册成功后,自定义栅格函数将显示在管理员 API 目录中的已注册自定义栅格函数下。
  4. 访问门户中的已注册函数
    • 登录到 ArcGIS Enterprise 门户
    • 导航至我的内容我的组织查找注册的自定义栅格函数模板项目。
  5. 使用自定义栅格函数
    • 已注册的自定义栅格函数现在可以像系统提供的栅格函数模板一样使用。
    • 可以使用栅格函数编辑器等工具将其合并到栅格处理工作流中。