utilities 0.0.23 → 1.0.0

data/lib/utilities/utilities.rb

@@ -28,7 +28,7 @@ module Utilities
   module Statistics
     # Add each object of the array to each other in order to get the sum, as long as all objects respond to + operator
     def sum
-      flatten.compact.inject( :+ )
+      empty? ? 0 : flatten.compact.inject( :+ )
     end
     
     # Calculate squares of each item
@@ -51,7 +51,7 @@ module Utilities
     # Calculate the mean of the array, as long as all objects respond to / operator
     def mean
       a = flatten.compact.to_stat
-      (a.size > 0) ? a.sum.to_f / a.size : 0.0
+      (a.size > 0) ? a.sum.to_f / a.size : nil
     end
     alias_method :average, :mean
     
@@ -62,6 +62,7 @@ module Utilities
     
     # Return the variance of self
     def variance( population = false )
+      return nil if empty?
       m = mean.to_f
       collect{|v| (v - m).square }.to_stats.sum / (size - (population ? 0 : 1))
     end
@@ -70,6 +71,7 @@ module Utilities
     # If population is set to true, then we consider the dataset as the complete population
     # Else, we consider the dataset as a sample, so we use the sample standard deviation (size - 1)
     def standard_deviation( population = false )
+      return nil if empty?
       size > 1 ? Math.sqrt( variance( population ) ) : 0.0
     end
     alias_method :std_dev, :standard_deviation

data/lib/version.rb

@@ -1,7 +1,7 @@
 module Utilities
-  MAJOR = 0
+  MAJOR = 1
   MINOR = 0
-  BUILD = 23
+  BUILD = 0
 
   VERSION = "#{MAJOR}.#{MINOR}.#{BUILD}"
 end

data/test/test_utilities.rb

@@ -173,8 +173,109 @@ describe String do
 end
 
 describe Utilities::Statistics do
+  before(:all) do
+    class Array
+      include Utilities::Statistics
+    end
+  end
+
+  it "#first should returns the first element" do
+    [].first.should == nil
+    [4,3,5,1,2].first.should == 4
+  end
+
+  it "#last should returns the last element" do
+    [].last.should == nil
+    [4,3,5,1,2].last.should == 2
+  end
+
+  it "#size should returns the last element" do
+    [].size.should == 0
+    [4,3,5,1,2].size.should == 5
+  end
+
+  it "#sum should returns the last element" do
+    [].sum.should == 0
+    [4,3,5,1,2].sum.should == 15
+  end
+
+  it "#squares should returns the square of all elements" do
+    [].squares.should == []
+    [1,2,3,4,5].squares.should == [1, 4, 9, 16, 25]
+  end
+
+  it "#sqrts should returns the square root of all elements" do
+    [].sqrts.should == []
+    [1,2,3,4,5].sqrts.should == [1.0, 1.4142135623730951, 1.7320508075688772, 2.0, 2.23606797749979]
+  end
+
+  it "#min should return the smallest element" do
+    [].min.should == nil
+    [1,2,3,4,5].min.should == 1
+  end
+
+  it "#max should returns the biggest element" do
+    [].max.should == nil
+    [1,2,3,4,5].max.should == 5
+  end
+
+  it "#mean should returns the mean of all elements" do
+    [].mean.should == nil
+    [1,2,3,4,5].mean.should == 3
+  end
+
+  it "#frequences should returns the mean of all elements" do
+    [].frequences.should == {}
+    [1,2,3,4,5].frequences.should == {1=>1, 2=>1, 3=>1, 4=>1, 5=>1}
+  end
+
+  it "#variance should returns the mean of all elements" do
+    [].variance.should == nil
+    [1,2,3,4,5].variance.should == 2.5
+  end
+
+  it "#standard_deviation should returns the mean of all elements" do
+    [].standard_deviation.should == nil
+    [4387].standard_deviation.should == 0
+    [1,2,3,4,5].standard_deviation.should == 1.5811388300841898
+  end
+
+  it "#median should returns the median of all elements" do
+    [].median.should == nil
+    [1,2,3,4,5].median.should == 3
+  end
+
+  it "#modes should returns all modes" do
+    [].modes.should == {}
+    [1,2,3,4,5].modes.should == {1=>1, 2=>1, 3=>1, 4=>1, 5=>1}
+  end
+
   it "#statistics should returns a hash with all statistics included" do
-    [1,2,3,4,5].to_stats.statistics.should == {
+    [].statistics.should == {
+      :first=>nil,
+      :last=>nil,
+      :size=>0,
+      :sum=>0,
+      :squares=>[],
+      :sqrts=>[],
+      :min=>nil,
+      :max=>nil,
+      :mean=>nil,
+      :frequences=>{},
+      :variance=>nil,
+      :standard_deviation=>nil,
+      :population_variance=>nil,
+      :population_standard_deviation=>nil,
+      :modes=>{},
+      :ranks=>[],
+      :median=>nil,
+      :midrange=>nil,
+      :statistical_range=>nil,
+      :quartiles=>[nil, nil, nil],
+      :interquartile_range=>nil
+    }
+
+    [1,2,3,4,5].statistics.should == {
       :first=>1,
       :last=>5,
       :size=>5,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: utilities
 version: !ruby/object:Gem::Version
-  version: 0.0.23
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-01 00:00:00.000000000 Z
+date: 2012-09-22 00:00:00.000000000 Z
 dependencies: []
 description: Few utilities include in all my projects, including a module for statistics,
   some to_date and to_time functions as well as intersection method for Range object.
@@ -60,7 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Few utilities include in all my projects