tonal-tools 8.3.3 → 8.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4abf5cbb165cd0add4c91cc6d4394219076e7ab5bc02ac52288f6d3f6c278e1
-  data.tar.gz: 405af2ddb5dcbf483c3dca44a1ba6307d283f0d85b28d20b65c916178963b7d6
+  metadata.gz: bdb178eb44ac2841a878052e7ec184d97dbe4b992596c4fc849ba7cbd8c08538
+  data.tar.gz: 59043afa410a203fb83c361e8f580a60e2c81903d4b95153ed5f8a8e3285a68e
 SHA512:
-  metadata.gz: c516d5914d93c9f563cf0b9b71d2d15c89f408c159010899ea9552d82d176d193c62cd7463ed44c6e287c67efc9091979e5ca7aa4ed3b37d0453e9bebd02690c
-  data.tar.gz: 72ea362063ea441c121200cc0ec6b9aa6e789047f9090218a3b7d1dbe156c8f0614e88b67911ecbfbc635d7919671f32f41c0f87ea1f66938eb26bd55090e006
+  metadata.gz: cbc32bccbf514a8abce43f1627b1795d8517091a452be252325317958075c1c9a13a407f389b12c93426c6786feedfb00c1bb777368e0c625440de605d734cfe
+  data.tar.gz: 86d55133cdd853c597d07fdd1017d674aa8cc1898dbe560a31c556877ae2c1567b262bcfd43b68eab9e67f0fe44267d0f02f9c770f5032ca66d4e53a922abab4

data/lib/tonal/attributions.rb

@@ -1,4 +1,4 @@
 module Tonal
   TOOLS_PRODUCER = "mTonal"
-  TOOLS_VERSION = "8.3.3"
+  TOOLS_VERSION = "8.3.4"
 end

data/lib/tonal/cents.rb

@@ -3,6 +3,7 @@ class Tonal::Cents
   include Comparable
 
   def_delegators :@log, :logarithm, :logarithmand, :base
+  def_delegators :@ratio, :numerator, :denominator, :to_reduced_ratio, :to_ratio
 
   HUNDREDTHS_ROUNDOFF = -2
   FLOAT_PRECISION = 100
@@ -40,6 +41,8 @@ class Tonal::Cents
     end
   end
 
+  alias :reduced_ratio :to_reduced_ratio
+
   # @return [Tonal::Cents] the default cents tolerance
   # @example
   #   Tonal::Cents.default_tolerance => 5
@@ -149,8 +152,8 @@ class Tonal::Cents
   end
 
   def derive_ratio(log: nil, ratio: nil)
-    return Tonal::ReducedRatio.new(log.logarithmand) if log
-    Tonal::ReducedRatio.new(ratio.numerator, ratio.denominator)
+    return Tonal::Ratio.new(log.logarithmand) if log
+    Tonal::Ratio.new(ratio.numerator, ratio.denominator)
   end
 
   def derive_cents(cents: nil, log: nil)

data/lib/tonal/hertz.rb

@@ -15,9 +15,9 @@ class Tonal::Hertz
 
   # @return [Tonal::Hertz] 440 Hz
   # @example
-  #   Tonal::Hertz.a440 => 440.0 Hz
+  #   Tonal::Hertz.reference => 440.0 Hz
   #
-  def self.a440
+  def self.reference
     self.new(440.0)
   end
 
@@ -29,7 +29,6 @@ class Tonal::Hertz
     Rational(value)
   end
 
-
   # @return [Rational] self as a float
   # @example
   #   Tonal::Hertz.new(440).to_f => 440.0
@@ -38,6 +37,15 @@ class Tonal::Hertz
     value.to_f
   end
 
+  # @return [Tonal::Cents] the cents difference between self and a reference frequency
+  # @example
+  #   Tonal::Hertz.new(880).to_cents => 1200.0
+  # @param reference [Tonal::Hertz, Numeric] the reference frequency to compare to
+  #
+  def to_cents(reference: self.class.reference)
+    Tonal::Cents.new(ratio: to_r / reference.to_r)
+  end
+
   # @return [String] the string representation of Tonal::Hertz
   # @example
   #   Tonal::Hertz(1000.0).inspect => "1000.0 Hz"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tonal-tools
 version: !ruby/object:Gem::Version
-  version: 8.3.3
+  version: 8.3.4
 platform: ruby
 authors:
 - Jose Hales-Garcia
 bindir: bin
 cert_chain: []
-date: 2026-02-26 00:00:00.000000000 Z
+date: 2026-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yaml