Module:Harmonic entropy/doc: Difference between revisions

From Xenharmonic Wiki
Jump to navigation Jump to search
← Older edit
VisualWikitext
Plumtree (talk | contribs)
autopatrolled, emailconfirmed
1,976 edits
mNo edit summary
ArrowHead294 (talk | contribs)
14,512 edits
mNo edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This module provides several functions to work with [[interval]]-related math.
{{documentation|
{{dochead|header=none}}{{lua|Limits|Rational}}
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.
It can be called from other modules by using <code>require("Module:Harmonic entropy")</code> and calling the <code>_</code>-prefixed functions.


== Functions ==
=== 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>harmonic_entropy(c, ratios, deviation, norm)</code>
* <code>harmonic_entropy(c, ratios, deviation, norm)</code> 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>.
: 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>.
 
}}
<includeonly><hr><small>Documentation transcluded from [[/doc]]</small> [[Category:Lua modules]]</includeonly>

Latest revision as of 12:06, 19 May 2025

This module depends on the following other modules:

This module provides a means to calculate harmonic Shannon entropy of a particular interval.

It can be called from other modules by using require("Module:Harmonic entropy") and calling the _-prefixed functions.

Functions

harmonic_entropy(c, ratios, deviation, norm)
Computes harmonic Shannon entropy of an interval of c cents across ratios with a Gaussian with standard deviation (also in cents) and a norm associated with the ratios.


Retrieved from "https://en.xen.wiki/index.php?title=Module:Harmonic_entropy/doc&oldid=196853"