使用脚本环境

Insights in ArcGIS Enterprise
Insights 桌面版
注:

Insights 脚本环境在 Insights in ArcGIS EnterpriseInsights desktop 中可用。 主连接可以是 Insights in ArcGIS EnterpriseInsights in ArcGIS Online

在安装过程中,可以为 Insights in ArcGIS Enterprise 组织禁用 Jupyter Kernel Gateway 连接。 如果 Jupyter Kernel Gateway 连接不可用,请与管理员联系。 有关详细信息,请参阅安装 Insights in ArcGIS Enterprise

连接到 Jupyter Kernel Gateway 后,可以访问脚本环境并使用其在 PythonR 中创建和运行脚本。 脚本环境包含 In[ ] 单元格(用于加载或写入脚本)、Out[ ] 单元格(用于显示结果)以及一个工具栏。

打开脚本环境

要使用脚本环境,必须先安装 Jupyter Kernel Gateway创建到网关的连接。 创建网关连接后,完成以下步骤以打开脚本环境并开始编写脚本:

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

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

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

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

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

    根据您使用的核网关连接,选项可以是 PythonR 或两者。

    脚本环境将进行更新,包含 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 页面和脚本环境之间进行切换,可使用最小化按钮 最小化 来最小化环境,而不是将其关闭,由此您将不会丢失脚本。