easystats 0.0.2 → 0.0.3

data/README

@@ -19,6 +19,18 @@ median(x)
 Paramaters: Takes in an array of numbers
 Returns: The median of the numbers in the array
 
+range(x)
+Parameters: Takes in an array of numbers
+Returns: The range of the numbers
+
+mode(x)
+Parameters: Takes in an array of numbers
+Returns: The mode, if any.  Otherwise a string that says "There is no mode"
+
+variance(x)
+Paramaters: Takes in an array of numbers
+Returns: The variance
+
 Example usage:
 
 require "rubygems"
@@ -33,5 +45,8 @@ m = Easystats.new
 
 puts "Sum: " + m.sum(myNumbers).to_s
 puts "Average: " + m.mean(myNumbers).to_s
+puts "Variance: " + m.variance(myNumbers).to_s
 puts "Standard Deviation: " + m.standard_deviation(myNumbers).to_s
 puts "Median: " + m.median(myNumbers).to_s
+puts "Range: " + m.range(myNumbers).to_s
+puts "Mode: " + m.mode(myNumbers).to_s

data/easystats.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |s|
   s.email       = ["matthew@grigajtis.org"]
   s.homepage    = "https://github.com/mgrigajtis/easystats"
   s.summary     = %q{Easy to use statistics functions}
-  s.description = %q{This gem contains statistics functions that are easy to use.}
+  s.description = %q{This gem contains statistics functions that are easy to use. The gem is still in its infancy, but it currently provides easy to use methods for sum, mean, standard deviation, median, range, mode, and variance.  More functions will be added as the gem matures, please feel free to fork on Github!}
 
   s.rubyforge_project = "easystats"
 

data/lib/easystats.rb

@@ -16,13 +16,14 @@ class Easystats
 
   # take in an array of numbers and calculate the mean (average)
   def mean(data)
-    self.sum(data) / data.count
+    self.sum(data) / data.count.to_f
   end
 
-  # take in an array of numbers and calculate the standard deviation
-  def standard_deviation(data)
-    average = self.mean(data)
+  # this is an internat function (technically the developer can use it but should have no need)
+  # this function returns the sum of each squared difference of mean
+  def sum_of_deviations_squared(data)
     deviations = Array.new
+    average = self.mean(data)
     sum_of_deviations = 0
 
     data.each do |num|
@@ -33,9 +34,22 @@ class Easystats
       sum_of_deviations += num
     end
 
+    sum_of_deviations
+  end
+
+  # take in an array of numbers and calculate the standard deviation
+  def standard_deviation(data)
+    sum_of_deviations = self.sum_of_deviations_squared(data)
+
     Math::sqrt(sum_of_deviations / (data.count-1))
   end
 
+  def variance(data)
+    average = self.mean(data)
+    sum_of_deviations = self.sum_of_deviations_squared(data)
+    sum_of_deviations / data.count.to_f
+  end
+
   # take in the array of numbers and calculate the median
   def median(data)
     halfway = data.count / 2
@@ -48,7 +62,7 @@ class Easystats
     if(data.count % 2) == 0
       median = (data[halfway] + data[halfway-1]) / 2.0
 
-    # Else, there is an odd number in the array
+    # Else, there is an odd number of elements in the array
     else
       median = data[halfway]
     end
@@ -62,5 +76,64 @@ class Easystats
     data = data.sort
     data[data.count-1] - data[0]
   end
-end
 
+  # take in an array of numbers and return the mode
+  def mode(data)
+    # Sort the array
+    data = data.sort
+
+    # create a flag to tell the user if all the numbers only appear once
+    no_mode = true
+
+    # The variable that will hold the highest number
+    highest_value = 0
+   
+    # The variable that holds the most time the value appears
+    most_times = 0
+
+    # Create a new hash to hold the numbers
+    tmp = Hash.new
+
+    # Populate the hash
+    data.each do |num|
+      if tmp["#{num}"].nil? == false
+        tmp["#{num}"] = tmp["#{num}"].to_i + 1
+      else
+        tmp["#{num}"] = 1
+      end
+    end
+
+    # Check to make sure that there is a mode
+    data.each do |num|
+      if tmp["#{num}"].to_i > 1
+        no_mode = false
+      end
+    end
+ 
+    if no_mode == true
+      "There is no mode"
+    else
+      data.each do |num|
+        if tmp["#{num}"].to_i > most_times
+          highest_value = num
+          most_times = tmp["#{num}"]
+        end 
+      end
+
+      # now loop through again just to make sure another number doesn't appear an equal number of times
+      data.each do |num|
+        if num != highest_value
+          if tmp["#{num}"].to_i == most_times
+            no_mode = true
+          end
+        end
+      end
+ 
+      if no_mode == true
+        "There is no mode"
+      else
+        highest_value
+      end
+    end
+  end
+end

data/lib/easystats/version.rb

@@ -1,3 +1,3 @@
 module Easystats
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Matthew Grigajtis
@@ -14,11 +14,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-12 00:00:00 -05:00
+date: 2011-01-13 00:00:00 -05:00
 default_executable: 
 dependencies: []
 
-description: This gem contains statistics functions that are easy to use.
+description: This gem contains statistics functions that are easy to use. The gem is still in its infancy, but it currently provides easy to use methods for sum, mean, standard deviation, median, range, mode, and variance.  More functions will be added as the gem matures, please feel free to fork on Github!
 email: 
 - matthew@grigajtis.org
 executables: []