“分析”微件

“分析”微件用于向应用程序添加空间分析工具、栅格函数和地理处理工具。空间分析工具用于执行基本 GIS 操作，例如创建视域、创建缓冲区、将栅格转换为要素和路径选择。 栅格函数用于对栅格数据执行相应的操作，例如转换为灰度并进行分类。 空间分析是一种地理处理，但地理处理还包括执行数据管理操作（例如排序、合并和附加空间数据）的工具。 可添加 64 个内置空间分析工具以及超过 100 个内置栅格函数，大多数工具和函数也会在 Map Viewer 中提供。 还可以从 ArcGIS 组织添加自定义地理处理工具，以及使用 ArcGIS Notebooks 发布的工具。

示例

使用此微件可支持以下应用程序设计要求：

• 很多雨水道连接了湖泊、河流和海洋，这使得任何流入水道的东西均成为下游的潜在汚染物。 您希望提供一个工具（“创建流域”）来帮助确定汇入雨水道中的水的来源。
• 一家开发公司计划在一座城市中打造全新的综合性开发项目。 该开发项目必须位于距商店、饭店和轻轨站点 0.25 英里的范围内。 您希望提供一个工具（“创建缓冲区”）来确定潜在站点是否符合此条件。
• 林业工作者需要绘制树木疾病传播地图。 您希望提供一个工具（“查找热点”）来标识具有统计显著性数量的病株或健康株的区域。

用法说明

要使用任何内置工具，必须将“分析”微件连接到“地图”微件。 但是，如果您仅添加不需要图层输入的自定义工具，则无需连接“地图”微件。

当在应用程序中包含此微件时，运行时微件面板将具有两个选项卡。 工具选项卡将列出在微件设置中添加的所有工具。 历史记录选项卡将记录用户运行的所有工具并显示其状态（例如，正在运行、已完成、已取消）。 在历史记录选项卡中，可以单击每个工具旁的选项按钮以查看详细信息、打开该工具或移除该工具。 单击查看详细信息可查看该分析的结果。 单击打开工具可查看工具的配置窗口，其中包含您之前已使用的相同参数。

Web 地图将追踪其分析历史记录，包括在 Experience Builder 外部（例如在 Map Viewer 中）运行的成功和不成功的分析。 可以在微件的设置中导入 web 地图的分析历史记录。 从地图分析历史记录导入的任何工具都会显示在历史记录选项卡的顶部，并且在运行时无法将其移除。

注：

只能导入涉及 Esri 内置工具的过去空间分析。 该微件目前不支持从 web 地图的分析历史记录中导入自定义工具分析。

参数

打开工具后，用户将填充工具的参数，这些参数是一组选项或设置，例如要处理的输入图层以及用于保存输出数据集的位置。 每个工具都具有一组唯一的参数，这些参数可以是必需的，也可以是可选的。 红色圆圈将指示参数是否为必需参数。 每个工具参数旁的信息按钮可提供有关每个参数的详细信息。

注：

目前，该微件不支持地图服务图层作为输入图层。

工具具有输入和输出参数。 每个内置工具都要求用户至少指定一个要进行分析的输入图层。 可通过两种方式来指定输入数据：

• 从连接的“地图”微件中选择图层。 如果“地图”微件包含 web 地图，则可以选择其图层。
• 在我的内容、ArcGIS Online 或组织门户中浏览图层。

  注：

  只能使用内置工具浏览输入图层，而不能使用自定义地理处理工具。

输出参数为结果图层的名称以及我的内容中保存结果的文件夹的名称。

环境设置下的可选参数将提供对工具结果的附加控制。 例如，可以指定输出坐标系或者将分析限制在特定地理范围内。

每个地理处理工具也具有一组唯一的参数。 工具创建者可以选择使用 100 多种参数数据类型来提供输入和返回输出，但并非所有都受 Experience Builder 支持。 查看 ArcGIS Experience Builder 支持的地理处理数据类型的完整列表。

配额

此微件的内置空间分析工具将消耗配额。 每个工具都具有估计配额按钮，在运行分析之前，可以使用该按钮来查看分析将消耗的配额数量，该按钮位于运行和返回按钮上方。 该按钮将指示分析是否不消耗配额。

许可要求

要使用“分析”微件，用户必须使用具有执行分析权限的 ArcGIS 账户进行登录。 如果将“分析”微件包含在应用程序中并公开共享该应用程序，则此微件将提示用户登录到具有权限的账户。

要使用栅格分析工具和栅格函数，必须具有 ArcGIS Image for ArcGIS Online。 组织管理员可以授予您执行分析所需的权限。

了解有关空间分析许可要求的详细信息

设置

“分析”微件包含以下设置：

• 选择“地图”微件 - 选择“地图”微件。 单击导入按钮可从连接的 web 地图的分析历史记录中导入空间分析工具。
• 添加工具 - 向微件面板添加工具。
  • 空间分析工具 - 添加 64 个内置空间分析工具中的一个或多个。
  • 栅格函数 - 添加内置栅格函数中的一个或多个。
  • 自定义 web 工具 - 添加自定义地理处理工具。 可以添加地理处理工具作为实用程序服务。
• 工具 - 将在此显示所添加的所有工具。 可以将鼠标悬停在单个工具上以显示两个按钮，一个用于打开工具的配置面板，一个用于移除该工具。 可以单击并拖动以重新排序工具。

  内置空间分析工具具有以下设置：

  • 输出 - 对于每个工具，您都可以选择在分析完成后自动将结果图层添加至地图，并允许用户导出结果。 如果启用允许导出结果，则历史记录选项卡的查看详细信息菜单上的导出按钮可用。
  • 选项 - 对于每个工具，如果从已连接 web 地图的分析历史记录中导入空间分析并且存在该工具的过去实例，则将显示地图历史记录中的预设工具设置。 打开此设置可以使用过去分析中的参数预设该工具。

  自定义地理处理工具具有以下设置：

  • 输入 - 此处将列出该工具的所有输入参数。 可以为每个输入参数提供运行时标注。 根据参数的类型（例如，GPFeatureRecordSetLayer、GPDate），可以选择输入方法、提供默认值等。 查看下表中受支持数据类型的完整列表。
  • 输出 - 此处将列出该工具的所有输出参数。 可以为每个输出参数提供运行时标注。 对于某些类型的参数（例如，GPFeatureRecordSetLayer 和 GPString），会出现其他设置。 您可以允许最终用户导出结果、自动将结果图层添加到连接的地图，或定义结果图层的符号。 选中忽略此输出框可以从结果中移除该输出。
  • 选项 - 为您的自定义工具提供帮助文档。 默认情况下，该微件将读取工具的服务 htm。

• 显示地图中的工具历史记录 - 在运行时，将在历史记录选项卡中显示地图分析历史记录中的工具。

空间分析工具

“分析”微件的内置空间分析工具包含要素分析工具和栅格分析工具。

• 将对矢量数据执行要素分析，这些数据源指使用点、线和面表示地理要素且基于坐标的数据。 可使用要素分析工具基于地理位置汇总要素、测量要素周围或要素之间的距离以及量化空间模式。
• 将对栅格数据执行栅格分析，该数据包含按行和列（或格网）组织的像元（或像素）矩阵，其中每个像元都包含一个表示信息（例如温度或高程）的值。 栅格可以是数字航空照片、卫星影像、数字图片或扫描的地图。 可通过栅格工具图标 识别栅格分析工具。

下表将介绍该微件目前支持的内置分析工具。 单击工具名称以查看其文档。

类别	工具	类型	描述
汇总数据	聚合点	要素分析	计算指定区域内点要素的总数以及区域内点的任何指定统计数据。
	连接要素	要素分析	根据特定的空间和属性关系将属性从一个图层添加至另一图层。
	汇总中心和离差	要素分析	用于确定一组要素的中心要素、中心趋势和标准差椭圆。
	邻近汇总	要素分析	通过直线距离或出行模式来查找输入图层中要素指定距离内的要素。
	范围内汇总	要素分析	用于计算输入图层与边界图层重叠区域的统计数据。
	分区统计	栅格分析	汇总另一个数据集区域内的栅格值。
	以表格显示分区统计	栅格分析	汇总另一个数据集区域内的栅格数据值并以表的形式显示结果。
查找位置	创建视域	要素分析	使用 Esri 高程分析服务以标识可从指定观察点看到的区域。
	创建流域	要素分析	使用托管数字高程模型 (DEM) 来创建集水区。
	选择最佳设施点	要素分析	用于查找满足周边区域请求的最佳设施点集。
	查找属性和位置	要素分析	创建满足指定空间或属性条件的要素或部分要素的新图层。
	查找质心	要素分析	用于创建表示多点、线和面要素的几何中心（质心）的点要素。
	查找相似位置	要素分析	将基于一组条件来评估候选位置与参考位置之间的相似性，并按最相似到最不相似的顺序对候选位置进行排名。
	查找区域	栅格分析	识别输入栅格中符合特定大小要求和空间约束的最佳区域。
	追踪下游	要素分析	将使用托管数字高程模型 (DEM) 来追踪下游水流路径。
丰富数据	丰富图层	要素分析	可使用来自 ArcGIS GeoEnrichment Service 或自定义 GeoEnrichment 服务的人口统计数据和景观数据补充点、线和面要素。
分析模式	计算复合指数	空间统计	组合多个数值变量以创建单一指数。
	计算密度	要素分析	通过将已知量的现象（表示为点或线属性）扩散到整个地图上，从而依据点要素或线要素创建密度地图（面）。
	计算密度（栅格）	栅格分析	通过将现象的已知量（表示为点或线属性）扩散到整个地图上，从而依据点要素或线要素创建密度栅格地图。
	查找热点	要素分析	将使用 Getis-Ord Gi* 统计来识别具有统计显著性的高值（热点）和低值（冷点）的空间聚类或数据计数。
	查找异常值	要素分析	将使用 Anselin Local Moran's I 统计来识别具有统计显著性的热点、冷点和空间异常值。
	查找点聚类	要素分析	将基于点要素的空间分布来标识周围噪点内的点要素聚类。
	插值点	要素分析	将根据在一组点位置处测量的值来预测新位置处的值。
	插值点（栅格）	栅格分析	在每个点处获取具有值的点数据，并使用一种插值方法生成预测值和预测误差值的栅格，所使用的方法通过重复模拟来说明基础半变异函数估算中的误差。
邻近分析	计算行程成本	要素分析	将使用直线或基于网络的出行模式来测量点对之间的行驶时间或距离。
	创建缓冲区	要素分析	用于创建一个区域以在每个输入点、线或面要素周围延伸指定距离。
	距离累积	栅格分析	计算每个像元到输入源的累积距离，允许直线距离、成本距离、真实表面距离以及垂直和水平成本系数。
	距离分配	栅格分析	根据直线距离、成本距离、真实表面距离以及垂直和水平成本系数，计算每个单元到输入源的分配。
	查找最近设施点	要素分析	将使用直线距离或出行模式来测量输入要素和邻近要素之间的距离。
	生成行驶区	要素分析	使用 Esri 服务区来计算特定行驶时间或行驶距离内沿街道网络可以到达的区域。
	最佳路径为线	栅格分析	计算从目的地到最佳源的路径作为一条线。
	最佳路径为栅格	栅格分析	确定从目的地到源的最佳栅格路径。
	最佳区域连接	栅格分析	在两个或多个输入区域之间计算最佳连通性网络。
	计划路径	要素分析	用于确定车队如何在最短的时间内访问一组停靠点。
管理数据	要素转栅格	栅格分析	将要素转换为栅格。
	栅格转要素	栅格分析	将栅格转换为点、线或面要素。
	融合边界	要素分析	查找重叠或共用公共边界的面，然后将其合并到一起以形成一个单个面。
	提取数据	要素分析	可将图层整合到数据集以供 ArcGIS Pro、Microsoft Excel 和其他产品使用。 该工具会在您的内容中创建包含图层数据的项目。 然后，可从该项目中下载数据。
	生成细分面	要素分析	用于创建面积和形状覆盖指定范围的像元格网。
	合并图层	要素分析	用于将相同要素类型（点、线或面）的两个图层中的要素复制到一个新图层中。
	蚕食	栅格分析	将掩膜对应的栅格像元替换为最邻近像元的值。
	叠加图层	要素分析	将使用以下三种方法之一将两个图层合并为一个图层：“相交”、“联合”或“擦除”。
	采样	栅格分析	从所有输入栅格中提取每个输入要素位置处的像元值。
分析地形	派生连续流	栅格分析	根据输入表面栅格生成每个像元的累积流量栅格，且无需事先填充汇或洼地。
	派生流作为线	栅格分析	根据输入表面栅格生成流线要素，且无需事先填充汇或洼地。
	派生流作为栅格	栅格分析	根据输入表面栅格生成流栅格，且无需事先填充汇或洼地。
	填洼	栅格分析	填充表面栅格中的汇点和峰值以移除数据中的小缺陷。
	流量	栅格分析	根据流向栅格生成流入每个像元的累积流量栅格。
	流向	栅格分析	使用 D8、多流向 (MFD) 或 D-Infinity (DINF) 方法创建从每个像元到其下坡相邻点的流向栅格。
	流动距离	栅格分析	计算从每个像元到其流入河流的水平或垂直坡度距离。
	测地线视域	栅格分析	标识栅格表面上对输入观察点位置可见的位置。
	河流链	栅格分析
	表面参数	栅格分析	使用测地线方法计算栅格表面的参数，例如坡向、坡度和曲率。
	集水区	栅格分析	确定栅格中一组像元之上的汇流区域。
使用深度学习	使用深度学习分类对象	栅格分析	对影像图层运行深度学习模型以生成已对每个输入对象进行分类的要素图层或表格。
	使用深度学习分类像素	栅格分析	使用深度学习模型根据定义的标注列表（表示不同的类别）对影像图层中的像素进行分类。
	使用深度学习检测变化	栅格分析	运行训练深度学习模型以检测两个栅格图层之间的变化。
	使用深度学习检测对象	栅格分析	使用深度学习模型识别和定位影像图层中的对象。
使用多维分析	聚合多维栅格	栅格分析	通过沿维度组合现有多维变量来生成多维影像图层。
	查找参数统计信息	栅格分析	用于为多维或多波段影像图层中的每个像素提取达到给定统计量的维度值或波段指数。
	生成多维异常	栅格分析	计算现有多维栅格中每个剖切的异常，以生成新的多维影像图层。
	生成趋势栅格	栅格分析	用于面向多维影像图层中一个或多个变量估计每个像素沿维度的趋势。
	多维主成分分析	栅格分析	将多维影像图层转换成考虑数据方差的数量缩减成分，以随时确定时空模式。
	使用趋势栅格预测	栅格分析	使用“生成趋势栅格”工具创建的输出趋势影像图层计算预测的多维影像图层。

栅格函数

栅格函数指用于执行影像和栅格相关任务的操作。 可通过栅格函数图标 识别这些函数。 用户可以在运行时预览栅格函数的结果。

“分析”微件支持超过 100 个栅格函数。 可在 Map Viewer 文档中了解有关每个函数的详细信息。

地理处理数据类型

每个地理处理工具均具有一组唯一的参数，这些参数是用户在运行时配置的一组选项或设置，例如要处理的输入数据和输出数据集。 地理处理工具可以使用许多不同类型的数据作为输入和输出。 但是，Experience Builder 目前仅支持部分数据类型。 下表列出了“分析”微件目前支持作为输入和输出参数的数据类型。

数据类型		输入	输出	备注
Basic	GPBoolean			输出将显示为字符串。
	GPDouble			输出将显示为字符串。
	GPLong			输出将显示为字符串。
	GPString			输出将显示为字符串。
	GPLinearUnit			输出将显示为字符串。
	GPFeatureRecordSetLayer			将输出可供其他微件使用的要素图层。
	GPDate			输出将显示为字符串。
	GPRecordSet			输入只能来自图层选择，不能来自 .json 或 .txt 文件。 输出为可在“表格”微件中显示的表格对象。
	GPDataFile			输出为文件链接。
	字段			输出将显示为字符串。
	GPRasterDataLayer			将输出栅格服务 URL。
GPMultiValues	GPBoolean			输出将显示为字符串。
	GPDouble			输出将显示为字符串。
	GPLong			输出将显示为字符串。
	GPString			输出将显示为字符串。
	GPLinearUnit			输出将显示为字符串。
	GPDate			输出将显示为字符串。
	GPDataFile			输出为文件链接。
	GPRecordSet			将输出可操作表对象。
	GPRasterDataLayer			将输出栅格服务 URL。
	GPFeatureRecordSetLayer			将输出可供其他微件使用的要素图层。
	字段			输出将显示为字符串。
GPValueTable	GPBoolean、GPString、GPLong、GPDouble、GPDate、GPLinearUnit			输出将显示为字符串。
	GPDataFile			输出为文件链接。
	GPFeatureRecordSetLayer			输出将显示为元信息。
	GPRecordSet			输出将显示为元信息。
	GPRasterDataLayer			将输出栅格服务 URL。
GPComposite	任何基本类型的选项			输出格式与基本数据类型相同。

交互选项

“分析”微件支持数据操作，可在微件设置的操作选项卡上配置这些操作。

数据操作允许用户执行数据处理任务，例如导出结果、将结果添加至地图以及在表格中查看结果。 例如，如果您在应用程序中包含“分析”微件和“表格”微件，并在“分析”微件的设置中打开在表格中查看操作，则在运行时，用户可以单击在表格中查看以查看“表格”微件中的分析结果。

“分析”微件是设置为分析输入操作的目标，您可以在其他微件设置的操作选项卡中配置此操作。 您可以使用此数据操作选择另一个微件中的要素，并将该要素作为内置要素分析工具或自定义地理处理工具的输入。 此数据操作支持要素图层、动态影像图层和切片影像图层的要素。

以下微件支持设置为分析输入数据操作：

• “分析”微件
• “添加数据”微件
• 图表微件
• 要素信息微件
• “列表”微件
• “地图”微件
• 地图图层微件
• 周边微件
• “查询”微件
• 选择微件
• 表格微件
• 追踪微件