This tool will calculate the elevation of each grid cell in a digital elevation model (DEM) above the nearest downslope pit cell or grid edge cell, depending on which is encountered first during the flow-path traverse. The resulting image is therefore a measure of relative landscape position. The user must specify the names of a D8 flow pointer grid, a DEM file, and the output file. The flow pointer grid must be derived using the D8 flow algorithm.
NoData valued grid cells in the input pointer image will be assigned NoData values in the output image. The output raster is of the float data type and continuous data scale.
The following is an example of a Python script that uses this tool:
wd = pluginHost.getWorkingDirectory()
pointerFile = wd + "D8 pointer.dep"
demFile = wd + "DEM.dep"
outputFile = wd + "output.dep"
args = [pointerFile, demFile, outputFile]
pluginHost.runPlugin("ElevAbovePit", args, False)
This is a Groovy script also using this tool:
def wd = pluginHost.getWorkingDirectory()
def pointerFile = wd + "D8 pointer.dep"
def demFile = wd + "DEM.dep"
def outputFile = wd + "output.dep"
String[] args = [pointerFile, demFile, outputFile]
pluginHost.runPlugin("ElevAbovePit", args, false)