采样 (Map Viewer)

“采样”工具用于从所有输入栅格中提取每个输入要素位置处的像元值。

将输出托管表图层或托管要素图层。

示例

该工具的一些应用示例如下：

• 从多个栅格中提取蜂窝基站位置的属性，例如土地使用、土壤类型、高程和与道路的距离。
• 对于给定的点集，提取不同深度的土壤温度。
• 根据 30 年的每月海平面温度数据，在观测到动物物种时的给定时间内，在动物位置或房屋范围内进行汇总。

用法说明

“采样”工具包含输入图层、采样设置和结果图层的配置。

输入图层

输入图层组包含以下参数：

• 影像图层是单个影像或影像列表，其值将根据输入位置数据进行采样。

  可以将任意栅格（例如单波段、多波段、多维或多元）组合作为输入栅格提供。 如果输入栅格是多维的，输出表的结构会发生更改。 将多波段栅格作为输入栅格提供时，将使用该输入中的所有波段。 要处理一系列来自输入多波段栅格的波段，请首先创建由这些特定波段组成的栅格数据集。 然后，在输入栅格列表中使用该结果。

  要对多维影像图层中的所有剖切进行采样，则该图层必须是唯一的输入栅格。
• 位置图层是标识将被采样的位置的图层。 受支持的图层类型如下：
  • 栅格 - 包含有效值（非 NoData）的像素用于从所有输入栅格中提取像素值，且像素的中心将用于点位置。
  • 点 - 将在每个点位置对值进行采样。
  • 折线或面 - 将在面或折线质心处对值进行采样。 如果输入栅格是多维栅格，则系统将基于统计数据类型值对值进行聚合。

采样设置

采样设置组包含以下参数：

• 重采样方法指定将使用的重采样算法。 选项如下：
  • 最邻近 - 最邻近法，在重采样时使用最邻近像元的值将为输出像元分配值。 这是默认设置。
  • 双线性 - 双线性插值法，基于四个最邻近输入像元中心的加权平均距离确定像元的新值。
  • 三次 - 三次卷积插值法，通过拟合穿过 16 个最邻近输入像元中心的平滑曲线来确定像元的新值。
• 唯一 ID 字段是图层中包含每个位置或输入要素的不同值的字段。
• 以多维方式处理用于指定输入影像图层是否包含多维数据。
• 位置数据采集信息用于指定与位置像元或要素关联的时间、深度或其他采集数据。 当启用以多维方式处理时，此参数可用并包含以下子参数：
  • 维度 - 多维输入图层的维度。
  • 起始字段或值 - 用于开始时间范围的字段或维度值。 指定多维输入图层中的字段或提供一个值。
  • 结束字段或值 - 用于结束时间范围的字段或维度值。 指定多维输入图层中的字段或提供一个值。
  • 相对值或之前的天数 - 指定用于添加到维度字段或值的非负数，以定义维度值范围的起点。
  • 相对值或之后的天数 - 指定用于添加到维度字段或值的非负数，以定义维度值范围的终点。
• 统计数据类型用于指定要计算的统计数据类型。 当启用以多维方式处理时，此参数可用。 可用选项如下：
  • 最小值 - 查找指定范围内的最小值。
  • 最大值 - 查找指定范围内的最大值。
  • 中值 - 查找指定范围内的中值。
  • 平均值 - 计算指定范围的平均值。
  • 总和 - 计算指定范围内变量的总和。
  • 众数 - 查找出现最频繁的值。
  • 少数 - 查找出现最不频繁的值。
  • 标准差 - 计算标准差。
  • 百分比数 - 计算指定范围内定义的百分比。
• 百分比值指定要用于采样的百分比。 当启用以多维方式处理并指定百分比作为统计数据类型时，此参数可用。

  该值范围可以介于 0 到 100 之间。 默认值为 90。

• 缓冲距离字段或值是对多维影像图层进行采样的位置数据要素周围的距离。 当启用以多维方式处理时，此参数可用。

结果图层

结果图层组包括以下参数：

• 输出名称用于指定要创建并添加至地图的图层的名称。 名称必须唯一。 如果组织中已存在具有相同名称的图层，则工具将执行失败并提示您使用其他名称。
• 输出类型是将创建的图层类型。 输出可以为表格图层或要素图层。
• 输出布局指定采样值在输出表中以行还是以列显示。 仅当影像图层参数值是多维栅格并包含一个变量和一个维度并且每个剖切为单波段栅格时，此参数才适用。
• 保存在文件夹中将指定我的内容中将用于保存结果的文件夹的名称。

环境

分析环境设置是影响工具执行结果的附加参数。 可以从环境设置参数组访问工具的分析环境设置。

此工具支持以下分析环境：

• 输出坐标系
• 处理范围

  注：

  Map Viewer 中的默认处理范围为全图。 此默认值与 Map Viewer 经典版 不同，后者将默认启用使用当前地图范围。

• 掩膜

配额

此工具会消耗配额。

使用估计配额可计算运行该工具所需的配额数。 有关详细信息，请参阅了解用于空间分析的配额。

输出

此工具包括以下输出：

• 包含源影像图层（针对属性表中的每个输入位置）中的像素值的要素图层。 如果输出类型参数设置为要素，则会创建要素图层。 要素图层包含以下字段：
  • X- 表示输入点的水平坐标。
  • Y- 表示输入点的垂直坐标。
  • 包含每个栅格波段或源栅格的值的字段（将在字段名称中包含栅格波段的名称）。

    注：

    如果输入图层为多维图层，则输出将包含每个指定时间片的字段。

• 包含源影像图层（针对属性表中的每个输入位置）中的像素值的表图层。 如果输出类型参数设置为表，则会创建表图层。 表图层将包含以下列：
  • X- 表示输入点的水平坐标。
  • Y- 表示输入点的垂直坐标。
  • 包含每个栅格波段或源栅格的值的列（将在列名称中包含栅格波段的名称）。

使用要求

该工具需要以下用户类型和配置：

• Professional 或 Professional Plus 用户类型
• 发布者、服务商或管理员角色，或具有影像分析权限的等效自定义角色

资源

请通过以下资源了解更多详细信息：

• ArcGIS REST API 中的采样
• ArcGIS API for Python 中的 sample
• ArcGIS Pro 中的采样