r.out.bin(1grass)

💾 r.out.bin — the GRASS User's Manual moment

okay bestie, sit down, hydrate, and let me tell you about r.out.bin 💖

✨ NAME ✨

r.out.bin — exports a GRASS raster to a binary array. yes. literally that. it takes your raster and yeets it out as raw binary. iconic behavior honestly 🦋

🏷️ KEYWORDS 🏷️

raster, export, output

---

🌸 SYNOPSIS 🌸

r.out.bin
r.out.bin --help
r.out.bin [-ifhbs] input=string  [output=string]   [null=float]
[bytes=integer]   [order=string]   [--help]  [--verbose]  [--quiet]
[--ui]

🎀 Flags 🎀

• -i — Generate integer output. you want ints? you get ints 💅
• -f — Generate floating-point output. float girlies rise 🌊
• -h — Export array with GMT compatible header. GMT said "let me in" and we said "okay" ✨
• -b — Generate BIL world and header files
• -s — Byte swap output 🔄
• --help — Print usage summary
• --verbose — Verbose module output (it will simply not stop talking, love that for us)
• --quiet — Quiet module output 🤫
• --ui — Force launching GUI dialog ✨

🫶 Parameters 🫶

• input=string [required] — Name of input raster map. required bestie, no skipping 👑
• output=string — Name for output binary map (use output=- for stdout) 🍓
• null=float — Value to write out for null Default: 0
• bytes=integer — Number of bytes per cell Options: 1, 2, 4, 8
• order=string — Output byte order Options: big, little, native, swap Default: native

---

💜 DESCRIPTION 💜

The r.out.bin program exports a GRASS raster map to a binary array file. periodt.

bestie, you can optionally send the output to standard output (stdout) so it can be piped directly into other applications. it's giving "no middleman" energy 😌

Data is exported according to the original GRASS raster type (e.g. float). If the -i flag is specified, an integer array is output. The region parameters are printed to stderr. (stderr! not stdout! don't get it twisted 🙈)

---

🔥 NOTES 🔥

With the -h flag, data can be directly used by GMT as Grid Format 1 (float) or 2 (short). for example:

r.out.bin -h input=grass.raster output=new.grd
grdinfo new.grd=1 (if float)

Exported data can be piped directly into the GMT program xyz2grd. chef's kiss 🤌

r.out.bin input=grass.raster output=- | xyz2grd -R....  -ZTLf -

The example uses the GMT program xyz2grd with the -ZTLf flag indicating that a float array was output. iykyk ⭐

---

👀 SEE ALSO 👀

r.in.bin, r.in.ascii, r.in.gdal, r.out.ascii

---

👑 AUTHOR 👑

This program is derived from r.out.ascii with a few modifications.

Author: Bob Covill 🌈

---

🧚 SOURCE CODE 🧚

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

Latest change: Thursday May 08 20:58:05 2025 in commit: 4144ba81fa125e1549fc52e1cf5feb4fa004be8b

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

---

ok that's the whole page bestie, every flag, every default, every line, no info lost 💖

© 2003-2026 GRASS Development Team — that's the GRASS 8.5.0 Reference Manual, and this lil manpage lives at r.out.bin in GRASS 8.5.0. mwah 💅✨🦋