Geo::C...es::ITM(3pm)

💖 Geo::C...es::ITM — the manual, but make it cute 💖

okay bestie, so this is the user-contributed Perl documentation for Geo::C...es::ITM and honestly? it's giving "tiny module, huge glow-up". let's get into it ✨

---

✨ NAME ✨

Geo::Coordinates::ITM — it converts coordinates back and forth between lat/lon and Irish Transverse Mercator. that's the whole job. it does the job. slay 💅

---

🌸 VERSION 🌸

This doc describes Geo::Coordinates::ITM version 0.02. yes babes, we're on 0.02, it's vintage, it's iconic.

---

🎀 SYNOPSIS 🎀

use Geo::Coordinates::ITM qw( ll_to_grid grid_to_ll );

my ( $lat, $lon ) = grid_to_ll( $east, $north );
my ( $east, $north ) = ll_to_grid( $lat, $lon );

literally that's it. two functions, both directions, no drama 🦋

---

💫 DESCRIPTION 💫

So what it does: it converts back and forth between Irish Transverse Mercator grid and WGS84. that's the vibe check and it passed ✅

Now the tea: the conversion code was stolen wholesale from <http://bit.ly/ZqpUA>. not "inspired by", not "adapted from" — wholesale. no cap. here's the actual source it came from:

http://svn.geograph.org.uk/svn/branches/british-isles/libs/geograph \
  /conversionslatlong.class.php

and here's the important bit, bestie, do NOT forget this: nothing is exported by default. zero. nada. you have to ask for what you want. the exportable functions are ll_to_grid and grid_to_ll. that's the whole menu 👑

---

🔥 INTERFACE 🔥

🧚 ll_to_grid 🧚

Takes a latitude, longitude pair (that's WGS84, bestie) and converts it into an ITM easting and northing. it's giving "here's where you are, now in grid form":

my ( $east, $north ) = ll_to_grid( $lat, $lon );

🧚 grid_to_ll 🧚

The reverse glow-up: takes an ITM easting, northing pair and hands you back a WGS84 latitude, longitude:

my ( $lat, $lon ) = grid_to_ll( $east, $north );

two directions, one module, periodt 💅

---

💀 BUGS 💀

found a bug? want a feature? pls don't suffer in silence, report it 🙈

• email it to bug-geo-coordinates-itm@rt.cpan.org, or
• go through the web interface at <http://rt.cpan.org>

that's the whole escalation path, iykyk.

---

👑 AUTHOR 👑

Andy Armstrong <andy@hexten.net>

and, once more for the people in the back — code gratefully stolen from <http://bit.ly/ZqpUA>:

http://svn.geograph.org.uk/svn/branches/british-isles/libs/geograph \
  /conversionslatlong.class.php

---

🌈 LICENCE AND COPYRIGHT 🌈

Copyright (c) 2009, Andy Armstrong <andy@hexten.net>.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. that's the legal bit and we respect it 💜

---

and that's the whole page, bestie! this was rendered by perl v5.36.0 on 2022-11-19, filed under Geo::C...es::ITM(3pm) 🫶 stay converting, stay iconic, mwah 😭💖