在 ArcGIS Enterprise 11.0 中引入,ArcGIS Notebook Server 允许您浏览可重用代码的预写部分(称为代码片段)并将其插入到笔记本中。
创建代码片段
您可以从笔记本创建代码片段。 所创建的代码片段可以用于同一笔记本或其他笔记本。 所创建的代码片段存储在您的内容中的笔记本代码片段库项目中,此项目用于组织您的代码片段,并且支持共享。
要创建代码片段,您必须先创建一个笔记本代码片段库,以便在其中存储代码片段。 代码片段库最多可包含 100 个片段。
创建笔记本代码片段库
要创建代码片段库,请完成以下步骤:
- 在笔记本编辑器的顶部功能区上,单击代码片段。
- 单击添加按钮 ,然后选择创建库项目。
- 输入库的标题和摘要,然后选择性地添加标签,这些标签用于表示存储在库中的代码片段。
- 单击创建。
添加代码片段
创建库后,即可向其中添加代码片段。 要添加代码片段,请执行以下操作:
- 在笔记本编辑器的顶部功能区上,单击代码片段。
- 单击添加按钮 ,然后选择添加代码片段。
- 输入代码片段的标题,选择要添加代码片段的库,然后输入描述。
选择代码片段库项目下拉列表显示了可向其添加片段的库。 该列表还指示了该库中共享设置为继承的片段数。
- 添加片段的代码。
- 如果笔记本使用运行时版本 8.0 或更高版本,需选择要添加为代码片段的单元格,然后单击从活动单元格复制。
- 如果笔记本使用运行时版本 7.0 或较早版本,需输入代码片段的代码。
注:
对于使用运行时版本 7.0 或较早版本的笔记本,需从笔记本单元格中复制并粘贴代码而不是直接输入代码,以避免缩进错误或其他语法错误。
- 单击保存。
您可以单击代码片段的更多选项按钮 ,然后单击编辑以更改代码片段。
插入代码片段
使用代码片段窗格,完成以下步骤以插入代码片段:
- 在笔记本编辑器的顶部功能区上,单击代码片段。
- 浏览要插入的代码片段所在的代码片段库。
- 单击代码片段的查看详细信息以查看代码预览。
- 找到要插入的代码片段后,单击代码片段窗格中的添加按钮 或单击代码预览窗格中的添加到笔记本,将代码片段作为新单元格插入到笔记本中。
以下是添加到笔记本的代码片段示例。
# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
if "admin" in gis.__dict__:
credits = gis.admin.credits.credits
print(f"This ArcGIS Online organization has {credits} credits.")
else:
print("Please connect to the ArcGIS Online organization as an administrator to check credits.")
# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")
# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)
Esri 代码片段
所有可用的代码片段均为 Esri 精选内容。 这些精选的代码片段允许您在笔记本中实施常见的 GIS 工作流。 将代码片段编写为 Python 函数,这些函数可被插入到笔记本中并支持全范围调用。 将代码片段添加到笔记本后,也可以对其进行编辑。
注:
在 11.0 中,精选代码片段的名称和描述仅提供英文版本。
以下是可以插入到笔记本中的可用代码片段:
- GIS 管理 - 执行常见 GIS 管理任务的代码片段
注:
其中许多代码片段需要管理员连接。
- 检查剩余配额(仅限 ArcGIS Online)。
- 检查特定用户的配额(仅限 ArcGIS Online)。
- 获取图层项目的基础服务 URL。
- 查询门户日志并另存为 CSV(仅限 ArcGIS Enterprise)。
- 登录 ArcPy 门户
- 内容管理 - 代码片段有助于管理 GIS 中的内容和笔记本工作区目录中的文件。
- 在工作空间目录中复制地理数据库。
- 使用空要素类创建文件地理数据库。
- 在工作空间目录中创建文件夹。
- 将文件项目从门户下载到工作空间目录。
- 列出数据集。
- 列出文件。
- 从工作空间目录中移除文件地理数据库。
- 从工作空间目录中移除文件夹。
- 解压文件到工作空间目录。
- 数据科学和分析 - 可以使用 ArcGIS API for Python、ArcPy 和其他 Python 库在您的数据科学和分析工作流中实施的代码片段。
注:
使用高级笔记本运行时以运行需要 ArcPy 的代码片段。 有关笔记本运行时的详细信息,请参阅指定笔记本的运行时。
- 将要素类转换为要素图层。
- 将要素类转换为启用空间功能的 DataFrame。
- 将要素图层转换为启用空间功能的 DataFrame。
- 将启用空间功能的 DataFrame 转换为要素类。
- 从 URL 显示图像。
- 从工作空间目录显示图像。
- 填充缺失值。
- 列出要素类中的字段。
- 列出图层中的字段。
- 列出项目中的图层。
- 绘制启用空间功能的 DataFrame(快速入门)。
- 使用分类间隔渲染器绘制启用空间功能的 DataFrame。
- 使用简单渲染器绘制启用空间功能的 DataFrame。
- 使用唯一值渲染器绘制启用空间功能的 DataFrame。
- 将启用空间功能的 DataFrame 发布为要素图层。