CPTPG(1)

💖 CPTPG 💖

okay bestie, welcome to cptpg, part of the User commands squad, and it's giving glow-up for your colour palettes ✨

---

🌸 NAME 🌸

cptpg — convert GMT colour palette tables (cpt) to PostGIS colour-maps. that's it, that's the girl 💅

---

✨ SYNOPSIS ✨

cptpg [-h] [-o path] [-p] [-v] [-V] [path]

---

🦋 DESCRIPTION 🦋

so the cptpg utility takes the colour palette table (cpt) files that GMT uses and converts them into the colour-maps that PostGIS uses — specifically the ones for the ST_ColorMap function. 🎀

and lowkey it's not just a PostGIS thing either: it should also be possible to use these maps in the GDAL program gdaldem, the GRASS r.colors utility, and in ESRI products which call for a HDR color table. versatility, she ate 💅

if you don't hand it a file as that final argument, the program reads from stdin. and if you don't pass the --output option, it writes to stdout. classic, no cap 🫶

---

👑 OPTIONS 👑

• --backtrace-file path — pick a file to write a formatted backtrace into. ngl this file only gets created if there's actually a backtrace to write, which usually means something went wrong 😭 so like, an error happened bestie.
• --backtrace-format format — set the format of the backtrace written to whatever file you gave --backtrace-file. you get exactly one of three choices, no mixing: plain, xml or json. ✨
• --comments-write path — write the comments from the input out to the specified path. keeping the receipts 📝
• -h, --help — brief help. the little "hey what is this" moment 💖
• --hinge-active — if your input cpt has a SOFT_HINGE directive, this activates that hinge, which means the two halves of the gradient either side of the hinge get scaled independently. 🔥 and if your input doesn't have such a directive? then this option has no effect. literally nothing happens, she's just vibing 🙈
• -o, --output path — write the output to path instead of stdout. 🌈
• -p, --percentage — convert (z) values to percentages. math but make it fashion 💅
• -v, --verbose — verbose operation. she will talk 🗣️
• -V, --version — version information. 👑

---

🧚 AUTHOR 🧚

J.J. Green

---

and that's the whole page, bestie 💜 go convert something iconic

this was cptutils 1.82, dated 9 July 2024 — mwah, periodt 🎀✨🦋