descriptive-statistics 1.0.0 → 1.1.0

data/README.md

@@ -44,6 +44,12 @@ stats.variance #=> 14.299999999999999
 stats.standard_deviation #=> 3.7815340802378072
 ```
 
+### Other Measures:
+```ruby
+stats = DescriptiveStatistics.new([1,1,2,3,10]).skewness #=> 1.188328915820243
+stats = DescriptiveStatistics.new([1,1,2,3,10]).kurtosis #=> 2.405613966453127
+```
+
 ## Contributing
 
 1. Fork it

data/lib/descriptive-statistics.rb

@@ -2,16 +2,18 @@ require "descriptive-statistics/version"
 require 'descriptive-statistics/central-tendency'
 require 'descriptive-statistics/dispersion'
 require 'descriptive-statistics/spread'
+require 'descriptive-statistics/shape'
 
 class DescriptiveStatistics
   extend Forwardable
   include CentralTendency
   include Dispersion
   include Spread
+  include Shape
 
   def initialize(data)
     @data = data
   end
 
-  def_delegators :@data, :length, :inject, :sort, :each_with_object
+  def_delegators :@data, :length, :inject, :sort, :each, :each_with_object
 end

data/lib/descriptive-statistics/shape.rb

@@ -0,0 +1,17 @@
+class DescriptiveStatistics
+  module Shape
+    def skewness
+      return if length < 1
+      sum_cubed_deviation = inject(0) {|sum, value| sum + (value - mean) ** 3}
+      cubed_standard_deviation = standard_deviation ** 3
+      sum_cubed_deviation / ((length - 1) * cubed_standard_deviation.to_f)
+    end
+
+    def kurtosis
+      return if length < 1
+      sum_quarted_deviation = inject(0) {|sum, value| sum + (value - mean) ** 4}
+      quarted_standard_deviation = standard_deviation ** 4
+      sum_quarted_deviation / ((length - 1) * quarted_standard_deviation.to_f)
+    end
+  end
+end

data/lib/descriptive-statistics/version.rb

@@ -1,5 +1,5 @@
 module Descriptive
   module Statistics
-    VERSION = "1.0.0"
+    VERSION = "1.1.0"
   end
 end

data/spec/lib/descriptive-statistics/shape_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe DescriptiveStatistics::Shape do
+  describe '#skewness' do
+    it 'returns the measure of skewness of the data as close to 0 when not skewed' do
+      DescriptiveStatistics.new([1,3,5,3,1]).skewness.should == 0.30734449954312965
+    end
+
+    it 'returns the measure of skewness of the data as high when skewed' do
+      DescriptiveStatistics.new([50,10,1,1,1]).skewness.should == 1.2374536958450908
+    end
+
+    it 'returns nil if empty' do
+      DescriptiveStatistics.new([]).skewness.should be_nil
+    end
+  end
+
+  describe '#kurtosis' do
+    it 'returns the measure of kurtosis of the data as close to 0 when not skewed' do
+      DescriptiveStatistics.new([1,3,5,3,1]).kurtosis.should == 1.477551020408163
+    end
+
+    it 'returns the measure of skewness of the data as high when skewed' do
+      DescriptiveStatistics.new([50,10,1,1,1]).kurtosis.should == 2.45740139974872
+    end
+
+    it 'returns nil if empty' do
+      DescriptiveStatistics.new([]).kurtosis.should be_nil
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: descriptive-statistics
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -60,10 +60,12 @@ files:
 - lib/descriptive-statistics.rb
 - lib/descriptive-statistics/central-tendency.rb
 - lib/descriptive-statistics/dispersion.rb
+- lib/descriptive-statistics/shape.rb
 - lib/descriptive-statistics/spread.rb
 - lib/descriptive-statistics/version.rb
 - spec/lib/descriptive-statistics/central_tendency_spec.rb
 - spec/lib/descriptive-statistics/dispersion_spec.rb
+- spec/lib/descriptive-statistics/shape_spec.rb
 - spec/lib/descriptive-statistics/spread_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/jtescher/descriptive-statistics
@@ -80,7 +82,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2781553124124914132
+      hash: -3386825229431147433
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -89,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2781553124124914132
+      hash: -3386825229431147433
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -100,5 +102,6 @@ summary: Simply calculate measures of central tendency (e.g. mean, median mode),
 test_files:
 - spec/lib/descriptive-statistics/central_tendency_spec.rb
 - spec/lib/descriptive-statistics/dispersion_spec.rb
+- spec/lib/descriptive-statistics/shape_spec.rb
 - spec/lib/descriptive-statistics/spread_spec.rb
 - spec/spec_helper.rb