rb_ext 0.3.1 → 0.4.0

data/VERSION

@@ -1 +1 @@
-0.3.1
+0.4.0

data/lib/rb_ext/array.rb

@@ -1,12 +1,12 @@
 module RbExt
   module Array
+    
     # Splits an array by _separator_ and returns an array holding
     # the splitted values in arrays. Works like String#split for arrays.
     #
     # -- TODO: modify to support nested arrays
     #
     # Example:
-    #
     #  a = %w(a b c - d e f g - h i j - k)
     #  a.split("-")     # => [[a, b, c], [d, e, f, g], [h, i, j] [k]]
     #
@@ -40,7 +40,6 @@ module RbExt
     # and supports nested arrays.
     #
     # Example:
-    #
     #  a = ["a", "b", 1, "c", 2.5, ["d", 3], "e"]
     #  a.n_up(2)      # => ["aa", "bb", 2, "cc", 5.0, ["dd", 6], "ee"]
     #
@@ -63,7 +62,6 @@ module RbExt
     # Flattens first level of an array.
     #
     # Example:
-    #
     #   [1, [2, [3]]].flatten_once  # => [1, 2, [3]]
     #
     def flatten_top
@@ -76,13 +74,18 @@ module RbExt
       end
     end
     
+    
+    
+    ########################################################
+    ################# TYPE MAPPING METHODS #################
+    ########################################################
+    
     # Returns a hash where its keys are the string versions
     # of the values in the array and invokes a block for each
     # element in the array taking the return value of the block
     # as the value for the hash element.
     #
     # Example:
-    #
     #  ["a", "b", "c"].to_hash_keys { |arr, e| arr.index(e) }   # => {"a"=>0, "b"=>1, "c"=>2}
     #  ["a", "b", "c", ["d", "e"]].to_hash_keys { |arr, e| arr.index(e) }   # => {"a"=>0, "b"=>1, "c"=>2, "[\"d\", \"e\"]"=>{"d"=>0, "e"=>1}}
     #
@@ -106,7 +109,6 @@ module RbExt
     # as the key for the hash element.
     #
     # Example:
-    #
     #  ["a", "b", "c"].to_hash_values { |arr, e| arr.index(e) }   # => {"0"=>"a", "1"=>"b", "2"=>"c"}
     #  ["a", "b", "c", ["d", "e"]].to_hash_values { |arr, e| arr.index(e) }   # => {"0"=>"a", "1"=>"b", "2"=>"c", "{\"0\"=>\"d\", \"1\"=>\"e\"}"=>["d", "e"]}
     #
@@ -130,7 +132,6 @@ module RbExt
     # as a single hash.
     #
     # Example:
-    #
     #   %w(a b c).to_hash( %w(1 2 3) )    # => {"a"=>"1", "b"=>"2", "c"=>"3"}
     #   ["a", ["b", "c"]].to_hash( %w(1 2 3) )  # => {"a"=>"1", ["b", "c"]=>"2"}
     #   ["1", "2", "3"].to_hash(["a", ["b", "c"]])  # => {"1"=>"a", "2"=>["b", "c"], "3"=>nil}
@@ -139,5 +140,65 @@ module RbExt
     def to_hash(values)
       Hash[ *(0...self.size()).inject([]) { |arr, ix| arr.push(self[ix], values[ix]) } ]
     end
+    
+    
+    
+    
+    ########################################################
+    ################## ARITHMETIC METHODS ##################
+    ########################################################
+    
+    # Calculates the arithmetical mean of the values in the array
+    # [http://en.wikipedia.org/wiki/Average#Arithmetic_mean]
+    #
+    # Example:
+    #   [1, 2, 3, 4, 5].arithmetic_mean   # => 3.0
+    #
+    def arithmetic_mean
+      inject(0) { |sum, val| sum + val.to_f } / length.to_f
+    end
+    
+    # Calculates the geographical mean of the values in the array
+    # [http://en.wikipedia.org/wiki/Average#Geometric_mean]
+    #
+    # Example:
+    #   [2, 3, 4.5].geometric_mean    # => 3.0
+    #
+    def geometric_mean
+      inject(1) { |product, val| product * val.to_f } ** (1.0 / length.to_f)
+    end
+    
+    # Calculates the harmonic mean of the values in the array
+    # [http://en.wikipedia.org/wiki/Average#Harmonic_mean]
+    #
+    # Example:
+    #   [1, 2, 3, 4, 5].harmonic_mean   # => 2.18978102189781
+    #
+    def harmonic_mean
+      length.to_f / inject(0) { |sum, val| sum + (1.0 / val.to_f) }
+    end
+    
+    # Calculates the root mean square of the values in the array
+    # [http://en.wikipedia.org/wiki/Quadratic_mean]
+    # 
+    #
+    # Example:
+    #   [10, 12, 14, 20].quadratic_mean     # => 14.491376746189438
+    #
+    def quadratic_mean
+      (inject(0) { |sum, val| sum + (val.to_f * val.to_f) } / length.to_f) ** (1.0 / 2.0)
+    end
+    
+    # Calculates the mid range of the values in the array
+    # by (max + min) / 2.0
+    # [http://en.wikipedia.org/wiki/Midrange]
+    #
+    # Example:
+    #   [1, 5, 2, 3].mid_range    # => 3.0
+    #
+    def mid_range
+      tmp = sort
+      (tmp.last.to_f + tmp.first.to_f) / 2.0
+    end
   end  
 end

data/lib/rb_ext/hash.rb

@@ -5,8 +5,8 @@ module RbExt
     # matched by the key names given to the method.
     #
     # Example:
-    #   { :a => 1, :b => 2 }.pass(:a)  # => { :a => 1 }
-    #   { :abc => 1, :bbc => 2 }.pass(/^ab/)    # => { :abc => 1 }
+    #   { :a => 1, :b => 2 }.only(:a)  # => { :a => 1 }
+    #   { :abc => 1, :bbc => 2 }.only(/^ab/)    # => { :abc => 1 }
     #
     def only(*keys)
       if keys.first.is_a? Regexp
@@ -20,8 +20,8 @@ module RbExt
     # that did not match the key names given to the method.
     #
     # Example:
-    #   { :a => 1, :b => 2 }.block(:a)    # => { :b => 2 }
-    #   { :abc => 1, :bbc => 2 }.block(/^ab/)   # => { :bbc => 2 }
+    #   { :a => 1, :b => 2 }.except(:a)    # => { :b => 2 }
+    #   { :abc => 1, :bbc => 2 }.except(/^ab/)   # => { :bbc => 2 }
     #
     def except(*keys)
       if keys.first.is_a? Regexp

data/rb_ext.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rb_ext}
-  s.version = "0.3.1"
+  s.version = "0.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Robert Neumayr"]
-  s.date = %q{2011-04-27}
+  s.date = %q{2011-04-28}
   s.description = %q{Adds a bunch of methods to Ruby's Core Library, like Array#split or Hash#pick}
   s.email = %q{kontakt@icatcher.at}
   s.extra_rdoc_files = [

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 3
-  - 1
-  version: 0.3.1
+  - 4
+  - 0
+  version: 0.4.0
 platform: ruby
 authors: 
 - Robert Neumayr
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-27 00:00:00 +02:00
+date: 2011-04-28 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -96,7 +96,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: -892137137
+      hash: -934454225
       segments: 
       - 0
       version: "0"