ListRasters

Summary

Returns a Python list of the rasters in the workspace, limited by name and raster type.

Discussion

The workspace environment must be set first before using several of the List functions, including ListDatasets, ListFeatureClasses, ListFiles, ListRasters, ListTables, and ListWorkspaces.

Syntax

ListRasters ({wild_card}, {raster_type})

Parameter	Explanation	Data Type
wild_card	The wild card limits the results returned. If no wild card is specified, all values are returned.	String
raster_type	The raster type to limit the results returned by the wild card argument. Valid raster types are: BMP —Bitmap graphic raster dataset format. GIF —Graphic Interchange Format for raster datasets. IMG — ERDAS IMAGINE raster data format. JP2 —JPEG 2000 raster dataset format. JPG —Joint Photographics Experts Group raster dataset format. PNG — Portable Network Graphics raster dataset format. TIFF —Tagged Image File Format for raster datasets. GRID — ESRI GRID data format. All —All supported raster types are returned. This is the default. (The default value is All)	String

Return Value

Data Type	Explanation
String	The Python List returned from the function containing raster names in the workspace, limited by the optional wild card and raster type.

Code Sample

ListRasters example

List ESRI GRID raster names in workspace.

import arcpy
from arcpy import env

# Set the current workspace
# 
env.workspace = "C:/Data/DEMS"

# Get a list of ESRI GRIDs from the workspace and print
#
rasterList = arcpy.ListRasters("*", "GRID")
for raster in rasterList:
    print raster