statistics.rb 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d48404847c10c54ef090f41c5dc470e3ca6409ab07918828b6181e54836bc22b
-  data.tar.gz: 42f80e662e6834081f993c168e96e75451be5a83106bbe8ebe0a2260a47f84c1
+  metadata.gz: ca6c39ebb723322893b28fc4cc9310e4004120ae20faa3be0aa502df6bae0d1b
+  data.tar.gz: aad65236bd96a97805c7d0cce74e2c922d34e07ee6c95e3ebc3848a6c9eb92b0
 SHA512:
-  metadata.gz: eca8442077f05a25a936475b44c5d6cc75b6a1f009ec1ec15e4803d4b43727c554b4036a1c3ae44e674acacb4c5c0d4605aca24783998cdd13962a86bca887f5
-  data.tar.gz: 14e9b21b4db384c2bd01bed96d7889c88949fb45a1e2c352df721d9af974ff1daf91e020bcac211b6f94639aafd3d63a16ac3d9a0d27f38f65ce87ade157cefd
+  metadata.gz: 16f2c79aa61f53f1b7d6ef30d61e54ad2dde96e541056651c165e8955270c8e77290fc9f50e5a7bb752dc97ed3c87da715e0ec55950a352b45d9cb0ed5481780
+  data.tar.gz: 4f0129b9ed5fcd74ff7a3940f3e4b578b7d586221b2a514354425a0c6fef2fcf8dfd5b5d8c6992deef0c73b4872805c356e46b3c387cea5e0ca995577dfaadb2

data/CHANGELOG.md

@@ -0,0 +1,106 @@
+# CHANGELOG
+
+## [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 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/README.md

@@ -68,11 +68,37 @@ 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
 
 ## License

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.0'
 end

data/lib/statistics.rb

@@ -1,4 +1,7 @@
 # statistics.rb
 
-require_relative './Statistics/VERSION'
 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/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.0
 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/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/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

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