d.correlate(1grass)

💖 d.correlate — the GRASS manual, but make it make sense 💖

okay bestie, sit down, we're doing stats but cute. this is d.correlate from the GRASS User's Manual (GRASS 8.5.0, she's iconic), and she's here to show you whether your raster maps are actually friends or just mutuals. 🦋

✨ NAME ✨

d.correlate — prints a graph of the correlation between raster maps (in pairs). yes. pairs. like a double date but with numbers. 💅

🎀 KEYWORDS 🎀

display, statistics, raster, diagram, correlation

🌸 SYNOPSIS 🌸

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

🫶 Flags

• --help — prints the usage summary so you're not out here guessing, periodt
• --verbose — verbose module output, aka she tells you EVERYTHING
• --quiet — quiet module output, aka she tells you nothing, lowkey mysterious
• --ui — forces the GUI dialog to launch, for when you want the whole interface moment

🍓 Parameters

• map=name[,name,...] [required] — name of the raster map(s). you gotta give her maps, she can't read your mind (yet)

💜 DESCRIPTION 💜

okay so here's the tea: d.correlate shows you, graphically, the results of an r.stats analysis run on two raster map layers. it's highlighting the correlation (or the total lack of it, no shade) among your data layers. it's giving... scattergram. ✨

the results pop up in the active display frame on your graphics monitor. and heads up — d.correlate erases the active frame before displaying results, so if you had something cute in there, it's gone, sorry bestie 😭

and if there's no graphics monitor open? no worries, she just generates a file called map.png in the current directory. self-sufficient queen. 👑

🌈 NOTES 🌈

if you specify three or four map layers, she'll show you the correlation among each combination of two data layers. more maps, more graphs, more drama. fr fr.

⭐ 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

---

okay and that's the whole page, no cap. this all lives in the GRASS 8.5.0 Reference Manual, © 2003-2026 GRASS Development Team, latest chaos logged Wednesday Feb 12 23:02:46 2025. go plot something pretty, bestie 💖✨