d.where(1grass)

💅 d.where — the manual, but make it cute

okay bestie, so you're in d.where(1grass) — that's the GRASS User's Manual page for d.where, and she is that girl. She reads display coordinates and turns them into geographic coordinates fr fr. Let's get into it 🫶

KEYWORDS: display, sampling, position, querying ✨

---

🌸 SYNOPSIS 🌸

d.where
d.where --help
d.where [-dlwf]  [at=x,y[,x,y,...]]   [input=name]   [--help]
[--verbose]  [--quiet]  [--ui]

✨ Flags ✨

• -d — spit out the lat/long in decimal degree 🍓
• -l — output lat/long referenced to the current ellipsoid, no cap
• -w — output lat/long referenced to the WGS84 ellipsoid using datum transformation parameters defined in the current location (only if those exist, so like, vibe check first)
• -f — output the frame coordinates of the current display monitor, as a percentage 👑
• --help — print usage summary
• --verbose — verbose module output, she's chatty
• --quiet — quiet module output, she's mysterious
• --ui — force launching the GUI dialog 🎀

🌈 Parameters 🌈

• at=x,y[,x,y,...] — display coordinates to convert
• input=name — file from which to read coordinates ("-" to read from stdin, iconic)

---

💖 DESCRIPTION 💖

d.where is an interactive program that lets you, using the pointing device (mouse 🖱️), identify the geographic coordinates associated with point locations within the current geographic region in the active display frame on the graphics monitor. it's giving "point and receive".

every single mouse click will output the easting and northing of the point currently located beneath the mouse pointer. a mouse-button menu pops up so you actually know which mouse buttons to use, because we're not gatekeeping. the output is always printed to the terminal screen; and if the output is redirected into a file, it will be written to the file as well. both. at the same time. queen behavior ✨

Mouse buttons:

Left:   where am i
Middle: draw to/from here
Right:  quit this

the left mouse button prints the coordinates at the selected point. the middle mouse button lets you query two points (they are connected by a line for convenience, cute). use the right mouse button to exit the module. bye bestie 👋

---

🦋 NOTES 🦋

this program uses the current geographic region setting and active frame. it is not necessary, although useful, to have displayed a map in the current frame before running d.where — so you don't have to do the whole routine first, lowkey freeing.

the -d flag allows the user to optionally output latitude/longitude coordinates pair(s) in decimal degree rather than DD:MM:SS format.

the -w flag is only valid if a datum is defined for the current project's coordinate reference system. so like, check that first or she will simply not participate 🙈

if the -f flag is given, the x,y frame coordinates of the active display monitor will be returned (as a percentage, 0,0 is bottom left). yes, bottom left. noted. periodt.

---

⭐ EXAMPLE ⭐

query position in map (North Carolina sample dataset):

d.rast elevation
d.where

---

🌟 SEE ALSO 🌟

d.what.rast, d.what.vect, g.region, v.what.rast, v.what.vect — the whole friend group 💜

---

👑 AUTHORS 👑

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

---

🧚 SOURCE CODE 🧚

Available at: d.where source code (history)

Latest change: Monday Dec 08 21:47:55 2025 in commit: d3c6479bef77a58e3b5d85259303dbfb9c1babe8

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

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

---

and that's the page bestie 💖 GRASS 8.5.0, dated Monday Dec 08 21:47:55 2025 — that's d.where(1grass), read her and loved her, mwah 💅✨🫶