===========
Music Theory
===========

"Music Theory" (**musictheory**) is a package designed to investigate the 
question "Which chords go with which scales?" A couple of years ago, 
the author was very interested and obsessed in the question, and decided
to put his Python skills to the task. Along the way, the **musictheory** 
package was redesigned to be more flexible and extendible. 

The package has roughly the same philosophy as `Music Set Theory 
<http://www.jaytomlin.com/music/settheory/help.html>`_ but uses different
terminology.

Documentation
-------------

The best thing to do is look at the source code. It contains an *excess*
of documentation strings. Hopefully it makes things clearer.

Installation
-------------

You can get the application from PyPI through the command::

    sudo pip install musictheory

License
-------

The software has been released using a 3 clause Berkeley Software 
Distribution (BSD) license. See LICENSE.txt for more information.

Versions
-------------

* 0.1 (May 1th 2011) - Create setup script for files.

* 0.2 (May 11th 2011) - Remove bugs for working with chordgenerator.

* 0.3 (June 6th 2011) - Add license information. Add more scales.

* 0.4 (April 24th 2013) - Try to make a half-decent PyPI package.

Copyright
------

The **musictheory** is copyright (c) 2008-2013 `Peter Murphy <http://www.pkmurphy.com.au/>`_ 
<peterkmurphy@gmail.com>.