tonal-tools 8.8.0 → 8.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad355622f7095fece5a99d754e0769935e66757f5d0fdae60ca21f9edfed35f3
-  data.tar.gz: 6b1ac2a795e4650a2dfc28634a05db3501e76cea05ff999b3958cebe63a37094
+  metadata.gz: 6a2b3699a8ff06f96c208824d04c62c5ea28db3915bcabf73d0ff0860fbf677f
+  data.tar.gz: e5fb5120820a4bf96d4489cdf0034a43de897d7dab7a040d6cfc94698ec6bb7e
 SHA512:
-  metadata.gz: 39fbd7a2445f7290f446f808e185c7291b6d7edf889e57cc5a6a8c7925a51940f9e374de6041dd92b03d244f65a1921b93d532e0fee211e467f6ce26dd926252
-  data.tar.gz: adcd55527c91b82f3723f32df38163c747aea3c492eb67d57a8a245a2565302f96cf1c84de2e91a33d533442da8ce88bf07c223789b957f48a965dc4deba926b
+  metadata.gz: d85688a692e9cdf24bc776d2da3faf817015c9b72d31f2c5a4000f05a29db97bf3c13b78307c92496bd9fac1a3a1da9d34a02f250792af25aaf890a5f646d723
+  data.tar.gz: 0a21eff54af842f1a640d4fe6b6081a4679359c72f4e03fb06c782724c573b1ec2b1bcc78fbc8538413a464a8ad35ae18c0d5c72669b74d2a6fb7e86ec3ec566

data/lib/tonal/attributions.rb

@@ -1,4 +1,4 @@
 module Tonal
   TOOLS_PRODUCER = "mTonal"
-  TOOLS_VERSION = "8.8.0"
+  TOOLS_VERSION = "8.8.1"
 end

data/lib/tonal/hertz.rb

@@ -51,11 +51,12 @@ class Tonal::Hertz
   # @return [Tonal::Midi::Note] the midi representation of self
   # @example
   #   Tonal::Hertz.new(440).to_midi => 69.0 MIDI
-  # @param reference [Tonal::Hertz, Numeric] the reference frequency to compare to
   # @param modulo [Integer] the modulo to use for the MIDI note calculation
+  # @param reference_number [Integer] the MIDI note number that anchors the conversion
+  # @param reference_frequency [Numeric] the frequency (Hz) that anchors the conversion
   #
-  def to_midi_note(modulo: Tonal::Midi::Note::DEFAULT_MODULO)
-    Tonal::Midi::Note.new(frequency: to_f, modulo: modulo)
+  def to_midi_note(modulo: Tonal::Midi::Note::DEFAULT_MODULO, reference_number: Tonal::Midi::Note::A4_MIDI_NUMBER, reference_frequency: Tonal::Hertz::REFERENCE_FREQUENCY)
+    Tonal::Midi::Note.new(frequency: to_f, modulo: modulo, reference_number: reference_number, reference_frequency: reference_frequency)
   end
   alias :to_midi :to_midi_note
 

data/lib/tonal/midi.rb

@@ -6,7 +6,7 @@ module Tonal::Midi
     C4_MIDI_NUMBER = 60
     DEFAULT_MODULO = 12
 
-    attr_reader :number, :modulo
+    attr_reader :number, :modulo, :reference_number, :reference_frequency
 
     # @return [Tonal::Midi::Note]
     # @example
@@ -15,20 +15,24 @@ module Tonal::Midi
     # @param number [Integer, nil] the MIDI note number. Mutually exclusive with frequency:
     # @param frequency [Numeric, Tonal::Hertz, nil] the frequency in Hz. Mutually exclusive with number:
     # @param modulo [Integer] the number of steps per octave
+    # @param reference_number [Integer] the MIDI note number that anchors the number/frequency conversion
+    # @param reference_frequency [Numeric] the frequency (Hz) that anchors the number/frequency conversion
     #
-    def initialize(number: nil, frequency: nil, modulo: DEFAULT_MODULO)
+    def initialize(number: nil, frequency: nil, modulo: DEFAULT_MODULO, reference_number: A4_MIDI_NUMBER, reference_frequency: Tonal::Hertz::REFERENCE_FREQUENCY)
       raise ArgumentError, "Provide either number: or frequency:, not both" if number && frequency
 
       @modulo = modulo
+      @reference_number = reference_number
+      @reference_frequency = reference_frequency.to_f
       if frequency
         raise ArgumentError, "Frequency argument is not Numeric or Tonal::Hertz" unless frequency.kind_of?(Numeric) || frequency.kind_of?(Tonal::Hertz)
         @frequency = Tonal::Hertz.new(frequency)
-        @number = (A4_MIDI_NUMBER + modulo * Math.log2(frequency.to_f / Tonal::Hertz::REFERENCE_FREQUENCY)).round
+        @number = (@reference_number + modulo * Math.log2(frequency.to_f / @reference_frequency)).round
       else
-        number = A4_MIDI_NUMBER if number.nil?
+        number = @reference_number if number.nil?
         raise ArgumentError, "Number argument is not Integer" unless number.kind_of?(Integer)
         @number = number
-        @frequency = Tonal::Hertz.new(Tonal::Hertz::REFERENCE_FREQUENCY * (2 ** ((number - A4_MIDI_NUMBER) / modulo.to_f)))
+        @frequency = Tonal::Hertz.new(@reference_frequency * (2 ** ((number - @reference_number) / modulo.to_f)))
       end
     end
 

data/lib/tonal/ratio.rb

@@ -187,10 +187,13 @@ class Tonal::Ratio
   # @example
   #   Tonal::Ratio.new(3,2).to_midi => 76 MIDI
   # @param reference [Numeric] the reference frequency
-  # @param modulo [Integer] the modulo for the MIDI note
+  # @param modulo [Integer] the number of steps per octave used to scale self's offset from reference. The
+  #   reference frequency's own MIDI note number is always computed independently of modulo.
   #
   def to_midi(reference: Tonal::Hertz.reference, modulo: Tonal::Midi::Note::DEFAULT_MODULO)
-    to_hertz(reference: reference).to_midi(modulo: modulo)
+    reference_hertz = Tonal::Hertz.new(reference)
+    reference_number = reference_hertz.to_midi_note.number
+    to_hertz(reference: reference_hertz).to_midi_note(modulo: modulo, reference_number: reference_number, reference_frequency: reference_hertz.to_f)
   end
 
   # @return [Integer] the step of self in the given modulo

metadata

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