simple_statistics 0.1

data/README.rdoc

@@ -0,0 +1,64 @@
+= Statistics
+
+Basic statistics including mean, median, weighted moving average and rate of change.
+
+== INSTALL
+
+  gem install simple_statistics
+
+== DEPENDENCIES
+
+None
+
+== USAGE
+
+  require 'simple_statistics'
+
+To calculate mean, median, and weighted moving average:
+
+  [10,20,30,20,25,24,23,22].mean
+  # 21.75
+
+  [10,20,30,20,25,24,23,22].median
+  # 22.5
+
+  [10,20,30,20,25,24,23,22].wma
+  # 23
+
+To calculate the weighted moving average growth of a numeric sequence.....
+
+  [95.5, 95.5, 99.1, 104.7, 121.2].growth.wma.round_to(4)
+  # 1.0875
+
+..to express this as a percent we can write:
+
+  [95.5, 95.5, 99.1, 104.7, 121.2].growth.wma.as_percent(3) 
+  # 8.75%
+
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 Craig Davidson <craig@craigdavidson.co.uk>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+

data/lib/array_of.rb

@@ -0,0 +1,5 @@
+module Enumerable
+  def array_of method_name
+    self.collect {|element| element.method(method_name).call}
+  end
+end

data/lib/average.rb

@@ -0,0 +1,29 @@
+require 'rounding'
+require 'percent'
+
+class Array
+  
+  def mean
+    self.inject(0) { |sum, x| sum += x } / self.size.to_f      
+  end
+  
+  def median already_sorted=false
+    return nil if self.empty?
+    array = self.sort unless already_sorted
+    m_pos = array.size / 2
+    return array.size % 2 == 1 ? array[m_pos] : array[m_pos-1..m_pos].mean
+  end
+  
+  def wma
+    values = self.reverse
+    periodLength = values.length - 1
+    sum = 0; 
+    weightedSum = 0; 
+    for n in 0..periodLength
+        weightedSum = weightedSum + ((periodLength - n) * values[n]);
+        sum = sum + n; 
+    end
+    return weightedSum / sum;    
+  end 
+  
+end

data/lib/percent.rb

@@ -0,0 +1,16 @@
+require 'rounding'
+
+class Object
+
+  def as_percent(rounding = 0)
+    return "#{as_percent_number(rounding)}%" 
+  rescue
+    self
+  end
+  
+  def as_percent_number(rounding = 0)
+    percent = ((self-1.0) * 100).round_to(rounding)
+    rounding == 0 ? percent.to_i : percent
+  end
+  
+end

data/lib/rate_of_change.rb

@@ -0,0 +1,20 @@
+class Array
+  
+  def growth
+    rate_of_change
+  end
+  
+  def rate_of_change
+    previous = nil   
+    result = Array.new
+    self.each{|this| result << multiplier(this,previous) and previous = this}
+    result    
+  rescue
+    self
+  end
+  
+  def multiplier(this, previous)
+    previous != nil && previous != 0 ? (this.to_f/previous.to_f) : 1.0
+  end
+  
+end

data/lib/rounding.rb

@@ -0,0 +1,8 @@
+class Object
+  def round_to(x)
+    return (self * 10**x.to_f).round / 10**x.to_f
+  rescue  
+    self
+  end  
+
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: simple_statistics
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Craig Davidson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-14 00:00:00 +10:00
+default_executable: 
+dependencies: []
+
+description: Basic statistics including mean, median, weighted moving average and growth.
+email: craig@craigdavidson.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- lib/array_of.rb
+- lib/rate_of_change.rb
+- lib/rounding.rb
+- lib/percent.rb
+- lib/average.rb
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Basic statistics including mean, median, weighted moving average and growth.
+test_files: []
+