pkdumpogr(1)

💅 pkdumpogr — the manual, but make it make sense

okay bestie, so pkdumpogr is a lil command-line baddie from the pkdumpogr(1) manual, and she has ONE job: take a vector dataset and spill all its tea into a text file or straight onto your screen. she's giving quiet overachiever. no drama, just data. 🦋

---

✨ SYNOPSIS ✨

pkdumpogr -i input.txt [-o output] [options]

like… that's it. that's the whole vibe. -i is mandatory, everything else is ✨optional✨ (but iconic). 👑

---

🌸 DESCRIPTION 🌸

so what she actually does: pkdumpogr dumps the content of a vector dataset to (standard) output — that means either your screen or a filename, your call, bestie. 💖

by default she dumps all the attributes. periodt. no filtering, no gatekeeping.

but if you want to be ✨selective✨ you can pick individual attributes with the -n option. and if you're nosy about where things are, the X and Y positions can be printed with the -pos option. 📍

oh and there's the -transpose option which flips the whole output sideways — but heads up, that one only works in combination with the -n attribute option. it does NOT ride solo. she said no. 🙅‍♀️

---

🎀 OPTIONS 🎀

• -i filename, --input filename — the input shape file. your source material. the main character. 🌟
• -o filename, --output filename — the output ASCII file. where the magic gets written down instead of screamed at your terminal. 📝
• -ln layername, --lname layername — layer name(s) in sample. leave it empty to select all of them, no thoughts head empty, everything's invited to the party. 🎉
• -n attribute, --name attribute — the names of the attributes to select. each attribute is stored in a separate band. the default is ALL: write all attributes. (yes, ALL in caps, she's shouting it lovingly.) 🗣️
• -pos, --pos — include position (x and y). now you know WHERE. 💫
• -t, --transpose — transpose the output. ⚠️ does not work for -n ALL, so don't try it, it's not gonna slay, it's just gonna be sad. 😭
• -v level, --verbose level — verbose. default is 0. (so by default she's the strong silent type.) 🤫

---

🔥 EXAMPLE 🔥

Exhibit A: dump the attributes label and description for the vector dataset sample.sqlite to standard output (screen). 🖥️

pkdumpogr -i sample.sqlite -n label -n description

and she spits out:

0 2 noforest
1 2 noforest
2 2 noforest
3 2 noforest
4 2 noforest
5 2 noforest
6 2 noforest
7 2 noforest
8 2 noforest
9 2 noforest
10 1 forest
11 2 noforest

look at her go. ate and left no crumbs. 🍓

---

Exhibit B: similar to the previous example, but transpose the output. (and reminder bestie: this does not work without explicitly defining the options -n for attributes. she needs the -n. she's clingy like that. 🫶)

pkdumpogr -i sample.sqlite -n label -n description -t

which gives you:

0 2 2 2 2 2 2 2 2 2 2 1 2
1 noforest noforest noforest noforest noforest noforest noforest noforest noforest noforest forest noforest

sideways. horizontal. lying down. a whole mood. 😌

---

Exhibit C: dump the entire content of vector dataset input.sqlite to standard output. no filter, no shame. 💀

pkdumpogr -i input.sqlite

---

Exhibit D: dump only ATTRIBUTE of vector dataset input.sqlite, including x and y position, and output to the ASCII file output.txt. 💖

pkdumpogr -i input.sqlite -o output.txt -n ATTRIBUTE -pos

---

🌈 SEE ALSO 🌈

• pkascii2img(1) — her bestie. go say hi. 👋

---

lowkey reminder bestie: -t needs -n, and -n ALL + -t is a no. don't do it. i'm protecting you. 🧚

---

and that's the whole page!! 💜 this lil masterpiece is dated 01 January 2025 and lives under pkdumpogr(1) in the manual collection — so if you ever forget any of this, just pull her back up and she'll tell you the whole story again. mwah. 🎀✨👑