## NAME

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

## KEYWORDS

display, statistics, raster, diagram, correlation

## SYNOPSIS

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

### Flags:

--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

map=name[,name,...] [required]
  Name of raster map(s)

## 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

## 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: 9c1146064f7c3c21fb0746063fa8bd2cdf4633cb

Main index | Display index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual