semvec/pypi-packages huggingface dataset:
tiletanic 1.1.0
Geospatial tiling utilities
License: MIT

Tiletanic: Tools for Manipulating Geospatial Tiling Schemes
===========================================================

.. image:: https://travis-ci.org/DigitalGlobe/tiletanic.svg?branch=master
   :target: https://travis-ci.org/DigitalGlobe/tiletanic



Tiletanic is a library for making and using geospatial tiling schemes.  It's goal is to provide tooling for dealing with the conversion between a tile specified in  as (row, column, zoom level),  geospatial coordinates, or quadkeys.  It also provides functionaly for taking an input geometry and figuring out what tiles cover it.  

Tiletanic is MIT licensed.  

Full documentation is hosted `here <http://tiletanic.readthedocs.org/en/latest/>`_.

Installation is easy::

    pip install tiletanic

The only dependency is shapely_, and to install that, you'll need GEOS_ installed (usually in your package manager). 

Motivation
----------

You may be familar with the `Web Mercator`_ (or Spherical Mercator, Google Tiles, etc) tiling scheme, which is the most commonly encountered tiling scheme on the web.  There are good tools out there for dealing specifically with this projection, for instance Mercantile_ fits the bill.  If you're dealing exclusively with this projection, you might get better mileage with them!

One oddity of Web Mercator is that coordinates are usually expressed in geographic (longitude, latitude) coordinates that live on the ellipsoid (WGS84) rather than in units of the Web Mercator projection (meters).  Dealing with this kind of conversion is exactly what Mercantile_ and its like were made to handle.

Tiletanic's use cases are a bit different:

- What do you do if your data is already in some projection?  For instance, you might want to know what tile covers a point specified in the Web Mercator projection without first converting back to WGS84.  Tiletanic can help.
- At DigitalGlobe_, our imagery is often projected into many other projections (UTM, Geographic, etc) and it is often times extremely convienent to organize raster data into a tiled format before proceeding with processing (a single "strip" from one of our satellite collects can easily be 100km long!).  When dealing with different projections, the user typically needs to impose their own tiling scheme.  Tiletanic provides an easy way for you to define you're own scheme and get a lot of tiling functionality right out of the gate.

.. _`Web Mercator`: https://en.wikipedia.org/wiki/Web_Mercator
.. _Mercantile: https://github.com/mapbox/mercantile
.. _DigitalGlobe: https://www.digitalglobe.com/  
.. _shapely: https://github.com/Toblerity/Shapely
.. _GEOS: http://geos.osgeo.org/doxygen/