Optical Tablature Recognition Toolkit for Gamera
================================================

Purpose
-------

"Optical tablature recognition" (OTR) means the extraction of a
machine readable tablature encoding from bitmap images of historic
lute tablature prints.

This toolkit provides

 - python library functions for building own tablature recognition
   applications
 - ready to use tablature recognition functionality for training
   tablature symbols and the actual recognition based on the trained
   data


Requirements
------------

This toolkit has been written for the Gamera framework and requires
a working Gamera installation. See the Gamera homepage:

	http://gamera.sourceforge.net/

Addtionally it relies on another Gamera toolkit "musicstaves", which
is available from

	http://music-staves.sf.net


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

For a user's guide and a developer's guide see 'doc/html/index.html'.
For release notes and a revision history see 'CHANGES'.


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

See the section "Installation" in 'doc/html/index.html' or 
'doc/src/index.txt'.


Authors
-------

Christoph Dalitz, <christoph dot dalitz at hsnr dot de>, 2004-2012
Thomas Karsten, 2004-2005
Christine Pranzas, 2007
Christian Brandt, 2012

Please contact Christoph Dalitz for questions about this toolkit.


License
-------

This toolkit is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
file LICENSE for more details.
