Harmonic Mean Calculation in Number Class

Number.php

@@ -183,6 +183,30 @@ public static function withLocale(string $locale, callable $callback)
         return tap($callback(), fn () => static::useLocale($previousLocale));
     }
 
+    /**
+     * Calculate the harmonic mean of a set of numbers.
+     *
+     * @param int|float ...$numbers An indefinite number of numeric arguments
+     * @return float Harmonic mean of the numbers
+     * @throws InvalidArgumentException If the arguments are empty, non-numeric, or contain zero values.
+     */
+    public static function harmonize(int|float ...$numbers): float 
+    {
+        if (empty($numbers)) {
+            throw new InvalidArgumentException("Arguments cannot be empty");
+        }
+
+        $sumOfReciprocals = 0;
+        foreach ($numbers as $number) {
+            if (!is_numeric($number) || $number <= 0) {
+                throw new InvalidArgumentException("All elements must be positive numbers");
+            }
+            $sumOfReciprocals += 1 / $number;
+        }
+
+        return count($numbers) / $sumOfReciprocals;
+    }
+
     /**
      * Set the default locale.
      *