d.correlate - GRASS manual
Author: GRASS Development Team
Description: d.correlate: Prints a graph of the correlation between raster maps (in pairs).
Keywords: display, statistics, raster, diagram, correlation

## 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: Sunday Jun 21 03:53:08 2026 in commit: 5528eb87eb1524d87d31190ef85b9f9540c73e50

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

© 2003-2026 GRASS Development Team, GRASS 8.6.0dev Reference Manual