Available with Spatial Analyst license.
Summary
Determines which values from the first input are contained in a set of other inputs, on a cell-by-cell basis.
For each cell, if the value of the first input raster is found in any of the list of other inputs, that value will be assigned to the output raster. If it is not found, the output cell will be NoData.
Illustration
Usage
If all of the inputs are integer, the output raster will be integer. If any of the inputs are floating point, the output will be floating point.
In the list of input rasters, the order is not relevant to the outcome of this tool.
See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.
Syntax
InList (in_raster_or_constant, in_raster_or_constants)
Parameter | Explanation | Data Type |
in_raster_or_constant | The input raster whose values will be looked for in the input list. A number can be used as an input for this parameter, provided a raster is specified for the other parameter. To be able to specify a number for both inputs, the cell size and extent must first be set in the environment. | Raster Layer | Constant |
in_raster_or_constants [in_raster_or_constant,...] | A list of input rasters in which the cell values from the first input will be looked for. A number can be used as an input for this parameter, provided a raster is specified for the other parameter. To be able to specify a number for both inputs, the cell size and extent must first be set in the environment. | Raster Layer | Constant |
Return Value
Name | Explanation | Data Type |
out_raster | The output raster. | Raster |
Code Sample
InList example 1 (Python window)
This example determines which cell values in the first input are found in the set of other input rasters.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outInList = InList("redlandsc1", ["redlandsc2", "redlandsc3"])
outInList.save("C:/sapyexamples/output/outinlist.tif")
InList example 2 (stand-alone script)
This example determines which cell values in the first input are found in the set of other input rasters.
# Name: InList_Ex_02.py
# Description: Determines which values from the first input are
# contained in the other inputs
# 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
inRaster1 = "redlandsc1"
inRaster2 = "redlandsc2"
inRaster3 = "redlandsc3"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute InList
outInList = InList(inRaster1, [inRaster2, inRaster3])
# Save the output
outInList.save("C:/sapyexamples/output/outinlist")
Environments
Licensing Information
- ArcGIS for Desktop Basic: Requires Spatial Analyst
- ArcGIS for Desktop Standard: Requires Spatial Analyst
- ArcGIS for Desktop Advanced: Requires Spatial Analyst