ar_result_calculations 0.0.2 → 0.0.3

data/CHANGELOG

@@ -0,0 +1,6 @@
+ar_result_calculations (0.0.3) December 2, 2010
+
+* Add calculations for sample_variance and standard_deviation
+
+
+

data/README.textile

@@ -28,6 +28,8 @@ p. All methods take one parameter (column name).
 |regression|Ordinary Least Squares regression on the given column.  Returns the regression as an array. Argument should be either an ActiveRecord result set or an array of numbers|
 |slope|Returns the slope of a regression on a given column. Argument should be either an ActiveRecord result set or an array of numbers|
 |make_numeric|Coerces a column to be numeric.  Useful if you have derived columns returned from a query that are not in the model definition and hence are otherwise returned as strings.  Returns **self** so is composable|
+|sample_variance|Calculates the sample variance of a column (for active record result sets) or self (for an array)|
+|standard_deviation|Calculates the standard deviation of a column (for active record result sets) or self (for an array)|
 
 h1. License
 

data/lib/ar_result_calculations/ar_result_calculations.rb

@@ -22,8 +22,12 @@ module ArResultCalculations
       # 
       #   column:  The column name to average
       def mean(column = nil)
-        return super() unless column && first && first.class.respond_to?(:descends_from_active_record?)
-        (length > 0) ? sum(column) / length : 0
+        total = if column && first && first.class.respond_to?(:descends_from_active_record?)
+          sum(column)
+        else
+          sum
+        end
+        (length > 0) ? total / length : 0
       end
       alias :avg  :mean
       alias :average  :mean
@@ -84,6 +88,25 @@ module ArResultCalculations
       end
       alias :trend :slope
       
+      # Return the variance of a column from an active record result set (or self)
+      # 
+      #  column:  The column name to regress
+      def sample_variance(column = nil)
+        data = column ? map(&column.to_sym) : self
+        return nil unless data.first
+        avg = data.average
+        sum = data.inject(0) {|acc, i| acc + (i - avg)**2 }
+        1 / data.length.to_f * sum
+      end
+
+      # Return the standard deviation of a column in an active record result set (or self)
+      #
+      #  column:  The column of which you want the standard deviation
+      def standard_deviation(column = nil)
+        return nil unless variance = sample_variance(column)
+        Math.sqrt(variance)
+      end
+      
       # Force a column to be numeric.  Useful if you have derived
       # columns from a query that is not part of the base model.
       # 

data/lib/ar_result_calculations/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ar_result_calculations
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Kip Cole
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-30 00:00:00 +08:00
+date: 2010-12-02 00:00:00 +08:00
 default_executable: 
 dependencies: []
 
@@ -30,6 +30,7 @@ extra_rdoc_files: []
 
 files: 
 - .gitignore
+- CHANGELOG
 - Gemfile
 - MIT-LICENSE
 - README.textile