ruby-mext 0.17.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14bb04ea6a49d39b2bfff16e1caaad92dbb6242ce7482dc1293c48f01d578aac
-  data.tar.gz: 81aa5f792ce7265f175350a02c787e1ed0f0d025bfc289a566fc211e5c87c692
+  metadata.gz: d9b83368400b233efcb67e07aa764cb5d2e94b0b1b5e9b4ff2a920a2792a79ff
+  data.tar.gz: 42d1153c6aefcc11f0df912d83217664389330b727c290615ce876e7f94a063b
 SHA512:
-  metadata.gz: 444a91aeb11d33fa0104690b7f6fa05d298531a760ff6fd13787dbf4a56a052eed491664ad841ce73a8ccea29c8607d87afbf04e69f3a69bab8c1e2d135668c4
-  data.tar.gz: 375f273a8ac894dc2ac4ab2b9efd226780f79575651c4e2d439bce4d5a65a27270e6f916fbec47dfd93924108e177fb5c1e11e1d53326c06df73831e8ae2e7ab
+  metadata.gz: 1c39bfe3de9837b0373507e98dcce6998c04b13e1bc6c25b106ca6fba1497208e0585c8785bc453e772ce6e8bbfc4bb2cdca4a5da85eb49233692bd53e801595
+  data.tar.gz: 6c0fb5664761bd1298a69d7f7a2b9c8893b1035bb72824d2f42c891c137272dc56fefa2c2f3261861a81bf98b2cb30e231c312e41cf4685b0a6ad11986ddc043

data/lib/mext/math.rb

@@ -8,5 +8,6 @@ end
   function
   line
   expon
+  log
   stepwise
 ).each { |f| require File.join(Mext::MATH_PATH, f) }

data/lib/mext/math/log.rb

@@ -0,0 +1,91 @@
+require 'cmath'
+
+module Math
+
+  class Log < Function
+
+    attr_reader :y_start, :y_end, :base
+    attr_reader :a, :b, :c
+
+    #
+    # +DEFAULT_BASE+: default logarithmic curvature factor for +Log()+
+    #
+    DEFAULT_BASE = Math::E
+
+    #
+    # +Math::Log.new(ystart, yend, xstart, xend, base = DEFAULT_BASE)+:
+    #
+    # exponential curve `y = e^(a*x + b) + c` where:
+    #
+    # `c = yend + base`
+    #
+    # Arguments are:
+    #
+    # +ystart+, +yend+: start/end y values required
+    # +xstart+, +xend+: start/end x values
+    # +base+: the curvature factor
+    #
+    #:nodoc:
+    def initialize(ys, ye, xs, xe, base = DEFAULT_BASE)
+      @y_start = ys
+      @y_end   = ye
+      @x_start = xs
+      @x_end   = xe
+      @base     = base
+      setup
+    end
+
+    #:doc:
+    #
+    # +y(x)+:
+    #
+    # Returns a real value (forcing any complex result to its modulus) for any
+    # given x
+    #
+    #:nodoc:
+    def y(x)
+      (CMath::log(self.a*x + self.b) + self.c).abs   # we want a real number result, no complex please
+    end
+
+    def label
+      "base: #{self.base}"
+    end
+
+    class << self
+
+      #
+      # +from_yaml(yaml_hash)+:
+      #
+      # creates a Math::Log class from a yaml file which must have the
+      # relevant fields:
+      #
+      # +x_start+
+      # +x_end+
+      # +y_start+
+      # +y_end+
+      # +base+
+      #
+      def from_yaml(yh)
+        args = [yh['y_start'], yh['y_end'], yh['x_start'], yh['x_end'], yh['base']]
+        new(*args)
+      end
+
+    end
+
+  private
+
+    def setup
+       @c = self.y_end + self.base
+
+       log_sv = self.y_start - self.c        # start value of the exponential
+       log_ev = self.y_end - self.c          # end value of the exponential
+       x_length = self.x_end - self.x_start
+
+       @a = (CMath::exp(log_ev) - CMath::exp(log_sv)) / x_length;
+       @b= CMath::exp(log_sv) - (self.a * x_start);
+    end
+
+  end
+
+end
+

data/lib/version.rb

@@ -1,3 +1,3 @@
 module Mext
-  VERSION = '0.17.0'
+  VERSION = '0.18.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-mext
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Nicola Bernardini
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-07-14 00:00:00.000000000 Z
+date: 2019-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: wavefile
@@ -140,6 +140,7 @@ files:
 - lib/mext/math/expon.rb
 - lib/mext/math/function.rb
 - lib/mext/math/line.rb
+- lib/mext/math/log.rb
 - lib/mext/math/stepwise.rb
 - lib/mext/music.rb
 - lib/mext/music/pitch_class.rb