Proj(3pm)

📦
version 2.085 · 3 versions
, in ubuntu noble

💖 Proj — the PDL::GIS::Proj era 💖

okay bestie, so this page is from the Perl User Contributed Documentation corner of the manual-verse, and it's all about PDL::GIS::Proj, which is your girl's PDL interface to the PROJ projection library. slay.

✨ NAME ✨

PDL::GIS::Proj — literally the PDL interface to the PROJ projection library. that's it, that's the vibe. 🗺️

🌍 DESCRIPTION 🌍

want more tea on the PROJ library itself? the docs say go peek here: <http://www.proj.org/> 💅

#line 38 "Proj.pm"

🔥 FUNCTIONS 🔥

💫 get_proj_info($params_string)

this one hands you back a string packed with info about which parameters proj is actually gonna use — defaults included, plus all that +init=file goodness. it's giving exactly the same energy as running proj -v. 🫶

heads up: it does this by calling the proj command line, so it might not play nice with every shell out there. the author tested it with bash, so like... iykyk.

💫 fwd_transform

Signature: (lonlat(n=2); [o] xy(n); char* params)

the PROJ forward transformation, and $params is a string of the projection transformation parameters. no cap.

it returns a pdl with x, y values chillin' at positions 0, 1. the units are fully dependent on PROJ behavior (not our call, bestie). and if an error happened, they'll be PDL->null. 😭

it ignores bad elements of $lat and $lon, and sets the corresponding elements of $x and $y to BAD.

fwd_transform processes bad values. it will set the bad-value flag of all output ndarrays if the flag is set for any of the input ndarrays. ✨

💫 inv_transform

Signature: (xy(n=2); [o] lonlat(n); char* params)

the PROJ inverse transformation, and $params is a string of the projection transformation parameters. yes ma'am. 🎀

it returns a pdl with lon, lat values at positions 0, 1. units are dependent on PROJ behavior, as always. and again, it'll be PDL->null if an error has occurred. 💀

it ignores bad elements of $lat and $lon, and sets the corresponding elements of $x and $y to BAD.

inv_transform processes bad values. it will set the bad-value flag of all output ndarrays if the flag is set for any of the input ndarrays. 💜

💫 proj_version

returns a 3-element list with the PROJ major, minor, and patch version-numbers. three little numbers, one iconic list. 👑

🌸 AUTHOR 🌸

Judd Taylor, Orbital Systems, Ltd. — judd dot t at orbitalsystems dot com

Copyright 2003 Judd Taylor, USF Institute for Marine Remote Sensing (judd@marine.usf.edu).

GPL Now!

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 🫡 read it and weep (respectfully).

and that's the whole page, bestie — this was served up by perl v5.38.2 and dated 2024-04-10, so go forth and project your little heart out. mwah 💋 slay

📦 where this page comes from