GIS::D...:Polar(3pm)

✨ GIS::Distance::Polar ✨

okay so bestie, welcome to GIS::Distance::Polar — she's part of the User Contributed Perl Documentation for the GIS::Distance family, and she does polar coordinate flat-earth distance calculations. 💖 buckle up.

---

🦋 NAME 🦋

GIS::Distance::Polar — polar coordinate flat-earth distance calculations. that's her. that's the whole name. slay.

---

🌸 DESCRIPTION 🌸

so supposedly this is a formula to better calculate distances at the poles. like, that's the pitch. allegedly. 🙈

but here's the tea, and I need you to hear me on this: while it is implemented, this formula has not been tested much. if you use it, PLEASE share your results with the author. literally begging. 🥺

and ngl, it's looking rough. the author tested this formula's results versus GIS::Distance::Vincenty, and it appears that this formula is broken (or the implementation is) — you can see the whole thing play out in t/polar.t. 💀 no cap.

also, a faster (XS) version of this formula is available as GIS::Distance::Fast::Polar. so like, if speed is your main character moment, that's your girl.

and fyi: normally this module is not used directly. instead GIS::Distance is used, which in turn interfaces with the various formula classes. so you're probably supposed to go through the front door, not the window. 🪟✨

---

🧮 FORMULA 🧮

here's the math, bestie. verbatim, because numbers do not play:

a = pi/2 - lat1
b = pi/2 - lat2
c = sqrt( a^2 + b^2 - 2 * a * b * cos(lon2 - lon1) )
d = R * c

---

🫶 SUPPORT 🫶

See "SUPPORT" in GIS::Distance. they got you. 💅

---

👑 AUTHORS 👑

See "AUTHORS" in GIS::Distance. credit where credit is due, periodt.

---

💜 LICENSE 💜

See "LICENSE" in GIS::Distance. read it, love it, respect it. 📜

---

and that's the whole page, babe. this little doc shipped with perl v5.36.0 and is dated 2023-10-21 — so if you're reading this in the future, just know she's a vintage icon. 🎀 mwah, go calculate some distances (carefully, apparently). ✨🌈