ApplyEnvironment (arcpy.sa)

Resumen

Creates a new raster that is a copy of the input raster with the current environment settings being applied.

Debate

Use ApplyEnvironment when you want to apply environment settings to an existing raster (which can be a raster object or data on disk). For example, you may have an output from a previous analysis tool that you want to alter the cell size or clip to a mask.

The function creates a new raster object which is a copy of the input with the newly applied environment settings. Since the referenced raster dataset for the raster object is temporary, if you want to make it permanent you can call the raster object's save method. For example, outRas.save("C:/Data/outraster").

The ApplyEnvironment function can be used to create a raster of constant values by setting the cell size and extent environment settings and then entering a scalar value as input. For example, outConstant = ApplyEnvironment(5).

The following environment settings apply to the ApplyEnvironment function: Cell Size, Current Workspace, Extent, Mask, Output Coordinate System, Scratch Workspace, and Snap Raster.

Sintaxis

ApplyEnvironment (in_raster)

Parámetro	Explicación	Tipo de datos
in_raster	The input raster dataset.	Raster

Valor de retorno

Tipo de datos	Explicación
Raster	The output raster.

Ejemplo de código

ApplyEnvironment example

Converts an elevation dataset's units from feet to meters then applies a new cell size and clips to a new mask extent.

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")