Skip to main content

Classify

Summary

Classifies a raster dataset based on an Esri Classifier Definition file (.ecd) and raster dataset inputs.

Discussion

For more information about how this function works, see the Classify raster function.

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

Syntax

Classify(raster1, {raster2}, classifier_definition)

Parameter Explanation Data Type

raster1

The input raster to be classified.

Raster

raster2

An optional raster dataset to incorporate into the classifier, such as a segmented image, multispectral image, or elevation data, used to generate a more robust classification definition for your dataset.

The raster dataset for this parameter must match the one used to create the input Esri Classifier Definition file.

Raster

classifier_definition

The path to the Esri Classifier Definition file (.ecd) that contains the statistics and other classification information for the specific dataset, classifier, and chosen attributes.

The default value is None.

String

Return value

Data Type Explanation

Raster

The classified raster object.

Code sample

Classify example

Classifies a multispectral raster based on an Esri classifier definition file (.ecd).

from arcpy.sa import *
out_classify_raster = Classify("NAIP.tif",None,
                               "C:/arcpyExamples/data/vegetation_class.ecd")
out_classify_raster.save("C:/arcpyexamples/outputs/classify_output.tif")
Classify example

Classifies a multispectral raster based on an Esri classifier definition file (.ecd).

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

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
raster1 = "QuickBird_4bands.tif"
raster2 = None
classifier_definition = "C:/arcpyExamples/data/tree_crown_classification_training_2classes_4b16b_ntree50.ecd"

# Apply Classify function
classified_raster = Classify(raster1, raster2, classifier_definition)

# Save the output
classified_raster.save("C:/arcpyExamples/outputs/Vegetation_landcover.crf")