davidrichards-just_enumerable_stats 0.0.12 → 0.0.13

data/README.rdoc

@@ -145,12 +145,23 @@ There are a few new features for scaling data:
   => [0.166666666666667, 0.333333333333333, 0.5]
   >> a
   => [0.166666666666667, 0.333333333333333, 0.5]
+  >> a = [-5,0,5]      
+  => [-5, 0, 5]
+  >> a.scale_to_sigmoid
+  => [0.00669285092428486, 0.5, 0.993307149075715]
+  >> a
+  => [-5, 0, 5]
+  >> a.scale_to_sigmoid!
+  => [0.00669285092428486, 0.5, 0.993307149075715]
+  >> a                  
+  => [0.00669285092428486, 0.5, 0.993307149075715]
 
 Basically:
 
 * scale can scale by a number or with a block.  The block is a transformation for a single element.
 * scale_between sets the minimum and maximum values, and keeps each value proportionate to each other.
 * normalize calculates the percentage of an element to the whole.
+* scale_to_sigmoid uses the sigmoid function to scale a set between 0 and 1 with a Gaussian distribution on the numbers.
 
 == Categories
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :major: 0
 :minor: 0
-:patch: 12
+:patch: 13

data/lib/just_enumerable_stats.rb

@@ -721,6 +721,11 @@ module Enumerable
   end
   safe_alias :_jes_scale!
   
+  def _jes_scale_to_sigmoid
+    self._jes_scale { |e| 1 / (1 + Math.exp( -1 * (e))) }
+  end
+  safe_alias :_jes_scale_to_sigmoid
+
   def _jes_scale_to_sigmoid!
     self._jes_scale! { |e| 1 / (1 + Math.exp( -1 * (e))) }
   end

data/spec/just_enumerable_stats_spec.rb

@@ -552,7 +552,17 @@ describe "JustEnumerableStats" do
     a[4].should be_close(0.98201, 1.0e-5)
   end
   
-  it "should be able to scale to a signoid" do
+  it "should have a non-desctructive scale_to_sigmoid" do
+    a = [-4, -2, 0, 2, 4]
+    b = a.scale_to_sigmoid
+    b[0].should be_close(0.01798, 1.0e-5)
+    b[1].should be_close(0.11920, 1.0e-5)
+    b[2].should eql(0.5)
+    b[3].should be_close(0.88079, 1.0e-5)
+    b[4].should be_close(0.98201, 1.0e-5)
+  end
+
+  it "should be able to scale to a sigmoid" do
     a = [-4, -2, 0, 2, 4]
     a.scale_to_sigmoid!
     a[0].should be_close(0.01798, 1.0e-5)

data/spec/spec_helper.rb

@@ -66,6 +66,7 @@ class BusyClass
   def pearson_correlation(other); raise ArgumentError, "Should not be called"; end
   def to_f!; raise ArgumentError, "Should not be called"; end
   def scale!; raise ArgumentError, "Should not be called"; end
+  def scale_to_sigmoid; raise ArgumentError, "Should not be called"; end
   def scale_to_sigmoid!; raise ArgumentError, "Should not be called"; end
   def normalize; raise ArgumentError, "Should not be called"; end
   def normalize!; raise ArgumentError, "Should not be called"; end

data/spec/unobtrusive_just_enumerable_stats_spec.rb

@@ -204,6 +204,10 @@ describe "JustEnumerableStats" do
       lambda{@a._jes_scale!(1)}.should_not raise_error
     end
     
+    it "should not use the native scale_to_sigmoid" do
+      lambda{@a._jes_scale_to_sigmoid}.should_not raise_error
+    end
+    
     it "should not use the native scale_to_sigmoid!" do
       lambda{@a._jes_scale_to_sigmoid!}.should_not raise_error
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: davidrichards-just_enumerable_stats
 version: !ruby/object:Gem::Version 
-  version: 0.0.12
+  version: 0.0.13
 platform: ruby
 authors: 
 - David Richards