按掩膜提取 (Spatial Analyst 工具)
汇总
提取掩膜所定义区域内的相应栅格像元。
插图
OutRas = ExtractByMask(InRas1, InMsk1, "INSIDE")用法
输入栅格中的其他属性（若有的话）将按照原样添加到输出栅格属性表。 根据所记录的属性，某些属性值可能需要重新计算。
将多波段栅格指定为输入栅格（Python 中的
in_raster）值时，将使用所有波段。要处理一系列来自多波段栅格的波段，请首先使用波段合成工具创建由这些特定波段组成的栅格数据集。 然后将结果用作输入栅格（Python 中的
in_raster）值。默认输出格式为地理数据库栅格。 如果输出格式指定为 Esri 格网栈，堆栈的名称不得以数字开头，不得使用空格且长度不能超过九个字符。
当为输入栅格掩膜指定多波段栅格时，将只在运算中使用第一个波段。
当输入栅格（Python 中的
in_raster）值和输入栅格或要素掩膜数据栅格数据（Python 中的in_mask_data）具有相同的像元大小，且像元对齐时，则将其直接应用于工具中。 在工具操作期间，系统不会对其进行内部重采样。如果像元大小不同，则输出像元大小将为输入的最大值，而输入栅格值将在内部用作捕捉栅格。 如果像元大小相同，但是像元未对齐，则输入栅格值将在内部用作捕捉栅格。 在执行提取操作之前，上述任一情况都会触发内部重采样。
当输入栅格具有矩形像元时，将对其进行处理，以确保输出栅格像元将为正方形，其边长等于矩形像元长度和宽度的平均值。
如果掩膜输入为要素，默认情况下它将在内部转换为栅格，并使用输入栅格值中的像元大小和像元对齐（捕捉栅格）。
运行按掩膜提取工具时，如果在环境设置中指定了掩膜，则输出栅格仅包含位于环境掩膜和输入掩膜数据交集内区域的像元值。
您可以使用分析范围（Python 中的
analysis_extent）参数为独立工具操作明确指定输出分析区域，或作为工作流的一部分去覆盖环境设置。 您可以通过输入值、选择显示范围、选择图层或浏览至输入数据集的方式指定范围。默认分析范围值是从输入栅格值和输入栅格或要素掩膜数据值的交集计算得出的。
如果分析范围没有明确指定为参数值，则其会从分析环境设置中派生。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。
参数
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
输入栅格 |
从中提取像元的输入栅格。 |
Raster Layer |
|
输入栅格或要素掩膜数据 |
用于定义要提取的像元格位置的掩膜数据。 它可以是栅格，也可以是要素数据集。 当输入掩膜数据为栅格时，将在输出栅格中为掩膜数据中的 NoData 像元指定 NoData 值。 当输入掩膜是要素数据时，如果输入栅格中像元的中心位于要素指定形状内，则会在输出中包含这些像元，而其中心落在要素周长之外的像元将会收到 NoData。 |
Raster Layer; Feature Layer |
|
提取区域 （可选） |
指定是选择位于输入掩膜定义的位置内部还是外部的像元，并将其写入输出栅格。
|
String |
|
分析范围 （可选） |
定义待提取区域的范围。 默认情况下，范围是作为输入栅格值和输入栅格或要素掩膜数据值的交集计算得出的。 处理可能会超出 x 和 y 坐标范围，在此范围之外的像元将为 NoData。 如果未明确设置分析环境，则坐标以与输入栅格相同的地图单位指定。
当手动提供坐标时，坐标必须为数值，并且位于活动地图的坐标系中。 地图可能使用与提供的坐标不同的显示单位。 在南纬和西经坐标中使用负号。 |
Extent |
- 范围基于活动地图或场景。
- 范围将基于在地图或场景上绘制的矩形。
- 范围基于活动地图图层。 选择可用图层或者使用所有图层中的数据范围选项。 每个地图图层具有以下选项：
- 所有要素的范围。
- 选定要素的范围。
- 可见要素的范围。
- 范围将基于数据集。
- 可在剪贴板中复制和粘贴范围。
- 将范围坐标和坐标系复制到剪贴板。
- 将范围重置为默认值。返回值
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
输出栅格 |
包含从输入栅格中提取的像元值的输出栅格。 |
Raster |
环境
自动提交, 像元大小, 像元大小投影方法, 压缩, 当前工作空间, 范围, 地理变换, 掩膜, 输出配置关键字, 输出坐标系, 临时工作空间, 捕捉栅格, 分块大小
许可信息
- 基本: 需要 Spatial Analyst
- 标准: 需要 Spatial Analyst
- 高级: 需要 Spatial Analyst