enumerable-stats 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd06a4ad69a379469e16e45d5eca8debb2a786edc66c3208429adde1c6f80f20
-  data.tar.gz: 2a8823cdf6f5fe2793e9df99dbd71f4427a63146fdd165475204fe4493607355
+  metadata.gz: c5a52c483b38592d8be9155651e63a4d238850927bc3282f27f22a4859e1db1a
+  data.tar.gz: 0e807826f7103e049effcd1bd925279e5b1ea7d34932fddebf7167e184a6b887
 SHA512:
-  metadata.gz: 308025ee228b384520cff759f5664beace555bd66e3894c389e1547359e2eb90e7fad1bfd72c6774f5b1b327c222a5dd9e8a278b9e16155a9a7e48a693bc60bc
-  data.tar.gz: 224af711d1b3b24d8218cf15adb116216dcb57c81f677b5af8c02c238e2ea304e2ac3537aa9c221750055b68a61d15cce578ee5e7a7687283cce4fb0f917f5dd
+  metadata.gz: df23176506fd05b2769fc6ee49ed62bc7954ec9f810d6153a69754df90a3cbed7b4744e269c7f26b08b1e2bb56b0384d3c1a46bdacc7a57ecba7f9029c4bcb19
+  data.tar.gz: 8e80e9d596018a704773ca2836f951d1565876b35aedf7428117a61d031f685ea788ac115d02f04fc7b27ab9b06ebae5a617fe891a97130b8da628cdee807c20

data/lib/enumerable_stats/enumerable_ext.rb

@@ -108,6 +108,53 @@ module EnumerableStats
       end
     end
 
+    # Calculates the specified percentile of the collection
+    # Uses linear interpolation between data points when the exact percentile falls between values
+    # This is equivalent to the "linear" method used by many statistical software packages
+    #
+    # @param percentile [Numeric] The percentile to calculate (0-100)
+    # @return [Numeric, nil] The value at the specified percentile, or nil if the collection is empty
+    # @raise [ArgumentError] If percentile is not between 0 and 100
+    # @example
+    #   [1, 2, 3, 4, 5].percentile(50)    # => 3 (same as median)
+    #   [1, 2, 3, 4, 5].percentile(25)    # => 2.0 (25th percentile)
+    #   [1, 2, 3, 4, 5].percentile(75)    # => 4.0 (75th percentile)
+    #   [1, 2, 3, 4, 5].percentile(0)     # => 1 (minimum value)
+    #   [1, 2, 3, 4, 5].percentile(100)   # => 5 (maximum value)
+    #   [].percentile(50)                 # => nil (empty collection)
+    def percentile(percentile)
+      return nil if size == 0
+
+      unless percentile.is_a?(Numeric) && percentile >= 0 && percentile <= 100
+        raise ArgumentError, "Percentile must be a number between 0 and 100, got #{percentile}"
+      end
+
+      sorted = sort
+
+      # Handle edge cases
+      return sorted.first if percentile == 0
+      return sorted.last if percentile == 100
+
+      # Calculate the position using the "linear" method (R-7/Excel method)
+      # This is the most commonly used method in statistical software
+      position = (size - 1) * (percentile / 100.0)
+
+      # If position is an integer, return that exact element
+      if position == position.floor
+        sorted[position.to_i]
+      else
+        # Linear interpolation between the two surrounding values
+        lower_index = position.floor
+        upper_index = position.ceil
+        weight = position - position.floor
+
+        lower_value = sorted[lower_index]
+        upper_value = sorted[upper_index]
+
+        lower_value + weight * (upper_value - lower_value)
+      end
+    end
+
     # Calculates the sample variance of the collection
     # Uses the unbiased formula with n-1 degrees of freedom (Bessel's correction)
     #

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: enumerable-stats
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Jon Daniel
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-31 00:00:00.000000000 Z
+date: 2025-08-01 00:00:00.000000000 Z
 dependencies: []
 description: |
   A Ruby gem that extends all Enumerable objects (Arrays, Ranges, Sets, etc.) with essential statistical methods.
@@ -28,6 +29,7 @@ metadata:
   source_code_uri: https://github.com/binarycleric/enumerable-stats
   github_repo: ssh://github.com/binarycleric/enumerable-stats
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -42,7 +44,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Statistical Methods for Enumerable Collections
 test_files: []