Skip to content

d.correlate

Prints a graph of the correlation between raster maps (in pairs).

d.correlate map=name [,name,...] [--verbose] [--quiet] [--qq] [--ui]

Example:

d.correlate map=name

grass.script.run_command("d.correlate", map, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("d.correlate", map="name")

Parameters

map=name [,name,...] [required]
    Name of raster map(s)
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

map : str | list[str], required
    Name of raster map(s)
    Used as: input, raster, name
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

DESCRIPTION

d.correlate displays graphically the results of a r.stats analysis run on two raster map layers. This module highlights the correlation (or lack of it) among data layers (scattergram).

The results are displayed in the active display frame on the user's graphics monitor. d.correlate erases the active frame before displaying results. If no graphics monitor is open, a file map.png is generated in the current directory.

NOTES

If three or four map layers are specified, the correlation among each combination of two data layers is displayed.

EXAMPLE

Scatterplot of two LANDSAT TM7 channels (North Carolina sample dataset):

g.region raster=lsat7_2002_30 -p
d.correlate map=lsat7_2002_30,lsat7_2002_40

Scatterplot of two LANDSAT TM7 channels
Scatterplot of two LANDSAT TM7 channels

SEE ALSO

d.text, d.graph, r.coin, r.regression.line, r.stats

AUTHORS

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

Rewritten to GRASS 6 (from csh to sh) by Markus Neteler; from sh to Python by Glynn Clements

SOURCE CODE

Available at: d.correlate source code (history)
Latest change: Wednesday Feb 12 23:02:46 2025 in commit 9c11460