Skip to main content

在 notebook 中使用 ArcPy

可通过 Advanced notebook 运行时在 ArcGIS Notebooks 中使用多个 ArcPy 模块。

您可以使用 ArcPy 站点包执行地理数据分析、转换和管理。 ArcPy 允许您以编程方式运行所有 ArcGIS 标准地理处理工具并提供帮助程序函数和类。

了解有关 ArcPy 的详细信息

要在 notebook 中使用 ArcPy，ArcGIS Notebook Server 需具有 Advanced 许可，且用户必须拥有创建和运行 ArcPy notebook 的权限。

Notebook 中的 ArcPy 入门

要在 notebook 中使用 ArcPy，请通过运行包含以下行的单元格来导入库：

import arcpy
arcpy.GetInstallInfo()['Version']

要访问或共享组织中的内容，您必须登录组织。 在 ArcGIS Notebooks 中，可以通过使用以下代码在无需显式提供 URL、用户名或密码的情况下登录您的组织：

arcpy.SignInToPortal("notebook")

提示：

虽然大多数 ArcPy 工具支持 Linux 风格的路径，但建议在 Windows 容器中运行 notebook 时，对文件和目录使用 Windows 格式的路径，例如 C:\arcgis\home。 这样可确保 ArcPy 工具和工作流成功运行。

也可以动态构建工作空间路径。 例如：

import os
import arcpy
drive = os.path.splitdrive(os.getcwd())[0]
home_dir = os.path.join(drive + os.sep, "arcgis", "home")
arcpy.env.workspace = home_dir

ArcPy 模块

以下模块包含在 ArcGIS Notebooks 的 ArcPy 中。

  • 数据访问模块 (arcpy.da) 可控制编辑会话、编辑操作、改进的游标支持（包括更快的性能）、表和要素类与 NumPy 数组之间相互转换的函数以及对版本化、复本、属性域和子类型工作流的支持。

  • 地理编码模块 (arcpy.geocoding) 可用于进行各种地理编码操作，包括查找某个地点或地址的位置、查找距离给定位置最近的地点或地址、或者为部分输入生成一组自动完成建议。

  • 影像分析模块 (arcpy.ia) 可用于管理和处理影像及栅格数据。 该模块中还包含 ArcGIS Image Analyst 扩展模块提供的地理处理和栅格处理自动化功能。

  • 制图模块 (arcpy.mp) 可用于处理现有工程 (.aprx) 和图层文件 (.lyrx) 的内容，以及创建和修改地图、布局和报告。

  • 元数据模块 (arcpy.metadata) 可用于探索描述地图和数据的信息，并自动化工作流，特别是管理符合标准的地理空间元数据。

  • Network Analyst 模块 (arcpy.nax) 可与 ArcGIS Network Analyst 扩展模块提供的网络分析功能搭配使用。

    旧版模块 arcpy.na 不包含在 ArcGIS Notebooks 中。

  • 共享模块 (arcpy.sharing) 可用于自动化共享工作流。 使用它可以创建共享草稿，该草稿是 Web 图层、Web 工具和地理处理服务、地图服务或影像服务的一组可配置属性。

  • Spatial Analyst 模块 (arcpy.sa) 可用于访问 Spatial Analyst 工具箱中可用的所有地理处理工具以及其他可以自动化栅格处理工作流的函数和类。

ArcPy 函数

ArcPy 提供了许多函数，以便更好地支持使用 Python 的工作流。 除了本主题中列出的函数组之外，所有地理处理工具都可以作为 ArcPy 函数进行访问。

有关每个组内函数的详细信息，请参阅 ArcGIS Pro 文档中的 ArcPy 函数概览。

ArcGIS Notebooks 包含下列函数组：

  • ArcGIS Online / 门户函数

  • 数据存储函数

  • 描述数据函数

  • 环境函数

  • 字段函数

  • 常规函数（除 ListPrinterNames 之外）

  • 常规数据函数

  • 几何函数

  • 许可和安装函数

  • 列出数据函数（除 ListVersions 之外）

  • 日志记录函数

  • 打包函数

  • 进度对话框函数

  • 栅格函数

  • 空间参考和转换函数