to_histogram 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 58c176192de9ba9ed43fb91778c36eed19fc1c5d
+  data.tar.gz: d830c2a73ac48d2e5d88f8ffbad6297c76414c58
+SHA512:
+  metadata.gz: af37532d0ffd6715bbc0c4fb02e5692d81861cd5b10e160d8dad1dbaf1c89a2c863a88b9e4f3fe5b7181c9b9b4a1119e480ed15568eda53d490ca16ebcb5ed77
+  data.tar.gz: 86cad0be42831b5693b7559d68aabca95232a2bb0589da4ae0c995a7835ba4659285c383d10afe118e3864c254d9f3136c68ae9a521596ea5146d6ceb2c9cc78

data/lib/bucketizer.rb

@@ -0,0 +1,35 @@
+module ToHistogram
+
+    class Bucketizer
+
+        def create_buckets(array, num_buckets)
+          arr                   = array.sort
+          bucket_increments     = (arr[-1].to_f) / num_buckets  
+          l_index               = 0
+          next_bucket           = bucket_increments
+          buckets               = []
+          
+          arr.each_with_index do |e, i|
+            if !(e <= next_bucket)
+              buckets << arr[l_index..(i - 1)]
+
+              # Special case where all of the results fit into the first bucket
+              if buckets[0].length == arr.length
+                l_index = (arr.length - 1)
+                break
+              end
+
+              l_index = i
+              next_bucket += bucket_increments
+            end
+          end
+
+          if(l_index != (arr.length - 1))
+            buckets << arr[l_index..(arr.length - 1)]
+          end
+
+          return buckets
+        end
+
+    end
+end

data/lib/histogram.rb

@@ -0,0 +1,28 @@
+require_relative './bucketizer'
+
+module ToHistogram
+
+  class Histogram
+    include Enumerable
+
+    def initialize(array, num_buckets)
+      bucketizer  = Bucketizer.new()
+      @buckets    = bucketizer.create_buckets(array, num_buckets)
+    end
+
+    def each(&block)
+      @buckets.each do |b|
+        yield b
+      end
+    end
+
+    def [](i)
+      return @buckets[i]
+    end
+
+    def length
+      return @buckets.length
+    end
+
+  end
+end

data/lib/stdout_print.rb

@@ -0,0 +1,29 @@
+module ToHistogram
+
+  class StdoutPrint
+    def initialize(histogram)
+      @histogram = histogram
+    end
+
+    def invoke
+      last_value = nil
+      total_data_value_length = (@histogram.map { |b| b.length }).reduce(:+)
+      printf("%-20s %-20s %-30s %-20s \n\n", "range", "frequency", "  percentage (out of #{total_data_value_length})", "histogram (percetage)")
+      
+      @histogram.each do |b|
+        range       = last_value.nil? ? "#{b[0]} to #{b[-1]}" : "#{last_value + 1} to #{b[-1]}"
+        frequency   = b.length
+        percentage  = ((frequency.to_f / total_data_value_length) * 100)
+        stars       = ''
+        percentage.round.times { |x| stars << '*' }
+
+        printf("%-20s | %-20s | %-30s | %-20s \n", range, frequency, ('%.4f' % percentage), stars)
+        last_value = b[-1]
+      end
+
+      puts "\n\n"
+      return nil
+    end
+
+  end
+end

data/lib/to_histogram.rb

@@ -0,0 +1,13 @@
+require_relative './histogram'
+require_relative './stdout_print'
+
+class Array
+  def to_histogram(num_buckets: 10)
+    histogram       = ToHistogram::Histogram.new(self, num_buckets)    
+    stdout_print    = ToHistogram::StdoutPrint.new(histogram)
+
+    stdout_print.invoke
+
+    return histogram
+  end
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: to_histogram
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Brett Sykes
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-02 00:00:00.000000000 Z
+dependencies: []
+description: Creates a simple histogram output on the command line. Usefull in IRB
+  sessions and command line programs
+email: brettcsykes@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bucketizer.rb
+- lib/histogram.rb
+- lib/stdout_print.rb
+- lib/to_histogram.rb
+homepage: https://github.com/bretts/to_histogram
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Creates a simple histogram output on the command line
+test_files: []