r3.out.bin(1grass)

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

💖 r3.out.bin — the "get ur 3D raster outta here in binary" page 💖

okay bestie, so this is r3.out.bin, a lil member of the GRASS User's Manual family (that's the manual name, she's fancy). She takes a 3D raster map and yeets it into a binary array. That's it. That's the gig. 🦋

KEYWORDS: raster3d, export, voxel — that's the vibe tag, iykyk.

✨ SYNOPSIS ✨

no cap, here's exactly how u call her:

r3.out.bin
r3.out.bin --help
r3.out.bin [-rdi] input=name output=name  [null=float]  bytes=integer
[order=string]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🎀 Flags 🎀

  • -r — flips the row order in the output, going from north->south to south->north. she's reversing it, your honor 💅
  • -d — flips the depth order in the output from bottom->top to top->bottom. yes queen, depth direction matters 🔥
  • -i — write the data as integer. whole numbers only babe 🧚
  • --overwrite — lets output files straight up overwrite existing files. permission granted 💀
  • --help — prints the usage summary, the lil "how do I work this" moment 🙈
  • --verbose — verbose module output, she's gonna talk more
  • --quiet — quiet module output, she's gonna talk less
  • --ui — force launches the GUI dialog. pop-up era ✨

🌸 Parameters 🌸

  • input=name [required] — Name of input 3D raster map. mandatory bestie, no input no export 💖
  • output=name [required] — Name for output file. also mandatory. where's it going? u tell me 🫶
  • null=float — Value to write out for null. Default: 0
  • bytes=integer [required] — Number of bytes per cell in binary file. Options: 1, 2, 4, 8. required, so pick ur size, no skipping ⭐
  • order=string — Output byte order. Options: big, little, native, swap. Default: native. endianness is a lifestyle choice fr fr 🌈

💜 DESCRIPTION 💜

So the r3.out.bin program exports a GRASS 3D raster map to a binary array file. Optionally, the output can be send to standard output (stdout) so u can pipe it directly into other applications — hello, main character energy 🎀. Data is exported according to the original GRASS 3D raster type (float, double). it's giving "faithful to the source."

👑 NOTES 👑

The write order of the rows (north->south to south->north) and the write order of the depths (bottom->top to top->bottom) can be switched. fyi.

The region parameters are printed to stderr when setting the verbose flag. Export of little and big endian byte order is supported. slay 💅

Have a look at the r3.out.ascii manual page, because she describes the internal layout of the 3D raster maps and the supported row and depth switch options. she's the lore-keeper, go read her 📖

ok real talk: if u need the actual structural deets, r3.out.ascii is where it's at. don't be out here guessing.

🍓 EXAMPLES 🍓

Have a look at the examples in r3.in.bin. yes bestie, the examples live over there. go visit 🧚

🌈 SEE ALSO 🌈

  • r3.in.bin
  • r3.in.ascii

💖 AUTHOR 💖

Sören Gebbert, based on r.out.bin from Bob Covill and Glynn Clements. shoutout to the trio, icons only 👑

⭐ SOURCE CODE ⭐

Available at: r3.out.bin 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

k bye ily, this was GRASS 8.5.0 showing u r3.out.bin(1grass) — go export something cute 🫶✨

📦 where this page comes from