ApplyEnvironment

摘要

应用当前环境设置创建作为输入栅格副本的新栅格。

说明

将环境设置应用到现有栅格(可以是栅格对象也可以是磁盘上的数据)时,请使用 ApplyEnvironment。 例如,您可能拥有可用于更改像元大小或裁剪到掩膜的先前分析工具的输出。

该函数通过新应用的当前环境设置创建一个作为输入副本的新栅格对象。 由于栅格对象的引用栅格数据集是临时的,因此若要将其变为永久性数据集,可调用栅格对象的 save 方法。 例如,outRas.save("C:/Data/outraster")

可通过设置像元大小和范围环境设置,然后以标量值作为输入,使用 ApplyEnvironment 函数创建常量值栅格。 例如,outConstant = ApplyEnvironment(5)

如果输入是多波段栅格,则输出也将为多波段栅格。 该函数将在输入中的每个波段上执行操作。

如果输入为多维栅格,则将处理所有变量的所有剖切,并且输出将为多维栅格。

以下环境设置将应用于 ApplyEnvironment 函数:像元大小像元大小投影方法当前工作空间范围掩膜输出坐标系临时工作空间捕捉栅格

语法

ApplyEnvironment (in_raster)
参数说明数据类型
in_raster

输入栅格数据集。

Raster
返回值
数据类型说明
Raster

输出栅格。

代码示例

ApplyEnvironment 示例

将高程数据集的单位从英尺转换为米,然后应用新像元大小并裁剪到新掩膜范围。

import arcpy
from arcpy import env
from arcpy.sa import *

#convert raster form meter to feet
elevMeter = Raster('C:/data/dem10') * 0.3048
env.cellsize = '30'
env.mask = 'C:/data/studyarea'

#create a new clipped raster based on the cellsize and mask environment settings
elevRasterClip = ApplyEnvironment(elevMeter)
elevRasterClip.save("C:/output/fgdb.gdb/dem30_m")