philiprehberger-math_kit 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a73db6abf0e0f987688786bd18c0b959182dc5290c52ac52e04a55926361436e
-  data.tar.gz: 85c7d136bf63030f7009b736aa0d44c81429e383973bb8bd65ca58f0aa08c927
+  metadata.gz: 749c0a9a1c673c58a1ba320d3bbf2dacf89328a3feedb166d76ef18dcca60284
+  data.tar.gz: 5698fb8599aa8343585a5cd64cd5b95bce81b6fb919a688aa7435af9a60882ae
 SHA512:
-  metadata.gz: 63bbbb1ca5f8c31f476dbb87f9df33569a4cdd420e49b736f2a5289c5f7e3839cff4cc3353af2c8db87f5bf909feb7b7047088e29167ea36d7318752c271848c
-  data.tar.gz: 183f0a9fec1904a98d37520df268f260e7f6e4dd9e32403fc5ce1ef3e3fdf1d346947d1751e757a4d81de0eae73cd215b393c19faa82a3b7510d7ff4b23d6c9a
+  metadata.gz: 8019d5ee6e9f7e78cb2609f830d944f164aa77a333b49abadd6e75d4c62e3ba100f022f7c2212648bff3ac1d4ac362f6ec1cd575acad39164992727cb6aa2f44
+  data.tar.gz: 392bb7e9c895353d838582f5d80467d8edd3f46ecc9f0bb98c854079106dedcfd5c38f79e03646371f05b08cb847799d92f8041bba05c088374ea6664ab255d9

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-05-07
+
+### Added
+- `Stats.iqr(values)` — interquartile range (Q3 - Q1), commonly used for outlier detection.
+
+## [0.5.0] - 2026-04-21
+
+### Added
+- `Stats.sum_of_squares(values)` — sum of squared deviations from the mean, a building block for variance, regression residuals, and ANOVA; returns 0.0 for empty or single-element inputs
+
 ## [0.4.0] - 2026-04-15
 
 ### Added
@@ -77,7 +87,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Rounding modes: bankers (round half to even), ceiling, floor, truncate with precision
 - Simple moving average and exponential moving average
 
-[Unreleased]: https://github.com/philiprehberger/rb-math-kit/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-math-kit/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/philiprehberger/rb-math-kit/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/philiprehberger/rb-math-kit/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/philiprehberger/rb-math-kit/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/philiprehberger/rb-math-kit/compare/v0.2.3...v0.3.0
 [0.2.3]: https://github.com/philiprehberger/rb-math-kit/compare/v0.2.2...v0.2.3

data/README.md

@@ -41,6 +41,13 @@ Philiprehberger::MathKit::Stats.stddev([2, 4, 4, 4, 5, 5, 7, 9])    # => 2.0
 Philiprehberger::MathKit::Stats.percentile([1, 2, 3, 4, 5], 50)      # => 3.0
 Philiprehberger::MathKit::Stats.sum([1, 2, 3])                # => 6
 Philiprehberger::MathKit::Stats.range([1, 5, 3, 9, 2])        # => 8
+Philiprehberger::MathKit::Stats.sum_of_squares([1, 2, 3])     # => 2.0
+```
+
+### Interquartile Range
+
+```ruby
+Philiprehberger::MathKit::Stats.iqr([1, 2, 3, 4, 5, 6, 7, 8, 9, 10])  # => 4.5
 ```
 
 ### Summary Statistics
@@ -160,7 +167,9 @@ Philiprehberger::MathKit::Numeric.clamp(42, 0, 10)  # => 10
 | `.variance(values, population: true)` | Population or sample variance |
 | `.stddev(values, population: true)` | Standard deviation |
 | `.percentile(values, p)` | Percentile (0-100) with linear interpolation |
+| `.iqr(values)` | Interquartile range (Q3 - Q1) |
 | `.sum(values)` | Sum of values |
+| `.sum_of_squares(values)` | Sum of squared deviations from the mean (0.0 for empty/single input) |
 | `.range(values)` | Max - min |
 | `.skewness(values)` | Sample skewness (Fisher-Pearson) |
 | `.kurtosis(values)` | Sample excess kurtosis (Fisher definition) |

data/lib/philiprehberger/math_kit/stats.rb

@@ -97,6 +97,17 @@ module Philiprehberger
           (sorted[lower] + (fraction * (sorted[upper] - sorted[lower]))).to_f
         end
 
+        # Interquartile range (Q3 - Q1) using linear interpolation
+        #
+        # @param values [Array<Numeric>] the input values
+        # @return [Float] Q3 minus Q1
+        # @raise [ArgumentError] if values is empty
+        def iqr(values)
+          raise ArgumentError, 'values must not be empty' if values.empty?
+
+          percentile(values, 75) - percentile(values, 25)
+        end
+
         # Sum of values
         #
         # @param values [Array<Numeric>] the input values
@@ -105,6 +116,19 @@ module Philiprehberger
           values.sum
         end
 
+        # Sum of squared deviations from the mean: \sum_i (x_i - mean)^2.
+        # Building block for variance, regression residuals, ANOVA, etc.
+        # Returns 0.0 for empty or single-element inputs.
+        #
+        # @param values [Array<Numeric>] the input values
+        # @return [Float] the sum of squares
+        def sum_of_squares(values)
+          return 0.0 if values.size < 2
+
+          avg = mean(values)
+          values.sum(0.0) { |v| (v - avg)**2 }
+        end
+
         # Range (max - min)
         #
         # @param values [Array<Numeric>] the input values

data/lib/philiprehberger/math_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module MathKit
-    VERSION = '0.4.0'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-math_kit
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
 description: Descriptive statistics, linear interpolation, rounding modes, and moving
   averages. Lightweight math toolkit with zero dependencies.