Metadata-Version: 2.1
Name: aliquoter
Version: 0.0.1
Summary: Aliquot Mogrifier
Home-page: https://github.com/whardier/Aliquoter
Author: Shane R. Spencer
Author-email: shane@bogomip.com
License: None
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering :: GIS

Aliquoter
=========

Aliquot mogrifier utilizing the BLM PLSS method of quartering/halving sections.

Purpose
-------

Given a quad of point pairs (long, lat) return a quad of point pairs for a 
specific aliquot string.

This code should work on any quad in any orientation as long as north, south, 
east, west can be defined appropriately.

This code uses specific points rather than a bounding box set to 0 degrees.

Example
-------

Aliquot string: **E2SW4SW4**

Aliquot meaning: **The East half of the South West quarter of the South West quarter**

This would mean that the quad would be split up into a South West square (SW4) 
and then another South West square (SW4) and then the East half of that square 
would be returned.

<pre>
4,0                                           4,4
+-----------------------+-----------------------+
|                       |                       |
|                       |                       |
|                       |                       |
|                       |                       |
|                       |                       |
|                       |                       |
|                       |                       |
|                       |                       |
|                       |                       |
|          S-W          |                       |
|          \ /          |                       |
+-----------+-----------+-----------------------+
|           |           |                       |
|           |           |                       |
|           |           |                       |
|    S-W    |           |                       |
|    \ /    |           |                       |
+-----*******-----------+-----------------------+
|     *     *           |                       |
|     *     *           |                       |
|     *  E  *           |                       |
|     *     *           |                       |
|     *     *           |                       |
+-----*******-----------+-----------------------+
0,0                                           0,4
</pre>

Usage
-----

Check out 'test.py'.  It represents the above example and outputs the following.

Code:

```python
from aliquoter import aliquot, Quad, Point

print aliquot(
            Quad(
                nw=Point(lat=4, long=0),
                sw=Point(lat=0, long=0),
                ne=Point(lat=4, long=4),
                se=Point(lat=0, long=4),
            ),
            ['SW', 'SW', 'E']
        )
```

In the above code the list of aliquot quarters/halves is reversed to make 
processing more straight forward.

Result:

```
Quad(
    nw=Point(lat=1.0, long=0.5),
    sw=Point(lat=0.0, long=0.5),
    ne=Point(lat=1.0, long=1.0),
    se=Point(lat=0.0, long=1.0)
)
```



