HarmonicMetric

Extension

metric - A symbol. Can be \harmonicity, \harmonicDistance or \gradusSuavitatis. Default is \harmonicity. g = HarmonicMetric.new; // posts harmonicity g.value([5,4]); // the harmonic intensity of 5/4

Instance Variable. The current type of harmonic metric. Can be changed. g = HarmonicMetric(\gradusSuavitatis); g.type = \harmonicDistance;

Give the values of the harmonic metric for an array of [p, q] ratios. ratios - A collection of ratios or a single [p,q] ratio.r = [ [1,1], [1,2], [3,2], [5,6], [11,8], [13,12] ]; g = HarmonicMetric.new(\harmonicDistance); g.value(r).round(0.001); g.type = \harmonicity; g.value(r).round(0.001); // as can be seen, harmonicity decreases with harmonic dissonance // while gradusSuavitatis and harmonicDistance increase g.type = \gradusSuavitatis g.value(r); // the gradus function returns integer values

Returns the most harmonic ratio from the collection according to the current type of metric. ratios - A collection of ratios.g = HarmonicMetric.new; g.mostHarmonic([ [3,2], [4,3]]); // a fifth is more harmonic than a fourth

Same as above but for the least harmonic of a ratio collection. ratios - A collection of ratios.g = HarmonicMetric(\gradusSuavitatis); g.leastHarmonic([ [7,4], [16,9]]); // a harmonic seventh is less harmonic than a minor // seventh according to gradusSuavitatis g.type = \harmonicDistance; g.leastHarmonic([ [7,4], [16,9]]); // but according to harmonic distance, // 16/9 is less harmonic than 7/4

Order the collection of ratios according to the current harmonic metric type. // compare the 3 different results: g = HarmonicMetric.new; // default is harmonicity g.order([[1,1],[9,8],[5,4],[4,3],[3,2],[5,3],[15,8],[2,1]]) g.type = \gradusSuavitatis; // change type and reorder g.order([[1,1],[9,8],[5,4],[4,3],[3,2],[5,3],[15,8],[2,1]]) g.type = \harmonicDistance; // change type and reorder g.order([[1,1],[9,8],[5,4],[4,3],[3,2],[5,3],[15,8],[2,1]])

Allows the representation of an instance object printout its type. It is not used on its own.g = HarmonicMetric.new; // prints out its type g.type = \gradusSuavitatis;