r.plane(1grass)

📦
version 8.5.0 · 10 versions
, in alpine 3.24, ubuntu stonking

✨ r.plane ✨ (that's the GRASS manual page for r.plane, bestie 💅)

okay so imagine you want a tilted plane as a raster map. you give it a dip, an azimuth, and one single point, and it builds the whole plane for you. iconic behavior honestly 🫶

🌸 NAME 🌸

r.plane — creates raster plane map given dip (inclination), aspect (azimuth) and one point.

🎀 KEYWORDS 🎀

raster, elevation

🦋 SYNOPSIS 🦋

r.plane
r.plane --help
r.plane output=name dip=float azimuth=float easting=float northing=float
elevation=float  [type=string]   [--overwrite]  [--help]  [--verbose]
[--quiet]  [--ui]

💖 Flags 💖

  • --overwrite — lets your output files just yeet over any existing files, no cap
  • --help — prints the usage summary so you're not lost
  • --verbose — verbose module output, she's chatty
  • --quiet — quiet module output, she's mysterious
  • --ui — forces the GUI dialog to launch

🍓 Parameters 🍓

  • output=name [required] — the name for your output raster map ✨
  • dip=float [required] — dip of the plane, in degrees
    • Options: -90-90
    • Default: 0.0
  • azimuth=float [required] — azimuth of the plane, in degrees
    • Options: 0-360
    • Default: 0.0
  • easting=float [required] — easting coordinate of a point that's sitting on the plane
  • northing=float [required] — northing coordinate of a point that's sitting on the plane
  • elevation=float [required] — elevation coordinate of a point that's sitting on the plane
  • type=string — type of raster map to be created — storage type for the resultant raster map
    • Options: CELL, FCELL, DCELL
    • Default: FCELL
    • CELL: Integer
    • FCELL: Single precision floating point
    • DCELL: Double precision floating point

🌈 DESCRIPTION 🌈

r.plane creates a tilted plane raster map, and you get to tell it everything: the inclination, the azimuth, and the geographic location of one point that lives on that plane. it's giving custom order 🧚

the angle orientations of the azimuth parameter increase counter-clockwise, so like: 0 degree = N, 45 degree = NW, 90 degree = W, etc. 💫

and when you crank up the dip parameter, it progressively lowers (aka dips) the northern half of the plane and inclines the southern half — that's assuming azimuth is just sitting there held constant at 0 degrees.

💜 NOTES 💜

g.region -c is your bestie here, because it hands you the easting and northing coordinates for the center of the current region. 🫶

also, disk space tea ☕: CELL (integer) maps take less disk space than FCELLs (floating point), and FCELLs in turn take up less space than DCELLs (double precision floating point). so choose wisely, queen 👑

⭐ EXAMPLE ⭐

a tilted plane in the North Carolina sample dataset region:

# set computational region
g.region raster=elev_lid792_1m -p
# get center coordinates as an example
g.region -c
# get terrain height at point
r.what map=elev_lid792_1m coordinates=638650.0,220375.0
# shows elevation: 116.7734
# generate tilted plane
r.plane myplane30 dip=30 az=75 east=638650.0 north=220375.0 \
        elev=116.7734 type=FCELL

Figure: Tilted plane shown in NVIZ along with elevation map

👑 AUTHORS 👑

  • Stefan Jäger (1994), University of Heidelberg during a stay at USGS
  • Updated to GRASS 5.7 by Michael Barton, Arizona State University
  • Full rewrite for GRASS 7 by Glynn Clements

🔥 SOURCE CODE 🔥

Available at: r.plane source code (history)

Latest change: Tuesday Apr 29 06:15:53 2025 in commit: 14f53105a219d361c75919765a39ecaedaf0650a

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

and that's the whole thing, bestie — go make some planes 💅✨

shoutout to the GRASS 8.5.0 era: this is the GRASS 8.5.0 Reference Manual, and the copyright reads © 2003-2026 GRASS Development Team. mwah 🫶🌈

📦 where this page comes from