flash_extensions 3.1.1 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c4a7aafeb611b94c20ec6deecf5e604714e55482
-  data.tar.gz: b5d57365ddd985af4abebde381662d624b90fb59
+  metadata.gz: 29bc0da7ad03da1d52f8eee6a230cf349c977bf7
+  data.tar.gz: 4ff32a8160e43520e058d9376bcef76ee0718803
 SHA512:
-  metadata.gz: d40db1ddc4db820c4364e1ac382e1c2786d199d0ea4921f007a27cf364ff59bae43fc613277562bbba6d74478d649e8c374ba7a0f6c5b6123d78c7b89ad54d9e
-  data.tar.gz: 9fd19ad1ee7ba42da595e539fc214b57b98cad4d9a5650f8a57d3267d16e57f842007dbbe28c9e821d4daa45ac7131e3e50978f2a89db004bbf38ef13119464c
+  metadata.gz: f29027c054f49c5a80423aabb8c70bdd7f6b223a0b6565fcd4e2df10eba781b0f148106c907c0867923a57cd63acf350c01b604fbf1a8198f268e42848932faa
+  data.tar.gz: 1e22b5d041b52897ec998a05ec5edec1c583a85cd8ffd95b43c62e38ee99794f7bfde795165165e3feca097e6951676a834dd2f41493aeacebb10de6291ad904

data/README.md

@@ -154,6 +154,14 @@ Use the `several?` method to return if there are several types of an element.
 [].several? #=> false
 ```
 
+####Standard Deviation:####
+Use the `standard_deviation` method to return the standard deviation of elements of a collection.
+
+```ruby
+[1,2,6].variance #=> 2.6457513110645907
+[].variance #=> nil
+```
+
 ####Sum:####
 Use the `sum` method to to return the sum of a collection of numbers.
 
@@ -180,6 +188,14 @@ Use the `take_last_while` method to return the last number of elements of a coll
 [].take_last_while(&:odd?) #=> []
 ```
 
+####Variance:####
+Use the `variance` method to return the variance of elements of a collection.
+
+```ruby
+[1,2,6].variance #=> 7
+[].variance #=> nil
+```
+
 ### HashExtensions
 
 ####Except:####

data/lib/flash_extensions/extensions/enumerable_extension.rb

@@ -110,6 +110,11 @@ module Enumerable
     (found_count > 1) ? true : false
   end
 
+  def standard_deviation
+    return if length < 2
+    Math.sqrt(variance)
+  end
+
   def take_last(n)
     array = to_a
 
@@ -125,4 +130,12 @@ module Enumerable
     result
   end
 
+  def variance
+    collection_length = length
+
+    return if collection_length < 1
+    sum = inject(0) { |accumulator, value| accumulator + (value - mean) ** 2 }
+    sum / (collection_length.to_f - 1)
+  end
+
 end

data/lib/flash_extensions/version.rb

@@ -1,3 +1,3 @@
 module FlashExtensions
-  VERSION = "3.1.1"
+  VERSION = "3.2.0"
 end

data/spec/lib/enumerable_extension_spec.rb

@@ -158,6 +158,20 @@ describe Enumerable do
     end
   end
 
+  describe '#standard_deviation' do
+    it 'to be the square root of the #variance' do
+      expect([1,2,6].standard_deviation).to eq(2.6457513110645907)
+    end
+
+    it 'to be nil for single element arrays' do
+      expect([1].standard_deviation).to be_nil
+    end
+
+    it 'to be nil if empty' do
+      expect([].standard_deviation).to be_nil
+    end
+  end
+
   describe "#sum" do
     it "to be 0" do
       expect([].sum).to eq(0)
@@ -192,4 +206,14 @@ describe Enumerable do
     end
   end
 
+  describe '#variance' do
+    it 'to be the mean squared deviation of the sample (n - 1 denominator)' do
+      expect([1,2,6].variance).to eq(7)
+    end
+
+    it 'to be nil if empty' do
+      expect([].variance).to be_nil
+    end
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flash_extensions
 version: !ruby/object:Gem::Version
-  version: 3.1.1
+  version: 3.2.0
 platform: ruby
 authors:
 - Juan Gomez
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-22 00:00:00.000000000 Z
+date: 2014-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler