compass_rose

A tiny gem to convert numerical bearings to their string forms.

compass_rose is released under The MIT License The full text of the license can be found in the LICENSE file. The summary can be found here courtest of tldrlegal.

In short, MIT is a permissive license and means you can pretty much do what you want with this code as long as the original copyright is included.

See CONTRIBUTION.md for information on contributing back to this project.

gem install compass_rose

Gemfile

gem 'compass_rose'

require 'compass_rose'
bearing = 232   # directional bearing
points = 16     # the number of points the compass rose should be divided into
d = Compass::Rose.direction(bearing, points)

At this point, d would contain the direction. This would be a Hash with the following keys:

• full - full name of the direction, (i.e. North by east, North-northeast, etc.)
• abbr - direction's abbrivation (i.e., N, ESE, SWbW, etc.)
• wind_pt - the traditional wind point (i.e., Qto Ponente verso Maestro)

A compass rose can be cut in to 4 different sizes: 4, 8, 16, 32. This table shows which directions are available in the different sizes: