davidrichards-just_enumerable_stats 0.0.5 → 0.0.6

data/README.rdoc

@@ -128,6 +128,14 @@ Once I started using this gem with my distribution table classes, I needed to ha
   => 2
   >> a.count_if {|e| e == 3}
   => 1
+  >> a.dichotomize(2, :small, :big)
+  => [:small, :big]
+  >> a.categories
+  => [:small, :big]
+  >> a.category_values[:small]
+  => [1, 2]
+  >> a.category_values[:big]  
+  => [3]
 
 OK, here we go:
 
@@ -139,6 +147,7 @@ OK, here we go:
 * set_range takes an arbitrary hash of lambdas and sets the categories to the keys of that hash.
 * The category_values calculated with a hash of lambdas makes a very flexible set interface for enumerables.  There is no rule that the categories setup this way have to be mutually exclusive or collectively exhaustive (MECE), so interesting data sets can be setup here.  However, MECE is generally a good guideline for most analysis.
 * count_if is just like a.select_all{|e| e < 3}.size, but a little more obvious.
+* dichotomize just splits the categories into two, with the first category less than or equal to the split value provided (2 in our case)
 
 ==Installation
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :major: 0
 :minor: 0
-:patch: 5
+:patch: 6

data/lib/just_enumerable_stats.rb

@@ -270,6 +270,14 @@ module Enumerable
   # The arguments needed to instantiate the custom-defined range class.
   attr_reader :range_class_args
 
+  # Splits the values in two, <= the value and > the value.
+  def dichotomize(split_value, first_label, second_label)
+    set_range({
+      first_label => lambda{|e| e <= split_value},
+      second_label => lambda{|e| e > split_value}
+    })
+  end
+  
   # Counts each element where the block evaluates to true
   # Example:
   # a = [1,2,3]

data/lib/just_enumerable_stats/stats.rb

@@ -257,6 +257,14 @@ module JustEnumerableStats #:nodoc:
     # The arguments needed to instantiate the custom-defined range class.
     attr_reader :range_class_args
 
+    # Splits the values in two, <= the value and > the value.
+    def dichotomize(split_value, first_label, second_label)
+      set_range({
+        first_label => lambda{|e| e <= split_value},
+        second_label => lambda{|e| e > split_value}
+      })
+    end
+
     # Counts each element where the block evaluates to true
     # Example:
     # a = [1,2,3]

data/spec/just_enumerable_stats/stats_spec.rb

@@ -279,6 +279,13 @@ describe JustEnumerableStats::Stats do
     @a.count_if {|e| e == 2}.should eql(1)
   end
   
+  it "should be able to dichotomize a list" do
+    @a.dichotomize(2, :small, :big)
+    @a.categories.should eql([:small, :big])
+    @a.category_values[:small].should eql([1,2])
+    @a.category_values[:big].should eql([3])
+  end
+  
   it "should be able to instantiate a range" do
     @a.range_as_range.should eql(Range.new(1, 3))
   end

data/spec/just_enumerable_stats_spec.rb

@@ -269,6 +269,13 @@ describe "JustEnumerableStats" do
     @a.count_if {|e| e == 2}.should eql(1)
   end
   
+  it "should be able to dichotomize a list" do
+    @a.dichotomize(2, :small, :big)
+    @a.categories.should eql([:small, :big])
+    @a.category_values[:small].should eql([1,2])
+    @a.category_values[:big].should eql([3])
+  end
+  
   it "should be able to instantiate a range with a block" do
     @a.range_as_range(&@inverse_matcher).should eql(Range.new(3, 1))
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: davidrichards-just_enumerable_stats
 version: !ruby/object:Gem::Version 
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors: 
 - David Richards