enumerable-stats 1.2.2 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67bc0d2458936c421a69879c70fa9eb553e48c7447012e87810ce3c4ab028d66
-  data.tar.gz: 819fcf5e9446b4f7e4a1d7e75aeb914d4ab6ca6a76e65065877d5c3d3bab3634
+  metadata.gz: e012306442bdf4598aeff1c134063a3a0c98e6765a949c492626ba7acdf90c1d
+  data.tar.gz: dc2565331c7aa7f07ab55c7b876d78e8c9759f7a0e083d9a39f82c2deb1c5458
 SHA512:
-  metadata.gz: c5dfe0571aa591684f9ae8cf8e26a472695b6a26c424185878a6e7a9bfd2786ee20c205c2eca0be234a88fb25c895fc0d2cb25a599aabbc569375657b5ee1705
-  data.tar.gz: cd39ddb06cc2cbc1f204deaece6cce9fcf1835583510559a8dd7d24615df95aac16c9a2ff6bd0ba1678c1dce80c0e7636eae6c121e4b7fd31d418b619fed8604
+  metadata.gz: 1ef3e67bbf9977081003fb009b08afe891b0177a26d58fa5cd206f216890c1ec3c8b4904e92f2731bc3a6ce134848813033d555c7baa16c8fdde87637913f894
+  data.tar.gz: 4aa56d0cba5bd41c2b2e91224814801f8c97429a9cf2516d1acae865c0a2a6b7b786e5eeaba4c81e4777a7b0735b8008fdaf263e9fb26d7c0165fce70f7a24ff

data/lib/enumerable_stats/enumerable_ext.rb

@@ -93,6 +93,9 @@ module EnumerableStats
     #   treatment = [15, 17, 16, 18, 14]
     #   t_stat = control.t_value(treatment)  # => ~-4.2 (negative means treatment > control)
     def t_value(other)
+      raise ArgumentError, "Cannot compare with an empty collection" if empty? || other.empty?
+      raise ArgumentError, "Parameter must be an Enumerable" unless other.respond_to?(:mean)
+
       signal = (mean - other.mean)
       noise = Math.sqrt(
         ((standard_deviation**2) / count) +
@@ -164,6 +167,58 @@ module EnumerableStats
       t_stat < -critical_value
     end
 
+    # Operator alias for greater_than? - tests if this collection's mean is significantly greater
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] The significance level (default: 0.05 for 95% confidence)
+    # @return [Boolean] true if this collection's mean is significantly greater
+    # @example
+    #   baseline = [100, 110, 105, 115, 95]
+    #   optimized = [85, 95, 90, 100, 80]
+    #   baseline > optimized  # => true (baseline is significantly greater)
+    def >(other, alpha: 0.05)
+      greater_than?(other, alpha: alpha)
+    end
+
+    # Operator alias for less_than? - tests if this collection's mean is significantly less
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] The significance level (default: 0.05 for 95% confidence)
+    # @return [Boolean] true if this collection's mean is significantly less
+    # @example
+    #   optimized = [85, 95, 90, 100, 80]
+    #   baseline = [100, 110, 105, 115, 95]
+    #   optimized < baseline  # => true (optimized is significantly less)
+    def <(other, alpha: 0.05)
+      less_than?(other, alpha: alpha)
+    end
+
+    # Tests if this collection's mean is significantly different from another collection's mean
+    # using a two-tailed Student's t-test. Returns 1 if the test indicates statistical
+    # significance at the specified alpha level, -1 if the test indicates statistical
+    # significance at the specified alpha level, and 0 if the test indicates no statistical
+    # significance at the specified alpha level.
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] Significance level (default: 0.05 for 95% confidence)
+    # @return [Integer] 1 if this collection's mean is significantly greater, -1 if this collection's mean is
+    #                   significantly less, 0 if this collection's mean is not significantly different
+    # @example
+    #   control = [10, 12, 11, 13, 12]     # mean ≈ 11.6
+    #   treatment = [15, 17, 16, 18, 14]   # mean = 16.0
+    #   control <=> treatment              # => 1 (control is significantly different from treatment)
+    #   treatment <=> control              # => -1 (treatment is significantly different from control)
+    #   control <=> control                # => 0 (control is not significantly different from itself)
+    def <=>(other, alpha: 0.05)
+      if greater_than?(other, alpha: alpha)
+        1
+      elsif less_than?(other, alpha: alpha)
+        -1
+      else
+        0
+      end
+    end
+
     # Calculates the arithmetic mean (average) of the collection
     #
     # @return [Float] The arithmetic mean of all numeric values

data/lib/enumerable_stats/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EnumerableStats
+  VERSION = "1.4.0"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: enumerable-stats
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.4.0
 platform: ruby
 authors:
 - Jon Daniel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-02 00:00:00.000000000 Z
+date: 2025-08-04 00:00:00.000000000 Z
 dependencies: []
 description: |
   A Ruby gem that extends all Enumerable objects (Arrays, Ranges, Sets, etc.) with essential statistical methods.
@@ -22,6 +22,7 @@ extra_rdoc_files: []
 files:
 - lib/enumerable-stats.rb
 - lib/enumerable_stats/enumerable_ext.rb
+- lib/enumerable_stats/version.rb
 homepage: https://github.com/binarycleric/enumerable-stats
 licenses:
 - MIT