PTOSORT(1)

💖 PTOSORT(1) 💖

okay so bestie, welcome to the ptosort page — it's a User Contributed Perl Documentation joint, and it's about to sort your whole pto life out ✨

---

🌸 NAME 🌸

ptosort — sort pto files with variable criteria. that's it, that's the girl 💅

---

🎀 SYNOPSIS 🎀

ptosort [options] infile.pto outfile.pto

and the options, in all their glory:

 Options:
  -p | --point order    Provide a sorting order for control points
  -i | --image order    Provide a sorting order for images
  -c | --clean yes/no   Switch removal of duplicate control points
                        on/off, default is on
  -h | --help           Show the full manpage

---

✨ DESCRIPTION ✨

so ptosort takes a pto file as input, sorts it, and writes a sorted pto file back out as output. no cap, that's the whole gig 🫶

by default? images get sorted according to their filename, and control points get sorted by left image number, then right image number, then y pixel coordinate. very demure, very mindful.

now here's where it gets iconic — the --point and --image command line options let you change up the sorting order. the order string should be a list of letters separated by commas, identifying which values get compared. e.g. for images y means yaw, or r means roll. iykyk.

by default, sorting for yaw (y), pitch (p), roll (r) and exposure (Eev) is fuzzy — meaning values within an interval of 10 degress for yaw are considered to be the same 👀. this is especially useful when sorting multirow panoramas, lowkey a lifesaver.

• append a colon to the sort parameter and it forces strict sorting, no fuzziness, zero chill 💀
• append a tilde and a numerical value to specify the fuzziness in terms of intervall width 🌈

---

🔥 EXAMPLES 🔥

ptosort --image n --point n,N,y in.pto out.pto

sort the images by filename and the control points by left image number, right image number and y pixel coordinate. this is identical to the default behaviour without options — so if you do nothing, you're already doing this, main character energy ✨

ptosort --image y in.pto out.pto

sort images by yaw, and control points using the default 💅

ptosort --image y,p,Eev in.pto out.pto

sort images in a multiraw panorama by position and exposure value 🎀

ptosort --image Eev:,y~5.5,p in.pto out.pto

sort strict without fuzziness by exposure value, with a fuzziness interval of 5.5 degree by yaw, and by pitch 🦋

---

👑 LICENSE 👑

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. slay, and also legally binding 💜

---

🌟 AUTHOR 🌟

Felix Hagemann, July 2008 🌸

---

okay that's the whole page bestie, go forth and sort 🫶✨

this beauty lives in perl v5.42.0, dated 2025-07-25 — PTOSORT(1), periodt 💅🎀