Convert between compass points and degrees
Python Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
portolan
.gitignore
LICENSE
Makefile
readme.md
setup.cfg
setup.py

readme.md

Portolan

Convert between compass points and degrees. It's a super tiny library with no dependencies.

pip install portolan

Methods

Just a few: point, traditional, degrees, middle, range.

Examples

Convert from abbreviations or a decimal degree to the compass point:

import portolan

portolan.point(abbr='nnw')
# 'north-northwest'

portolan.point(degree=275.1)
# 'west'

Convert to traditional names of the Mediterranean basin:

portolan.traditional(degree=12.6)
# 'Quarto di Tramontana verso Greco'

portolan.traditional(abbr='NEbE')
# 'Quarto di Greco verso Levante'

Convert between degrees and abbrevations:

portolan.abbr(145.0)
# 'SEbS'

portolan.middle('SEbS')
# 146.25

portolan.range('SEbS')
# (140.625, 151.875)

# Remember that North spans the origin
portolan.range('n')
# (354.375, 5.625)

# the degrees method returns the minimum, middle, and maximum of a compass point
portolan.degrees('SEbS')
# (140.625, 146.25, 151.875)