statistics.rb 0.5.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d48404847c10c54ef090f41c5dc470e3ca6409ab07918828b6181e54836bc22b
-  data.tar.gz: 42f80e662e6834081f993c168e96e75451be5a83106bbe8ebe0a2260a47f84c1
+  metadata.gz: 9db0156fb926432eb2d48821c410a0badec96b32dacd485893b0bdf8e7b25cb5
+  data.tar.gz: 77ac6c90e08b0017d1f66ad427ed0c5f0560ef1732fa79627bb0a2160eea292e
 SHA512:
-  metadata.gz: eca8442077f05a25a936475b44c5d6cc75b6a1f009ec1ec15e4803d4b43727c554b4036a1c3ae44e674acacb4c5c0d4605aca24783998cdd13962a86bca887f5
-  data.tar.gz: 14e9b21b4db384c2bd01bed96d7889c88949fb45a1e2c352df721d9af974ff1daf91e020bcac211b6f94639aafd3d63a16ac3d9a0d27f38f65ce87ade157cefd
+  metadata.gz: 43cf596e2166e2cd345528dd6aae8aaadcf78e9bfe62cfe5f28903729bca2ae60a9b142796ab6ab699da57754b27480c4b7c07dae81c37f569f244064daa05f1
+  data.tar.gz: e0f26dd100a0741855f46b466b5c9c28a673f386c674a65feafe2cf5793f7353d4791dc54e1e4f1c95f2200724caefcbcc7901b71a830743f7cb97f653ba3692

data/CHANGELOG.md

@@ -0,0 +1,117 @@
+# CHANGELOG
+
+## [0.6.1] - 20260513
+## Statistics::Histogram::Bin --> Statistics::Bin
+
+1. lib/Statistics/Histogram/Bin.rb --> lib/Statistics/Bin.rb
+2. test/Statistics/Histogram/Bin\_test.rb --> test/Statistics/Bin\_test.rb
+3. ~ lib/Statistics/Histogram.rb: /require\_relative './Histogram/Bin'/require\_relative './Bin'/
+4. ~ lib/statistics.rb: + require\_relative './Statistics/Bin'
+5. ~ .gitignore: Add standard contents.
+6. ~ README.md: + Contributions section
+7. ~ lib/Statistics/VERSION.rb: /0.6.0/0.6.1/
+
+## [0.6.0] - 20260504
+## + Percentile, StandardDeviation, IQR
+
+1. + lib/Statistics/Percentile.rb
+2. + lib/Statistics/StandardDeviation.rb
+3. + lib/Statistics/IQR.rb
+4. + test/Statistics/Percentile\_test.rb
+5. + test/Statistics/StandardDeviation\_test.rb
+6. + test/Statistics/IQR\_test.rb
+7. - Gemfile: As there are no dependencies it isn't doing anything!
+8. ~ statistics.rb.gemspec: dependencies=() also therefore not used.
+9. /CHANGELOG/CHANGELOG.md/
+
+
+## [0.5.0] - 20260503
+## + Bin.bin\_for\_value, Bin split, gem scaffolding.
+
+1. + Bin.bin\_for\_value (wraps index\_for\_value, now private)
+2. ~ Histogram#allocate\_values: Use Bin.bin\_for\_value
+3. ~ Bin split out to lib/Statistics/Histogram/Bin.rb
+4. + lib/statistics.rb
+5. + lib/Statistics/VERSION.rb
+6. + statistics.rb.gemspec
+7. + Gemfile
+8. + Rakefile
+9. + README.md
+10. + LICENSE
+11. + test/Statistics/Histogram\_test.rb
+12. + test/Statistics/Histogram/Bin\_test.rb
+
+
+## [0.4.0] - 20260502
+## + Bin instances; consolidated class methods.
+
+1. + Bin instances (count-tracking via increment, attr\_reader :interval)
+2. ~ Bin.width: handles bin\_width, bin\_count, zero-range, and method selection
+3. + Bin.boundaries (from 0.3.0)
+4. + Bin.index\_for\_value (was Histogram#index\_for\_value)
+5. + Bin.data\_range
+6. ~ class << self for class methods with private boundary
+7. ~ attr\_reader :count replaces hand-written method
+
+
+## [0.3.0] - 20260417
+## Hash-based bins; Bin as class-methods-only.
+
+1. + Bin.boundaries class method
+2. ~ initialize: delegates to Bin.width and Bin.boundaries
+3. ~ Bin: hash-based bins (no Bin instances), Bin is class-methods-only
+4. - index\_for\_value (inlined back into allocate\_values)
+5. - determine\_bin\_width (replaced by Bin.width delegation)
+6. - zero-range guard
+
+
+## [0.2.0] - 20260417
+## Swap storing values per bin for counting per bin; interval; zero-range guard.
+
+1. ~ Bin: count-tracking via increment instead of storing values in array
+2. ~ Bin: attr\_reader :interval instead of :range
+3. + Bin#empty? checks @count == 0 instead of @values.empty?
+4. + determine\_bin\_width: zero-range guard
+5. + index\_for\_value extracted from allocate\_values
+
+
+## [0.1.1] - 20260417
+## + Statistics::Histogram#determine\_bin\_width
+
+1. ~ initialize: extracted determine\_bin\_width from one-liner
+2. /compute\_boundaries/calculate\_boundaries/
+
+
+## [0.1.0] - 20260417
+## + Statistics::Histogram::Bin
+
+1. + Statistics::Histogram::Bin
+2. ~ allocate\_values: creates Bin instances instead of hash entries
+
+
+## [0.0.0] - 20260417
+## + Statistics::Histogram
+
+1. + lib/Statistics/Histogram.rb
+2. - lib/BinWidth.rb
+
+
+## [pre-0.0.0] - 20260416
+## ~ BinWidth: Reintroduce binning strategies; extra guard clauses.
+
+1. Reintroduce all named strategies.
+2. /0.1.0/0.2.0/
+
+
+## [pre-0.0.0] - 20260416
+## + BinWidth#tuneable_root
+
+1. + tuneable\_root as the general form
+2. ~ square\_root rewritten as range * n^(-1/2) form
+3. /0.0.0/0.1.0/
+
+
+## [pre-0.0.0] - 20260416
+## + BinWidth
+
+1. + lib/BinWidth.rb

data/README.md

@@ -68,13 +68,47 @@ h.bins.first.width     # => 2.57
 h.bins.first.empty?    # => false
 ```
 
+### Percentile
+
+These methods employ linear interpolation. See Hyndman and Fan method 7.
+
+```ruby
+require 'statistics.rb'
+
+values = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+
+Statistics::Percentile.of(values, 75)   # => 7.75
+Statistics::Percentile.q25(values)      # => 3.25
+Statistics::Percentile.q75(values)      # => 7.75
+```
+
+### Standard Deviation
+
+```ruby
+Statistics::StandardDeviation.of(values)                # => population (default)
+Statistics::StandardDeviation.of(values, sample: true)  # => sample (Bessel's correction)
+```
+
+### Interquartile Range
+
+```ruby
+Statistics::IQR.of(values)  # => 4.5
+```
+
 ## Roadmap
 
 - Optional per-bin value storage
 - Additional bin width methods (Freedman-Diaconis, Scott, Sturges, cube root, tuneable root)
-- Composable statistical primitives (Percentile, StandardDeviation, IQR)
 - Aligned/neat bin boundaries
 
+## Contributing
+
+1. Fork it [https://github.com/thoran/statistics/fork](https://github.com/thoran/statistics/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new pull request
+
 ## License
 
 MIT

data/lib/Statistics/Bin.rb

@@ -0,0 +1,74 @@
+# Statistics/Bin.rb
+# Statistics::Bin
+
+module Statistics
+  class Bin
+    class << self
+      def width(values, bin_width: nil, bin_count: nil, method: :square_root)
+        if bin_width
+          bin_width
+        elsif bin_count
+          data_range(values) / bin_count.to_f
+        elsif data_range(values) == 0
+          1.0
+        else
+          send("#{method}_width", values)
+        end
+      end
+
+      def count(values, method: :square_root)
+        send("#{method}_count", values)
+      end
+
+      def data_range(values)
+        values.last - values.first
+      end
+
+      def boundaries(values, bin_width: nil, bin_count: nil, method: :square_root)
+        w = bin_width || width(values, bin_count: bin_count, method: method)
+        values.first.step(to: values.last + w, by: w).to_a
+      end
+
+      def bin_for_value(value, bins, bottom_boundary, bin_width)
+        index = index_for_value(value, bins.count, bottom_boundary, bin_width)
+        bins[index]
+      end
+
+      private
+
+      def index_for_value(value, bin_count, bottom_boundary, bin_width)
+        i = ((value - bottom_boundary) / bin_width).floor
+        i >= bin_count ? bin_count - 1 : i
+      end
+
+      def square_root_width(values)
+        data_range(values) * values.size ** (-1.0 / 2)
+      end
+
+      def square_root_count(values)
+        Math.sqrt(values.size).ceil
+      end
+    end # class << self
+
+    attr_reader :count, :interval
+
+    def increment
+      @count += 1
+    end
+
+    def width
+      @interval.end - @interval.begin
+    end
+
+    def empty?
+      @count == 0
+    end
+
+    private
+
+    def initialize(interval)
+      @interval = interval
+      @count = 0
+    end
+  end
+end

data/lib/Statistics/Histogram.rb

@@ -1,7 +1,7 @@
 # Statistics/Histogram.rb
 # Statistics::Histogram
 
-require_relative './Histogram/Bin'
+require_relative './Bin'
 
 module Statistics
   class Histogram

data/lib/Statistics/IQR.rb

@@ -0,0 +1,14 @@
+# Statistics/IQR.rb
+# Statistics::IQR
+
+require_relative './Percentile'
+
+module Statistics
+  module IQR
+    module_function
+
+    def of(values)
+      Percentile.q75(values) - Percentile.q25(values)
+    end
+  end
+end

data/lib/Statistics/Percentile.rb

@@ -0,0 +1,26 @@
+# Statistics/Percentile.rb
+# Statistics::Percentile
+
+# These methods employ linear interpolation. See Hyndman and Fan method 7.
+
+module Statistics
+  module Percentile
+    module_function
+
+    def of(values, p)
+      sorted = values.map(&:to_f).sort
+      k = (p / 100.0) * (sorted.size - 1)
+      lower = sorted[k.floor]
+      upper = sorted[k.ceil]
+      lower + (upper - lower) * (k - k.floor)
+    end
+
+    def q25(values)
+      of(values, 25)
+    end
+
+    def q75(values)
+      of(values, 75)
+    end
+  end
+end

data/lib/Statistics/StandardDeviation.rb

@@ -0,0 +1,16 @@
+# Statistics/StandardDeviation.rb
+# Statistics::StandardDeviation
+
+module Statistics
+  module StandardDeviation
+    module_function
+
+    def of(values, sample: false)
+      floats = values.map(&:to_f)
+      mean = floats.sum / floats.size
+      denominator = sample ? floats.size - 1 : floats.size
+      variance = floats.map{|v| (v - mean) ** 2}.sum / denominator
+      Math.sqrt(variance)
+    end
+  end
+end

data/lib/Statistics/VERSION.rb

@@ -2,5 +2,5 @@
 # Statistics::VERSION
 
 module Statistics
-  VERSION = '0.5.0'
+  VERSION = '0.6.1'
 end

data/lib/statistics.rb

@@ -1,4 +1,8 @@
 # statistics.rb
 
-require_relative './Statistics/VERSION'
+require_relative './Statistics/Bin'
 require_relative './Statistics/Histogram'
+require_relative './Statistics/IQR'
+require_relative './Statistics/Percentile'
+require_relative './Statistics/StandardDeviation'
+require_relative './Statistics/VERSION'

data/statistics.rb.gemspec

@@ -1,10 +1,6 @@
 require_relative './lib/Statistics/VERSION'
 
 class Gem::Specification
-  def dependencies=(gems)
-    gems.each{|gem| add_dependency(*gem)}
-  end
-
   def development_dependencies=(gems)
     gems.each{|gem| add_development_dependency(*gem)}
   end
@@ -12,12 +8,10 @@ end
 
 Gem::Specification.new do |spec|
   spec.name = 'statistics.rb'
-
   spec.version = Statistics::VERSION
-  spec.date = '2026-05-03'
 
   spec.summary = "A statistics library for Ruby."
-  spec.description = "A composable statistics library for Ruby. Histogram with automatic bin width calculation and composable Bin class."
+  spec.description = "A composable statistics library for Ruby. Histogram, Percentile, StandardDeviation, IQR."
 
   spec.author = 'thoran'
   spec.email = 'code@thoran.com'
@@ -29,8 +23,7 @@ Gem::Specification.new do |spec|
   spec.files = [
     Dir['lib/**/*.rb'],
     Dir['test/**/*.rb'],
-    'CHANGELOG',
-    'Gemfile',
+    'CHANGELOG.md',
     'LICENSE',
     'Rakefile',
     'README.md',

data/test/Statistics/{Histogram/Bin_test.rb → Bin_test.rb}

@@ -1,33 +1,33 @@
-# test/Statistics/Histogram/Bin_test.rb
+# test/Statistics/Bin_test.rb
 
 require 'minitest/autorun'
 
-require_relative '../../../lib/Statistics/Histogram/Bin'
+require_relative '../../lib/Statistics/Bin'
 
-describe Statistics::Histogram::Bin do
+describe Statistics::Bin do
   describe '.width' do
     it 'calculates square root width by default' do
       values = (1..100).to_a.map(&:to_f)
-      width = Statistics::Histogram::Bin.width(values)
+      width = Statistics::Bin.width(values)
       expected = (values.last - values.first) * values.size ** (-1.0 / 2)
       _(width).must_be_close_to expected
     end
 
     it 'returns explicit bin_width when provided' do
       values = (1..100).to_a.map(&:to_f)
-      width = Statistics::Histogram::Bin.width(values, bin_width: 7.5)
+      width = Statistics::Bin.width(values, bin_width: 7.5)
       _(width).must_equal 7.5
     end
 
     it 'calculates width from bin_count when provided' do
       values = (1..100).to_a.map(&:to_f)
-      width = Statistics::Histogram::Bin.width(values, bin_count: 10)
+      width = Statistics::Bin.width(values, bin_count: 10)
       _(width).must_be_close_to 9.9
     end
 
     it 'returns 1.0 for zero-range data' do
       values = [5.0, 5.0, 5.0]
-      width = Statistics::Histogram::Bin.width(values)
+      width = Statistics::Bin.width(values)
       _(width).must_equal 1.0
     end
   end
@@ -35,13 +35,13 @@ describe Statistics::Histogram::Bin do
   describe '.boundaries' do
     it 'returns an array starting at the minimum value' do
       values = (1..10).to_a.map(&:to_f)
-      boundaries = Statistics::Histogram::Bin.boundaries(values, bin_width: 3.0)
+      boundaries = Statistics::Bin.boundaries(values, bin_width: 3.0)
       _(boundaries.first).must_equal 1.0
     end
 
     it 'extends past the maximum value' do
       values = (1..10).to_a.map(&:to_f)
-      boundaries = Statistics::Histogram::Bin.boundaries(values, bin_width: 3.0)
+      boundaries = Statistics::Bin.boundaries(values, bin_width: 3.0)
       _(boundaries.last).must_be :>=, 10.0
     end
   end
@@ -49,24 +49,24 @@ describe Statistics::Histogram::Bin do
   describe '.bin_for_value' do
     it 'returns the correct bin' do
       bins = [5.0, 10.0, 15.0, 20.0].each_cons(2).map do |lower, upper|
-        Statistics::Histogram::Bin.new(lower...upper)
+        Statistics::Bin.new(lower...upper)
       end
-      bin = Statistics::Histogram::Bin.bin_for_value(7.0, bins, 5.0, 5.0)
+      bin = Statistics::Bin.bin_for_value(7.0, bins, 5.0, 5.0)
       _(bin.interval).must_equal(5.0...10.0)
     end
 
     it 'clamps to the last bin for values at the upper boundary' do
       bins = [5.0, 10.0, 15.0].each_cons(2).map do |lower, upper|
-        Statistics::Histogram::Bin.new(lower...upper)
+        Statistics::Bin.new(lower...upper)
       end
-      bin = Statistics::Histogram::Bin.bin_for_value(15.0, bins, 5.0, 5.0)
+      bin = Statistics::Bin.bin_for_value(15.0, bins, 5.0, 5.0)
       _(bin.interval).must_equal(10.0...15.0)
     end
   end
 
   describe 'instance methods' do
     before do
-      @bin = Statistics::Histogram::Bin.new(1.0...5.0)
+      @bin = Statistics::Bin.new(1.0...5.0)
     end
 
     it 'starts with count of zero' do

data/test/Statistics/IQR_test.rb

@@ -0,0 +1,30 @@
+# test/Statistics/IQR_test.rb
+
+require 'minitest/autorun'
+
+require_relative '../../lib/Statistics/IQR'
+
+describe Statistics::IQR do
+  describe '.of' do
+    it 'returns the difference between q75 and q25' do
+      values = [1, 2, 3, 4, 5]
+      expected = Statistics::Percentile.q75(values) - Statistics::Percentile.q25(values)
+      _(Statistics::IQR.of(values)).must_equal expected
+    end
+
+    it 'returns zero for identical values' do
+      _(Statistics::IQR.of([5, 5, 5, 5])).must_equal 0.0
+    end
+
+    it 'handles a two-value dataset' do
+      values = [10, 20]
+      _(Statistics::IQR.of(values)).must_be_close_to 5.0
+    end
+
+    it 'handles unsorted input' do
+      sorted = [1, 2, 3, 4, 5, 6, 7, 8]
+      shuffled = [5, 1, 8, 3, 7, 2, 6, 4]
+      _(Statistics::IQR.of(shuffled)).must_equal Statistics::IQR.of(sorted)
+    end
+  end
+end

data/test/Statistics/Percentile_test.rb

@@ -0,0 +1,52 @@
+# test/Statistics/Percentile_test.rb
+
+require 'minitest/autorun'
+
+require_relative '../../lib/Statistics/Percentile'
+
+describe Statistics::Percentile do
+  describe '.of' do
+    it 'returns the minimum for the 0th percentile' do
+      values = [1, 2, 3, 4, 5]
+      _(Statistics::Percentile.of(values, 0)).must_equal 1.0
+    end
+
+    it 'returns the maximum for the 100th percentile' do
+      values = [1, 2, 3, 4, 5]
+      _(Statistics::Percentile.of(values, 100)).must_equal 5.0
+    end
+
+    it 'returns the median for the 50th percentile' do
+      values = [1, 2, 3, 4, 5]
+      _(Statistics::Percentile.of(values, 50)).must_equal 3.0
+    end
+
+    it 'interpolates between values' do
+      values = [10, 20, 30, 40]
+      _(Statistics::Percentile.of(values, 25)).must_equal 17.5
+    end
+
+    it 'handles a single value' do
+      _(Statistics::Percentile.of([42], 50)).must_equal 42.0
+    end
+
+    it 'handles unsorted input' do
+      values = [5, 1, 3, 2, 4]
+      _(Statistics::Percentile.of(values, 50)).must_equal 3.0
+    end
+  end
+
+  describe '.q25' do
+    it 'returns the 25th percentile' do
+      values = [1, 2, 3, 4, 5]
+      _(Statistics::Percentile.q25(values)).must_equal Statistics::Percentile.of(values, 25)
+    end
+  end
+
+  describe '.q75' do
+    it 'returns the 75th percentile' do
+      values = [1, 2, 3, 4, 5]
+      _(Statistics::Percentile.q75(values)).must_equal Statistics::Percentile.of(values, 75)
+    end
+  end
+end

data/test/Statistics/StandardDeviation_test.rb

@@ -0,0 +1,34 @@
+# test/Statistics/StandardDeviation_test.rb
+
+require 'minitest/autorun'
+
+require_relative '../../lib/Statistics/StandardDeviation'
+
+describe Statistics::StandardDeviation do
+  describe '.of' do
+    it 'returns zero for identical values' do
+      _(Statistics::StandardDeviation.of([5, 5, 5, 5])).must_equal 0.0
+    end
+
+    it 'calculates population standard deviation by default' do
+      values = [2, 4, 4, 4, 5, 5, 7, 9]
+      _(Statistics::StandardDeviation.of(values)).must_be_close_to 2.0
+    end
+
+    it 'calculates sample standard deviation when requested' do
+      values = [2, 4, 4, 4, 5, 5, 7, 9]
+      sample_sd = Statistics::StandardDeviation.of(values, sample: true)
+      population_sd = Statistics::StandardDeviation.of(values)
+      _(sample_sd).must_be :>, population_sd
+    end
+
+    it 'handles a single value' do
+      _(Statistics::StandardDeviation.of([42])).must_equal 0.0
+    end
+
+    it 'handles two values' do
+      values = [0, 10]
+      _(Statistics::StandardDeviation.of(values)).must_be_close_to 5.0
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: statistics.rb
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.1
 platform: ruby
 authors:
 - thoran
 bindir: bin
 cert_chain: []
-date: 2026-05-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -37,25 +37,30 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: A composable statistics library for Ruby. Histogram with automatic bin
-  width calculation and composable Bin class.
+description: A composable statistics library for Ruby. Histogram, Percentile, StandardDeviation,
+  IQR.
 email: code@thoran.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG
-- Gemfile
+- CHANGELOG.md
 - LICENSE
 - README.md
 - Rakefile
+- lib/Statistics/Bin.rb
 - lib/Statistics/Histogram.rb
-- lib/Statistics/Histogram/Bin.rb
+- lib/Statistics/IQR.rb
+- lib/Statistics/Percentile.rb
+- lib/Statistics/StandardDeviation.rb
 - lib/Statistics/VERSION.rb
 - lib/statistics.rb
 - statistics.rb.gemspec
-- test/Statistics/Histogram/Bin_test.rb
+- test/Statistics/Bin_test.rb
 - test/Statistics/Histogram_test.rb
+- test/Statistics/IQR_test.rb
+- test/Statistics/Percentile_test.rb
+- test/Statistics/StandardDeviation_test.rb
 homepage: http://github.com/thoran/statistics
 licenses:
 - MIT
@@ -74,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.11
 specification_version: 4
 summary: A statistics library for Ruby.
 test_files: []

data/CHANGELOG

@@ -1,92 +0,0 @@
-# CHANGELOG
-
-## [0.5.0] - 20260503
-## Bin.bin_for_value, Bin split, gem scaffolding
-
-1. + Bin.bin_for_value (wraps index_for_value, now private)
-2. ~ Histogram#allocate_values: Use Bin.bin_for_value
-3. ~ Bin split out to lib/Statistics/Histogram/Bin.rb
-4. + lib/statistics.rb
-5. + lib/Statistics/VERSION.rb
-6. + statistics.rb.gemspec
-7. + Gemfile
-8. + Rakefile
-9. + README.md
-10. + LICENSE
-11. + test/Statistics/Histogram_test.rb
-12. + test/Statistics/Histogram/Bin_test.rb
-
-
-## [0.4.0] - 20260502
-## Bin instances and consolidated class methods
-
-1. + Bin instances (count-tracking via increment, attr_reader :interval)
-2. ~ Bin.width: handles bin_width, bin_count, zero-range, and method selection
-3. + Bin.boundaries (from 0.3.0)
-4. + Bin.index_for_value (was Histogram#index_for_value)
-5. + Bin.data_range
-6. ~ class << self for class methods with private boundary
-7. ~ attr_reader :count replaces hand-written method
-
-
-## [0.3.0] - 20260417
-## Hash-based bins, Bin as class-methods-only
-
-1. + Bin.boundaries class method
-2. ~ initialize: delegates to Bin.width and Bin.boundaries
-3. ~ Bin: hash-based bins (no Bin instances), Bin is class-methods-only
-4. - index_for_value (inlined back into allocate_values)
-5. - determine_bin_width (replaced by Bin.width delegation)
-6. - zero-range guard
-
-
-## [0.2.0] - 20260417
-## Count-tracking, interval, zero-range guard
-
-1. ~ Bin: count-tracking via increment instead of storing values in array
-2. ~ Bin: attr_reader :interval instead of :range
-3. + Bin#empty? checks @count == 0 instead of @values.empty?
-4. + determine_bin_width: zero-range guard
-5. + index_for_value extracted from allocate_values
-
-
-## [0.1.1] - 20260417
-## Extract determine_bin_width
-
-1. ~ initialize: extracted determine_bin_width from one-liner
-2. /compute_boundaries/calculate_boundaries/
-
-
-## [0.1.0] - 20260417
-## Bin class
-
-1. + Statistics::Histogram::Bin
-2. ~ allocate_values: creates Bin instances instead of hash entries
-
-
-## [0.0.0] - 20260417
-## Statistics::Histogram
-
-1. + lib/Statistics/Histogram.rb
-2. - lib/BinWidth.rb
-
-
-## 20260416
-## BinWidth 0.1.0 to 0.2.0: Reintroduce all named strategies
-
-1. /0.1.0/0.2.0/
-2. Reintroduce all named strategies.
-
-
-## 20260416
-## BinWidth 0.0.0 to 0.1.0: Tuneable root generalisation
-
-1. /0.0.0/0.1.0/
-2. + tuneable_root as the general form
-3. ~ square_root rewritten as range * n^(-1/2) form
-
-
-## 20260416
-## BinWidth 0.0.0
-
-1. + lib/BinWidth.rb

data/Gemfile

@@ -1,3 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec

data/lib/Statistics/Histogram/Bin.rb

@@ -1,76 +0,0 @@
-# Statistics/Histogram/Bin.rb
-# Statistics::Histogram::Bin
-
-module Statistics
-  class Histogram
-    class Bin
-      class << self
-        def width(values, bin_width: nil, bin_count: nil, method: :square_root)
-          if bin_width
-            bin_width
-          elsif bin_count
-            data_range(values) / bin_count.to_f
-          elsif data_range(values) == 0
-            1.0
-          else
-            send("#{method}_width", values)
-          end
-        end
-
-        def count(values, method: :square_root)
-          send("#{method}_count", values)
-        end
-
-        def data_range(values)
-          values.last - values.first
-        end
-
-        def boundaries(values, bin_width: nil, bin_count: nil, method: :square_root)
-          w = bin_width || width(values, bin_count: bin_count, method: method)
-          values.first.step(to: values.last + w, by: w).to_a
-        end
-
-        def bin_for_value(value, bins, bottom_boundary, bin_width)
-          index = index_for_value(value, bins.count, bottom_boundary, bin_width)
-          bins[index]
-        end
-
-        private
-
-        def index_for_value(value, bin_count, bottom_boundary, bin_width)
-          i = ((value - bottom_boundary) / bin_width).floor
-          i >= bin_count ? bin_count - 1 : i
-        end
-
-        def square_root_width(values)
-          data_range(values) * values.size ** (-1.0 / 2)
-        end
-
-        def square_root_count(values)
-          Math.sqrt(values.size).ceil
-        end
-      end # class << self
-
-      attr_reader :count, :interval
-
-      def increment
-        @count += 1
-      end
-
-      def width
-        @interval.end - @interval.begin
-      end
-
-      def empty?
-        @count == 0
-      end
-
-      private
-
-      def initialize(interval)
-        @interval = interval
-        @count = 0
-      end
-    end
-  end
-end