r3.out.bin(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💾 r3.out.bin — the GRASS GIS User's Manual page, but make it cute 💾

okay bestie, gather round, because this is the r3.out.bin(1) page and it is literally the glow-up your 3D raster data has been waiting for 🫶

✨ NAME ✨

r3.out.bin — exports a GRASS 3D raster map to a binary array. that's it, that's the whole job, and it does it flawlessly 💅

🏷️ KEYWORDS 🏷️

raster3d, export, voxel — yes queen, three little words, three big vibes 👑

📜 SYNOPSIS 📜

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]

🌸 OPTIONS 🌸

🎀 Flags 🎀

  • -r — flips the row order in the output from north->south to south->north. a lil remix of your rows, no cap 🔄
  • -d — flips the depth order in the output from bottom->top to top->bottom. now we're reading the depths back to front, iconic behavior 🌀
  • -i — write the data as integer. whole numbers only, bestie 🧮
  • --overwrite — allow output files to overwrite existing files. it's giving no hesitation, it's giving main character energy 💀
  • --help — print usage summary. the little "wait what does this do again" button 🫶
  • --verbose — verbose module output. spill the tea, module ☕
  • --quiet — quiet module output. shhh, she's in her silent era 🤫
  • --ui — force launching GUI dialog. clicky-clicky mode 🖱️

🧚 Parameters 🧚

  • input=name [required] — name of input 3D raster map. this is the thing you're exporting, bestie, don't forget her 💜
  • output=name [required] — name for output file. where the magic lands ✨
  • null=float — value to write out for null. default: 0. the "no data, but make it a number" situation 🙈
  • bytes=integer [required] — number of bytes per cell in binary file. options: 1, 2, 4, 8. pick your size, pick your fighter 📏
  • order=string — output byte order. options: big, little, native, swap. default: native. endianness girlies, this one's for you 🌈

💖 DESCRIPTION 💖

so the r3.out.bin program exports a GRASS 3D raster map to a binary array file. and like, optionally? the output can be send to standard output (stdout) for direct input (pipe) into other applications. pipe it, bestie, feed the next program directly 🍓

data is exported according to the original GRASS 3D raster type (float, double). no sneaky conversions, she stays true to herself 💅

📝 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. yes, you can flip both. yes, it's a lot of power. use it responsibly 🫶

the region parameters are printed to stderr when setting the verbose flag. lowkey a nice lil receipt of what went down 🧾

export of little and big endian byte order is supported. we love an inclusive byte order moment 💖

have a look at r3.out.ascii manual page that describes the internal layout of the 3D raster maps and the supported row and depth switch options. it's the lore, bestie, go read the lore 📖

🌟 EXAMPLES 🌟

have a look at the examples in r3.in.bin. they said "examples in r3.in.bin" and honestly? valid. go look 👀

👀 SEE ALSO 👀

r3.in.bin, r3.in.ascii — the girlies in the same friend group, fr fr 🫂

✍️ AUTHOR ✍️

Sören Gebbert, based on r.out.bin from Bob Covill and Glynn Clements. giving credit where credit is due, always 💐

🔗 SOURCE CODE 🔗

Available at: r3.out.bin source code (history)

Accessed: Saturday Jan 17 05:41:15 2026

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

and that's the whole page, bestie! now go export something gorgeous 🌈💅✨

signing off from the GRASS GIS 8.4.2 Reference Manual, version GRASS 8.4.2, page r3.out.bin(1) — © 2003-2025 GRASS Development Team. mwah, love u, bye 🎀💖

📦 where this page comes from