r.plane(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 r.plane(1) — the GRASS GIS User's Manual glow-up 💖

okay bestie, sit down, hydrate, and let me tell you about r.plane — straight out of the GRASS GIS User's Manual, and it's giving geometry class but make it slay. ✨

KEYWORDS: raster, elevation

🌸 NAME 🌸

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

✨ 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 — allow output files to overwrite existing files (she's a little chaotic, but valid 💅)
  • --help — print usage summary
  • --verbose — verbose module output
  • --quiet — quiet module output
  • --ui — force launching GUI dialog

🦋 Parameters:

  • output=name [required] — name for output raster map
  • dip=float [required] — dip of 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 on the plane
  • northing=float [required] — northing coordinate of a point on the plane
  • elevation=float [required] — elevation coordinate of a point on the plane
  • type=string — type of raster map to be created
    • Storage type for resultant raster map
    • Options: CELL, FCELL, DCELL
    • Default: FCELL
    • CELL: Integer
    • FCELL: Single precision floating point
    • DCELL: Double precision floating point

🌈 DESCRIPTION 🌈

So r.plane creates a tilted plane raster map, and you literally just hand it the inclination, the azimuth, and the geographic location of one point that lives on that plane. That's it. That's the whole vibe. 👑

okay and the angle orientations of the azimuth parameter increase counter-clockwise, i.e., 0 degree = N, 45 degree = NW, 90 degree = W etc. compass girlies rise up 🧭

and when you crank up the dip parameter, it progressively lowers (or dips) the northern half of the plane and inclines the southern half — assuming the azimuth parameter is held constant at 0 degrees. no cap, that's the geometry. 📐

🫶 NOTES 🫶

  • g.region -c provides the easting and northing coordinates for the center of the current region. free coordinates, we love to see it ✨
  • CELL (integer) maps take less disk space than FCELLs (floating point), which in turn take up less space than DCELLs (double precision floating point). storage queen energy, choose wisely 💾

💜 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

legends only, fr fr 🙌

🍓 SOURCE CODE 🍓

Available at: r.plane source code (history)

Accessed: Saturday Jan 17 05:41:52 2026

Main index | Raster 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, bestie — GRASS 8.4.2, r.plane(1), written up on Saturday Jan 17 05:41:52 2026, straight from the GRASS Development Team's reference manual to your terminal. mwah 💋 go make a plane, you absolute icon 💖✨🦋

📦 where this page comes from