eymiha_math 0.1.0 → 0.1.1

data/gem_package.rb

@@ -4,7 +4,7 @@ class GemPackage
   
   def initialize
     @name = 'eymiha_math'
-    @version = '0.1.0'
+    @version = '0.1.1'
     @files = FileList[
       '*.rb',
       'lib/*',

data/lib/approximately_equals.rb

@@ -1,7 +1,15 @@
 # Approminately equals returns true when values are close enough, within some
-# distance epsilon above or below the given value.
+# distance epsilon above or below the given value. Three methods and a class
+# variable are added to the Numeric class.
+#
+# @@epsilon, and two class methods, Numeric.epsilon and Numeric.epsilon= get
+# and set the maximum difference between two values for them to be
+# approximately equal.
+#
+# approximately_equals? and the aliased operator =~ return true if two values
+# are approximately equal.
 
-# Adds the approximately equals operation to Numeric and its progeny.
+# Behavor added to Numeric by eymiha_math.
 class Numeric
   
   # The initial default distance from a Numeric below which it is considered

data/lib/eymiha_math.rb

@@ -2,4 +2,5 @@
 
 require 'rectify'
 require 'approximately_equals'
+require 'fraction'
 

data/lib/fraction.rb

@@ -0,0 +1,31 @@
+# Behavior for rendering and rounding fractions with respect to a denominator.
+# Two methods are added to the Numeric class.
+#
+# with_fraction is an alternative to to_s that renders a value as a string
+# with a whole number and any decimal part as a fraction.
+#
+# round_to_nearest rounds a value such that a fractional part with the given
+# denominator will have integer as its numerator.
+
+# Behavior added to Numeric by eymiha_math
+class Numeric
+
+  # Renders a numeric value as a whole number and a fraction with a given
+  # denominator, separated with a given separator, and optionally showing
+  # fractions with a numerator of zero.
+  def with_fraction(denominator=1,separator='-',show_zero=false)
+    sign = self <=> 0
+    unsigned = self*sign
+    whole = (((unsigned*denominator).round)/denominator).floor
+    numerator = ((unsigned-whole)*denominator).round
+    "#{sign*whole}#{(numerator != 0)||show_zero ?
+        "#{separator}#{numerator}/#{denominator}" : ""}"
+  end
+
+  # Returns a numeric value such that any remainder is evenly divided by
+  # the given denominator.
+  def round_to_nearest(denominator=1)
+    ((self*denominator).round)/(1.0*denominator)
+  end
+
+end

data/lib/rectify.rb

@@ -1,7 +1,16 @@
-# Rectification maps values to an interval treated either as a cycle or a
-# cutoff.
+# Rectification maps values to an limits treated either as cycles, upper 
+# bounds, lower bounds or both. Four methods are added to the Numeric class:
+#
+# wrap_rectify() wraps values to an interval treated as a cycle. Think of it
+# as degrees around a compass.
+#
+# cut_rectify() cuts off values to keep them between an upper and lower bound.
+#
+# at_most() cuts off values at an upper bound.
+#
+# at_least() cuts off value at a lower bound.
 
-# Adds recticiation to Numerics and their progeny
+# Behavior added to Numeric by eymiha_math.
 class Numeric
 
   # Treats the interval between low and high as a cycle, returning the result
@@ -21,13 +30,17 @@ class Numeric
   # the two.
   def cut_rectify(high=1,low=0)
     low,high = high,low if low > high
-    if (self < low)
-      low
-    elsif (self > high)
-      high
-    else
-      self
-    end
+    (self < low)? low : (self > high)? high : self
   end
   
+  # Constrains a value to an upper limit.
+  def at_most(high=0)
+    self > high ? high : self
+  end
+
+  # Constrains a value to a lower limit.
+  def at_least(low=0)
+    self < low ? low : self
+  end
+
 end

data/test/tc_fraction.rb

@@ -0,0 +1,19 @@
+require 'test/unit'
+
+require 'fraction'
+
+class TC_fraction < Test::Unit::TestCase
+
+  def test_with_fraction
+    assert(2.31.with_fraction(4) == "2-1/4")
+    assert(2.31.with_fraction(5) == "2-2/5")
+    assert(2.31.with_fraction(6,' ') == "2 2/6")
+  end
+  
+  def test_round_to_nearest
+    assert(0.22.round_to_nearest(5) == 0.2)
+    assert(0.22.round_to_nearest(10) == 0.2)
+    assert(0.22.round_to_nearest(50) == 0.22)
+  end
+  
+end

data/test/tc_rectify.rb

@@ -25,5 +25,15 @@ class TC_rectify < Test::Unit::TestCase
     assert(0.5.cut_rectify(0.5,2) == 0.5)
     assert(0.5.cut_rectify(0,0) == 0)
   end
+
+  def test_at_most
+    assert((-5..5).collect{|v| v.at_most(2)} ==
+           [-5,-4,-3,-2,-1,0,1,2,2,2,2])
+  end
+  
+  def test_at_least
+    assert((-5..5).collect{|v| v.at_least(-1.5)} ==
+           [-1.5,-1.5,-1.5,-1.5,-1,0,1,2,3,4,5])
+  end
   
 end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.0
+rubygems_version: 0.9.2
 specification_version: 1
 name: eymiha_math
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
-date: 2007-05-10 00:00:00 -04:00
+  version: 0.1.1
+date: 2007-08-22 00:00:00 -04:00
 summary: Eymiha basic math extensions
 require_paths: 
 - lib
@@ -33,8 +33,10 @@ files:
 - rakefile.rb
 - lib/approximately_equals.rb
 - lib/eymiha_math.rb
+- lib/fraction.rb
 - lib/rectify.rb
 - test/tc_approximately_equals.rb
+- test/tc_fraction.rb
 - test/tc_rectify.rb
 test_files: []