r3.neighbors(1grass)

✨ r3.neighbors (1grass) ✨

okay bestie, this is the GRASS User's Manual page for r3.neighbors, and it's literally the 3D voxel glow-up module. no cap.

---

🌸 NAME 🌸

r3.neighbors — makes each voxel value a function of the values assigned to the voxels around it, and stores new voxel values in an output 3D raster map. it's giving "main character voxel, but make it a team effort" 💅

---

🎀 KEYWORDS 🎀

raster3d, algebra, voxel, statistics, aggregation, neighbor, focal statistics, filter

---

🦋 SYNOPSIS 🦋

r3.neighbors
r3.neighbors --help
r3.neighbors input=name output=name method=string  [quantile=float]
window=x,y,z  [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags

• --overwrite — allow output files to overwrite existing files (yes bestie, it will absolutely eat what's already there, so be sure)
• --help — print usage summary
• --verbose — verbose module output
• --quiet — quiet module output
• --ui — force launching GUI dialog

🌈 Parameters

• input=name [required] — name of input 3D raster map
• output=name [required] — name for output 3D raster map
• method=string [required] — aggregate operation
  • Options: average, median, mode, minimum, maximum, range, stddev, sum, count, variance, diversity, interspersion, quart1, quart3, perc90, quantile
• quantile=float — quantile to calculate for method=quantile
  • Options: 0.0-1.0
• window=x,y,z [required] — the size of the window in x, y and z direction; values must be odd integer numbers, eg: 3,3,3

---

💖 DESCRIPTION 💖

r3.neighbors looks at each voxel in a 3D raster input map layer, and examines the values assigned to the voxel in a user-defined "neighborhood" around it. it outputs a new 3D raster map in which each voxel is assigned a value that is a (user-specified) function of the values in that voxel's neighborhood. for example, each voxel in the output map might be assigned a value equal to the average of the values appearing in its 3 x 3 x 3 voxel "neighborhood" in the input map layer. iconic behavior honestly.

👑 OPTIONS 👑

you must specify the names of the 3D raster map layers to be used for input and output, the method used to analyze neighborhood values (i.e., the neighborhood function or operation to be performed), and the moving window of the neighborhood. no skipping, bestie, it's required-required.

Neighborhood Operation Methods: the neighborhood operators determine what new value a center voxel in a neighborhood will have after examining values inside its neighboring voxels. each voxel in a 3D raster map layer becomes the center voxel of a neighborhood as the neighborhood window moves from voxel to voxel throughout the map layer. r3.neighbors can perform the following operations:

• average — the average value within the neighborhood.
• median — the value found half-way through a list of the neighborhood's values, when these are ranged in numerical order.
• mode — the most frequently occurring value in the neighborhood.
• minimum — the minimum value within the neighborhood.
• maximum — the maximum value within the neighborhood.
• range — the range value within the neighborhood.
• stddev — the statistical standard deviation of values within the neighborhood.
• sum — the sum of values within the neighborhood.
• variance — the statistical variance of values within the neighborhood.
• diversity — the number of different values within the neighborhood.
• interspersion — the percentage of voxels containing values which differ from the values assigned to the center voxel in the neighborhood, plus 1.

Neighborhood Size: the neighborhood moving window specifies which voxel surrounding any given voxel fall into the neighborhood for that voxel. the window must be three comma separated odd integers. the dimension order is: x,y,z. for example: the parameter window=3,3,3 specifies a moving window (a cube) with 27 voxel. 🧊 so cute, so cubic.

---

🔥 NOTES 🔥

the r3.neighbors program works in the current geographic region. it is recommended, but not required, that the 3D resolution of the geographic region be the same as that of the 3D raster map layer.

r3.neighbors doesn't propagate NULLs, but computes the aggregation over the non-NULL voxels in the neighborhood. slay, honestly — the empty ones just sit it out.

---

🌟 SEE ALSO 🌟

g.region, r.neighbors, r3.mapcalc, r3.stats, r3.support

---

💜 AUTHOR 💜

Soeren Gebbert

---

🫶 SOURCE CODE 🫶

Available at: r3.neighbors source code (history)

Latest change: Friday Feb 07 19:16:09 2025 in commit: a82a39f673b97fafcfce1604dc3e6015cb96487a

Main index | 3D raster index | Topics index | Keywords index | Graphical index | Full index

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

---

and that's the whole page, bestie ✨ you just read the GRASS 8.5.0 version of r3.neighbors(1grass) — yeah, the footer said exactly that — and the latest change on record is dated Friday Feb 07 19:16:09 2025 💖 go aggregate some voxels, you absolute icon 🎀