blog.humaneguitarist.org

Eighteen Rules

[Sun, 18 Aug 2013 18:16:42 +0000]
Eighteen Rules ___________________________________________________________________________ Table of Contents Introduction Source Code Demo API FAQ ___________________________________________________________________________ Introduction Eighteen Rules is web application designed to help guitar makers and luthiers calculate fret distances using the Rule of 18 [http://liutaiomottola.com/formulae/fret.htm]. It was designed for my guitarist and luthier friend Dr. James Buckland [http://www.youtube.com/user/Ludlamshohle]. You can visit the Eighteen Rules site at "http://humaneguitarist.org/eighteenrules/ [http://humaneguitarist.org/eighteenrules/]". ___________________________________________________________________________ Source Code You can download the source code for Eighteen Rules here [http://blog.humaneguitarist.org/uploads/EighteenRules/EighteenRules_1.0.zip]. ___________________________________________________________________________ Demo A demonstration video on using the application can be seen here [https://vimeo.com/72812601] or you can view the embedded video below. IFRAME: http://player.vimeo.com/video/72812601 Eighteen Rules: a rule of eighteen calculator [http://vimeo.com/72812601] from nitin arora [http://vimeo.com/user3665532] on Vimeo [https://vimeo.com]. ___________________________________________________________________________ API The Eighteen Rules application is built on top of a simple JSON API. The API accepts three parameters: * scale_length: float[1, 1000] * total_frets: int[1, 1000] * rule_of: float[1, 1000] You can optionally add the "callback" parameter if you need to use JSONP. Here are two examples, the first without the callback: http://humaneguitarist.org/eighteenrules/api.php?scale_length=650&total_frets=24&rule_of=18 [http://humaneguitarist.org/eighteenrules/api.php?scale_length=650&total_frets=24&rule_of=18] http://humaneguitarist.org/eighteenrules/api.php?scale_length=650&total_frets=24&rule_of=18&callback [http://humaneguitarist.org/eighteenrules/api.php?scale_length=650&total_frets=24&rule_of=18&callback] ___________________________________________________________________________ FAQ 1. What unit of measurement is assumed for the fret calculation? + Because the calculation is a mathematical function, there's really no assumed unit of measurement for scale length as far as the API is concerned. For the web application, millimeters are assumed. Because of this, the resulting table has columns for millimeters and inches. 2. Can I save my results after using the calculator? + You can save your results by printing them to paper or PDF, etc. 3. Can I export the results from the calculator into a spreadsheet program such as Microsoft Excel? + Exporting the results is not possible, but you should be able to copy/paste the tabular results directly into a spreadsheet application.