Module:Harmonic entropy/doc: Difference between revisions

m Improve description
Ganaram inukshuk (talk | contribs)
put back function descriptions
 
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This module provides several functions to work with [[interval]]-related math.
{{documentation|{{dochead|header=library}}
This module provides a means to calculate harmonic Shannon entropy of a particular interval.  


Namely, the functions in this module can be called from other modules by using <code>require('Module:Interval')</code> and calling the <code>_</code>-prefixed functions.
{{module introspection
 
| desc_harmonic_entropy=Computes [[Harmonic entropy#Basic Model: Shannon Entropy|harmonic Shannon entropy]] of an interval of <code>c</code> [[cent]]s across <code>ratios</code> with a Gaussian with standard <code>deviation</code> (also in [[cent]]s) and a <code>norm</code> associated with the <code>ratios</code>.}}
== Functions ==
}}
* <code>to_cents(ratio, prec)</code> returns the measure in [[cent]]s of an interval [[ratio]], rounded to a precision of <code>prec</code> decimal places. Parameter <code>prec</code> defaults to 3 if it is omitted.
* <code>parse_ET(input)</code> returns the size (number of divisions) and the [[equave]] of an [[equal tuning]] given its name. Currently only supports equal divisions (e.g. no 88cET yet). This function is designed to be used by other modules only; it cannot be called with <code><nowiki>{{#invoke:}}</nowiki></code>.
* <code>backslash_ratio(input)</code> returns the ratio corresponding to an interval written in [[backslash notation]].
 
<includeonly><hr><small>Documentation transcluded from [[/doc]]</small> [[Category:Lua modules]]</includeonly>