使用脚本环境

Insights in ArcGIS Enterprise
Insights 桌面版
注:

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 并创建到网关的连接。 创建网关连接后,完成以下步骤以打开脚本环境并开始编写脚本:

  1. 如有必要,可打开工作簿并添加数据。
    提示:

    您还可以从脚本环境中加载数据。

  2. 单击工作簿工具栏上的脚本按钮 脚本。
  3. 如果连接未保存在之前工作簿中,请执行以下操作之一:
    • 在 Insights desktop 中,如果显示新建 Jupyter Kernel Gateway 连接窗口,则表示您尚未创建到网关的连接。 提供网关的 URL 和 Web 套接字地址以创建连接。 有关详细信息,请参阅连接到核网关。
    • 在 Insights in ArcGIS Enterprise 中,如果显示核网关连接窗口,请从环境名称菜单中选择现有核网关连接。 您也可以通过新增选项卡创建连接。 有关详细信息,请参阅连接到核网关。

    脚本环境随即打开,脚本标题将添加到数据窗格中。

  4. 在选择核菜单中,选择用于编写脚本的核。

    根据您使用的核网关连接,选项可以是 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[ ] 单元格中进行输入,可以直接在脚本环境中创建脚本。 要将现有脚本加载到脚本环境中,请完成以下步骤:

  1. 如有必要,请打开脚本环境,然后为要运行的脚本选择正确的核。
  2. 单击脚本环境工具栏上的导入文件按钮 导入文件。
  3. 浏览并打开要运行的脚本。

    该脚本将在 In[ ] 单元格中打开。

  4. 单击脚本环境工具栏上的运行按钮 运行。

脚本随即运行,其结果显示在 Out[ ] 单元格中。

也可以将在数据窗格中保存的脚本加载到脚本环境中。 要从数据窗格中加载脚本,请完成以下步骤:

  1. 在数据窗格中展开脚本标题。
  2. 单击要加载的脚本的数据集选项按钮 数据集选项。
  3. 单击打开。

    该脚本将在 In[ ] 单元格中打开。

创建一个图像卡片

可以从 Out[ ] 单元格中导出脚本结果(如图表)以在您的 Insights 页面上创建一个图像卡片。 要导出单元格,您必须使用运行按钮 运行 运行脚本,突出显示 Out[ ] 单元格,然后单击创建卡片按钮 创建卡片 以将图像从 Out[ ] 单元格移动至图像卡片。

注:

从脚本创建的图像卡片是静态的,并且不具有在 Insights 中创建的地图、图表和表格卡片的交互功能。

将脚本保存到模型中

可以使用添加到模型按钮 添加到模型 将脚本环境中的脚本作为 Insights 脚本添加到模型。 可以在分析视图 分析视图 中对 Insights 脚本进行编辑。 有关在 Insights 中更新模型的详细信息,请参阅重新运行分析。

清除或关闭脚本环境

要清除脚本环境,包括所有 In[ ] 和 Out[ ] 单元格,请单击重启按钮 重新启动。 清除脚本环境操作无法撤消。

要关闭脚本环境,可单击“关闭”按钮 关闭 或浏览至 Insights 中的其他页面。

要在 Insights 页面和脚本环境之间进行切换,可使用最小化按钮 最小化 来最小化环境,而不是将其关闭,由此您将不会丢失脚本。