Skip to content

g.gui.iclass

Tool for supervised classification of imagery data.

Generates spectral signatures for an image by allowing the user to outline regions of interest.

g.gui.iclass [-m] [group=name] [subgroup=name] [map=name] [trainingmap=name] [--verbose] [--quiet] [--qq] [--ui]

Example:

g.gui.iclass

grass.script.run_command("g.gui.iclass", group=None, subgroup=None, map=None, trainingmap=None, flags=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("g.gui.iclass")

Parameters

group=name
    Name of input imagery group
subgroup=name
    Name of input imagery subgroup
map=name
    Name of raster map to load
trainingmap=name
    Ground truth training map to load
-m
    Maximize window
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

group : str, optional
    Name of input imagery group
    Used as: input, group, name
subgroup : str, optional
    Name of input imagery subgroup
    Used as: input, subgroup, name
map : str, optional
    Name of raster map to load
    Used as: input, raster, name
trainingmap : str, optional
    Ground truth training map to load
    Used as: input, vector, name
flags : str, optional
    Allowed values: m
    m
        Maximize window
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

wxGUI Supervised Classification Tool

DESCRIPTION

Supervised Classification Tool (wxIClass) is a wxGUI component which allows the user to create training areas and generate spectral signatures. The resulting signature file can be used as input for i.maxlik or as a seed signature file for i.cluster. WxIClass can be launched from the Layer Manager menu Imagery → Classify image → Interactive input for supervised classification or via command line as g.gui.iclass.

wxIClass currently allows you to:

  • create training areas (using customized vector digitizer)
  • show histograms for each band and class (category)
  • show coincidence plots for each band
  • show raster cells that match training areas (within the number of standard deviations specified)
  • specify color of class
  • write signature file
  • import vector map
  • export vector map with attribute table

Supervised Classification Tool

wxIClass performs the first pass in the GRASS two-pass supervised image classification process; the GRASS module i.maxlik executes the second pass. Both programs must be run to generate a classified map in GRASS raster format.

wxIClass is an interactive program that allows the user to create multiple training areas for multiple classes and calculate the spectral signatures based on the cells that are within the training areas. During this process the user will be shown histograms for each image band. The user can also display the cells of the image bands which fall within a user-specified number of standard deviations from the means in the spectral signature. By doing this, the user can see how much of the image is likely to be put into the class associated with the signature.

wxIClass can also import training areas defined in a vector layer. In that case the program expects the vector layer to have the following columns defined:

  • cat: category value
  • class: a string with the class name
  • color: a color defined using format "RRR:GGG:BBB"

The spectral signatures are composed of region means and covariance matrices. These region means and covariance matrices are used in the second pass (i.maxlik) to classify the image.

Alternatively, the spectral signatures generated by wxIClass can be used for seed means for the clusters in i.cluster.

SEE ALSO

wxGUI, wxGUI components, Interactive Scatter Plot Tool

See also user wiki page and development page.

AUTHORS

Anna Kratochvilova, Czech Technical University in Prague, Czech Republic
Vaclav Petras, Czech Technical University in Prague, Czech Republic

SOURCE CODE

Available at: g.gui.iclass source code (history)
Latest change: Wednesday Mar 26 21:44:22 2025 in commit 74d41f0