注:
Insights 脚本环境在 Insights in ArcGIS Enterprise 和 Insights desktop 中可用。 主连接可以是 Insights in ArcGIS Enterprise 或 Insights in ArcGIS Online。
在安装过程中,可以为 Insights in ArcGIS Enterprise 组织禁用 Jupyter Kernel Gateway 连接。 如果 Jupyter Kernel Gateway 连接不可用,请与管理员联系。 有关详细信息,请参阅安装 Insights in ArcGIS Enterprise。
连接到 Jupyter Kernel Gateway 后,可以访问脚本环境并使用其在 Python 和 R 中创建和运行脚本。 脚本环境包含 In[ ] 单元格(用于加载或写入脚本)、Out[ ] 单元格(用于显示结果)以及一个工具栏。
打开脚本环境
要使用脚本环境,必须先安装 Jupyter Kernel Gateway 并创建到网关的连接。 创建网关连接后,完成以下步骤以打开脚本环境并开始编写脚本:
- 如有必要,可打开工作簿并添加数据。
提示:
您还可以从脚本环境中加载数据。
- 单击工作簿工具栏上的脚本按钮 。
- 如果连接未保存在之前工作簿中,请执行以下操作之一:
- 在 Insights desktop 中,如果显示新建 Jupyter Kernel Gateway 连接窗口,则表示您尚未创建到网关的连接。 提供网关的 URL 和 Web 套接字地址以创建连接。 有关详细信息,请参阅连接到核网关。
- 在 Insights in ArcGIS Enterprise 中,如果显示核网关连接窗口,请从环境名称菜单中选择现有核网关连接。 您也可以通过新增选项卡创建连接。 有关详细信息,请参阅连接到核网关。
脚本环境随即打开,脚本标题将添加到数据窗格中。
- 在选择核菜单中,选择用于编写脚本的核。
根据您使用的核网关连接,选项可以是 Python、R 或两者。
脚本环境将进行更新,包含 In[ ] 单元格和一个工具栏。
现在,即可使用脚本环境来创建、加载和运行脚本。
脚本会自动以 Insights Script 为名称保存在数据窗格中的脚本标题下。 您可以使用重命名脚本按钮 重命名脚本。
使用数据集选项按钮 也可以为脚本提供以下选项:
- 打开 - 将脚本加载到 In[ ] 单元格。
- 运行 - 在不打开脚本环境的情况下运行脚本。
- 下载 - 将脚本作为 Jupyter Notebook 文件 (.ipynb) 下载。
- 发布 - 发布脚本以创建 Insights 脚本项目(可用于 Insights in ArcGIS Enterprise)。
- 移除 - 从数据窗格中移除脚本。
编辑脚本
即使已执行 In[ ] 单元格,仍然可以在该单元格中对脚本进行编辑。 要编辑脚本,请单击单元格,进行相应编辑,然后运行该单元格。 将使用经过编辑的结果创建新的 Out[ ] 单元格。
导出脚本
可以导出在脚本环境中编写的脚本,然后将其另存为 .py 脚本 (Python) 或 .R 脚本 (R)。 要从脚本环境导出脚本,可选择一个或多个单元格,然后单击导出按钮 。
保存脚本时,可以使用以下导出选项:
- 下载所选单元格 - 仅保存所选 In[ ] 单元格中的脚本。
- 下载历史记录 - 在脚本环境中,将所有 In[ ] 单元格中的脚本另存为 Jupyter Notebook 文件 (.ipynb)。
导出的脚本将保存在计算机上的默认下载文件夹中。
加载脚本
通过在 In[ ] 单元格中进行输入,可以直接在脚本环境中创建脚本。 要将现有脚本加载到脚本环境中,请完成以下步骤:
- 如有必要,请打开脚本环境,然后为要运行的脚本选择正确的核。
- 单击脚本环境工具栏上的导入文件按钮 。
- 浏览并打开要运行的脚本。
该脚本将在 In[ ] 单元格中打开。
- 单击脚本环境工具栏上的运行按钮 。
脚本随即运行,其结果显示在 Out[ ] 单元格中。
也可以将在数据窗格中保存的脚本加载到脚本环境中。 要从数据窗格中加载脚本,请完成以下步骤:
- 在数据窗格中展开脚本标题。
- 单击要加载的脚本的数据集选项按钮 。
- 单击打开。
该脚本将在 In[ ] 单元格中打开。
创建一个图像卡片
可以从 Out[ ] 单元格中导出脚本结果(如图表)以在您的 Insights 页面上创建一个图像卡片。 要导出单元格,您必须使用运行按钮 运行脚本,突出显示 Out[ ] 单元格,然后单击创建卡片按钮 以将图像从 Out[ ] 单元格移动至图像卡片。
注:
从脚本创建的图像卡片是静态的,并且不具有在 Insights 中创建的地图、图表和表格卡片的交互功能。
将脚本保存到模型中
可以使用添加到模型按钮 将脚本环境中的脚本作为 Insights 脚本添加到模型。 可以在分析视图 中对 Insights 脚本进行编辑。 有关在 Insights 中更新模型的详细信息,请参阅重新运行分析。
清除或关闭脚本环境
要清除脚本环境,包括所有 In[ ] 和 Out[ ] 单元格,请单击重启按钮 。 清除脚本环境操作无法撤消。
要关闭脚本环境,可单击“关闭”按钮 或浏览至 Insights 中的其他页面。
要在 Insights 页面和脚本环境之间进行切换,可使用最小化按钮 来最小化环境,而不是将其关闭,由此您将不会丢失脚本。