ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Lowest Position

Available with Spatial Analyst license.

  • Summary
  • Illustration
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Determines on a cell-by-cell basis the position of the raster with the minimum value in a set of rasters.

Illustration

Lowest Position illustration
OutRas = LowestPosition([InRas1, InRas2, InRas3])

Usage

  • An arbitrary number of rasters can be specified in the input rasters list.

  • The order of the input rasters is relevant for this tool.

  • If a cell location contains NoData on any of the input rasters, that location will be assigned NoData on the output.

  • The output raster is always of integer type.

  • If two or more input rasters contain the minimum value for a particular cell location, the position of the first one encountered is returned on the output raster.

  • See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.

Syntax

LowestPosition (in_rasters_or_constants)
ParameterExplanationData Type
in_rasters_or_constants
[in_raster_or_constant,...]

The list of input rasters for which the position of the input with the lowest value will be determined.

A number can be used as an input; however, the cell size and extent must first be set in the environment.

Raster Layer | Constant

Return Value

NameExplanationData Type
out_raster

The output raster.

For each cell in the output raster, the value represents the position of the raster with the lowest value.

Raster

Code Sample

LowestPosition example 1 (Python window)

This example evaluates several input rasters and returns as an output value the position in the list of the raster with the minimum value.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLowestPosition = LowestPosition(["degs", "negs", "fourgrd"])
outLowestPosition.save("C:/sapyexamples/output/outlp.tif")
LowestPosition example 2 (stand-alone script)

This example evaluates several input rasters and returns as an output value the position in the list of the raster with the minimum value.

# Name: LowestPosition_Ex_02.py
# Description: Determines the position of a raster with the minimum
#              value in a set of rasters
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute LowestPosition
outLowestPosition = LowestPosition([inRaster01, inRaster02, inRaster03])

# Save the output 
outLowestPosition.save("C:/sapyexamples/output/outlp")

Environments

  • Auto Commit
  • Cell Size
  • Compression
  • Current Workspace
  • Extent
  • Geographic Transformations
  • Mask
  • Output CONFIG Keyword
  • Output Coordinate System
  • Raster Statistics
  • Scratch Workspace
  • Snap Raster
  • Tile Size

Licensing Information

  • ArcGIS for Desktop Basic: Requires Spatial Analyst
  • ArcGIS for Desktop Standard: Requires Spatial Analyst
  • ArcGIS for Desktop Advanced: Requires Spatial Analyst

Related Topics

  • An overview of the Local toolset
  • Finding the position from an input list meeting a specified criterion
  • Highest Position
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal