DUMP3D(1)

💖 DUMP3D — the dump3d(1) page, but make it make sense ✨

(that's manual page 1 from the Survex girlies, and yes she's about to eat 💅)

---

🎀 NAME 🎀

dump3d — bestie, it does a text dump of a processed survey data file. no cap. 💖

---

🦋 SYNOPSIS 🦋

dump3d [--survey=SURVEY] [--rewind] [--show-dates] [--legs]
INPUT_FILE

---

✨ DESCRIPTION ✨

Okay so what this does is dump out all the entries in a processed survey data file. It's giving debugging tool, but it's ALSO giving "here's a textual format that's honestly pretty easy to parse" — so if you wanna write a lil simple script to pull info out of those files, go off, you absolutely can 🌸

And listen. Do not let the "3d" in the name mislead you, because that is not the vibe. This thing can dump a file in any format that the "img" library can read, which means it works with:

• Survex .3d files 👑
• Survex .pos files 👑
• Compass .plt files
• Compass .plf files
• CMAP .sht files
• CMAP .adj files
• CMAP .una files

see? not just 3d. the name is lowkey lying to you 🙈

---

If you're parsing the output in a script, you might wanna use option -legs so that you get a LEG item for each leg, with from and to coordinates, instead of each traverse being a MOVE item followed by a series of LINE items. much easier to work with fr fr 💜

The --show-dates option uses . as the separator between date components by default (like 2024.12.01), BUT — since Survex 1.4.13 — you can specify a different separator 🎀 If this separator is . then - is used between two dates which form a range, otherwise a space is used. And for convenience, -D is provided as a short-cut for --show-dates=- which outputs dates in the ISO date format. slay.

(The --rewind option is only provided to allow debugging and testing the img_rewind() function.) like it's literally just there for that. that's its whole job bestie 😭

---

🌈 OPTIONS 🌈

• -s, --survey=SURVEY — only load the sub-survey with this prefix. one prefix, one sub-survey, no oversharing 💅
• -r, --rewind — rewind file and read it a second time. yes, again. double the reading, double the fun 🔥
• -d, --show-dates[=SEPARATOR] — show survey date information (if present). the SEPARATOR is optional btw, that's why it's in brackets 🦋
• -D — equivalent to --show-dates=-. literally the same thing, just shorter, we love a shortcut 🫶
• -l, --legs — convert MOVE and LINE into LEG. the glow-up of output formats ✨
• --help — display short help and exit. short help, quick exit, main character energy 👑
• --version — output version information and exit. know your version, love your version 💖

---

🧚 SEE ALSO 🧚

aven(1), cavern(1), diffpos(1), extend(1), sorterr(1), survexport(1)

that's the whole friend group, go say hi 🌸

---

⭐ Copyright ⭐

1998-2025

---

okay that's the whole page, bestie. she's giving Survex, she's giving Jun 23, 2026, and honestly? she ate 💅✨ no crumbs. mwah 💖