ListRasters

Summary

Returns a list of the rasters in the current workspace.

Discussion

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

Syntax

ListRasters ({wild_card}, {raster_type})
ParameterExplanationData Type
wild_card

Limits the results returned. If a value is not specified, all values are returned. The wildcard is not case sensitive.

SymbolDescriptionExample

*

Represents zero or more characters.

Te* finds Tennessee and Texas.

String
raster_type

The raster type that will limit the results. The following are valid raster types:

  • BMPBitmap graphic raster dataset format.
  • GIFGraphic Interchange Format for raster datasets.
  • IMG ERDAS IMAGINE raster data format.
  • JP2JPEG 2000 raster dataset format.
  • JPGJoint Photographics Experts Group raster dataset format.
  • PNG Portable Network Graphics raster dataset format.
  • TIFTagged Image File for raster datasets.
  • GRID Grid data format.
  • AllAll supported raster types are returned. This is the default.

(The default value is All)

String
Return Value
Data TypeExplanation
String

The list returned from the function containing raster names in the workspace, limited by the optional wild_card and raster_type arguments.

Code sample

ListRasters example

List Grid raster names in the workspace.

import arcpy

# Set the current workspace
arcpy.env.workspace = "c:/data/DEMS"

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

Related topics