HighestPosition

Summary

Creates a raster object where each pixel contains the position of the raster with the maximum value in a set of rasters.

Discussion

For more information about how this function works, see the Highest Position tool.

The referenced raster dataset for the raster object is temporary. To make it permanent, you can call the raster object's save method.

Syntax

HighestPosition (rasters, {extent_type}, {cellsize_type})
ParameterExplanationData Type
rasters
[rasters,...]

The list of input rasters.

None
extent_type

The method that will be used to compute the extent of the output when the input rasters have different extents.

  • FirstOfThe output extent is defined using the extent of the first input raster.
  • LastOfThe output extent is defined using the extent of the last input raster.
  • IntersectionOfThe output extent is defined as the intersecting area of the input rasters.
  • UnionOfThe output extent is defined as the total extent of the input rasters.

(The default value is FirstOf)

String
cellsize_type

The method that will be used to compute the pixel size of the output when the input rasters have different pixel sizes.

  • FirstOfThe output pixel size is defined using the pixel size of the first input raster.
  • LastOfThe output pixel size is defined using the pixel size of the last input raster.
  • MaxOfThe output pixel size is defined using the maximum pixel size of the input rasters.
  • MeanOfThe output pixel size is defined using the mean of both input rasters.
  • MinOfThe output pixel size is defined using the minimum pixel size of the input rasters.

(The default value is FirstOf)

String
Return Value
Data TypeExplanation
Raster

The output raster.

Code sample

HighestPosition example

Calculates the raster with the maximum value in a set of input rasters.

# Import system modules
import arcpy
from arcpy.ia import *

#Set the local variables
rasters = [r"c:\temp\raster1.tif", r"c:\temp\raster2.tif", r"c:\temp\raster3.tif"] 

#Execute
Highest_raster = HighestPosition(rasters, "UnionOf", "FirstOf")