d.correlate(1)

✨ d.correlate ✨

okay bestie, listen up 💖 this one's a GRASS GIS User's Manual page, and it's all about d.correlate — the little icon that could when you wanna see whether two raster maps are vibing with each other or absolutely not 🦋

---

🌸 NAME 🌸

d.correlate — prints a graph of the correlation between raster maps (in pairs). that's it, that's the whole job, and it eats 💅

---

🎀 KEYWORDS 🎀

display, statistics, raster, diagram, correlation — iykyk ✨

---

💖 SYNOPSIS 💖

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

🧚 Flags:

• --help — print usage summary, the classic "bestie what does this even do" button
• --verbose — verbose module output, it will over-share with you
• --quiet — quiet module output, it's giving mysterious
• --ui — force launching GUI dialog, main character energy only 👑

🍓 Parameters:

• map=name[,name,...] — required (no skipping, babe). name of raster map(s)

---

🌈 DESCRIPTION 🌈

so d.correlate displays graphically the results of a r.stats analysis run on two raster map layers. basically it's a scattergram bestie — it highlights the correlation (or the lack of it, and honestly the lack of it is sometimes tea) among data layers.

the results show up in the active display frame on the user's graphics monitor. and no cap: d.correlate erases the active frame before displaying results. so if you had something precious in that frame… it's gone, periodt 😭. if no graphics monitor is open, a file map.png is generated in the current directory — automatic screenshot behavior, we love a self-sufficient icon ✨

---

💀 NOTES 💀

if three or four map layers are specified, the correlation among each combination of two data layers is displayed. so like… you get the whole group chat's drama, not just one pair 🙈

---

👑 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

and then: scatterplot of two LANDSAT TM7 channels 🎀

---

🦋 SEE ALSO 🦋

d.text, d.graph, r.coin, r.regression.line, r.stats — go read those too, bestie, they're all iconic in their own way

---

💜 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)

Accessed: Saturday Jan 17 05:41:51 2026

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

---

and that's the whole page, no notes 💅 this little icon lives in GRASS 8.4.2, and the page was last accessed Saturday Jan 17 05:41:51 2026. mwah, go plot something pretty 🫶💖