roots 1.1.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9dff74a275635f6271bef7cf4055be31311e97e6
-  data.tar.gz: 62db9885cfc473e764e879be0cdb626c207fcfbb
+  metadata.gz: 713ce2176c4046036288cae2d0b5bddbe07cd170
+  data.tar.gz: 1ea2b5fd2e8ccb26520f175a7f9fc10398ba5681
 SHA512:
-  metadata.gz: '0806626fff63d16ecca34ffeaf2abe565fe67f03d16f36ecc4fe889ae2c64ed122515cfb33ccce363096eff5b9d0b8e39aeb47f7b41862f3a19ae4be6bfcfce7'
-  data.tar.gz: 551ac3a4c43eadb96065b1006feb1f667f76825d169368b29caa571ebeb7bd722bfe52f199cbd21fdd41920d678d7b6ab9a5d4c726913f4940837d10afda6a34
+  metadata.gz: ae80ce3d2898c4cb29e0227b3ba852df316b3465bf238505213932082e5237d855073a93f5d5c75fb7194c2f3fe546c956c3db11dcbc4f91c7072de88559b4ed
+  data.tar.gz: 04ad6fda5f12885b138aab35f530d8427dd0a86735f209d10d7fc3b0fb8c80e6f5da6dbb95fbf8fa92199c4e9f0064dea769f4c0a76b1430ae3ebbc962896962

data/lib/roots.rb

@@ -105,6 +105,32 @@ These all should be 0.0, which causes incorrect root values there.
 I 'fix' these errors by setting aliases of sin|cos to 0.0 if the
 absolute value of the other function equals 1.0 so they produce
 the correct root values.
+
+Added: 2017-2-20
+
+Module 'IntRoots' provides the two methods 'iroot2' and 'irootn(n)'
+to find the real squareroot and nth roots of arbitrary sized integers.
+
+Use syntax:  ival.iroot2
+Return the largest Integer +root+ value such that root**2 <= ival
+A negative ival will result in 'nil' being returned.
+
+9.iroot2  => 3
+-9.iroot2 => nil
+
+120.iroot2 => 10
+121.iroot2 => 11
+
+Use syntax:  ival.irootn(n), where n is an Integer > 1
+Return the largest Integer +root+ value such that root**n <= ival
+A negative ival for an even n value will result in 'nil' being returned.
+
+81.irootn(2) => 9
+81.irootn(3) => 4
+81.irootn(4) => 3
+
+-81.irootn(3) => -4
+-81.irootn(4) => nil
 =end
 
 # file roots.rb
@@ -161,7 +187,26 @@ module Roots
     x = mag*Complex(cosine(angle_n),sine(angle_n))
     Complex(x.real.round(Roots.digits_to_show), x.imag.round(Roots.digits_to_show))
   end
+end  
+  
+# Mixin 'root' and 'roots' as methods for all number classes.
+class Numeric; include Roots end
+
+module IntRoots
+  def irootn(n)
+    return nil if self < 0 && n.even?
+    raise "root n is < 2 or not an Integer" unless n.is_a?(Integer) && n > 1
+    num  = self.abs
+    root, bitn_mask = 0, 1 << (num.bit_length/n + 2)
+    until (bitn_mask >>= 1) == 0
+      root |= bitn_mask
+      root ^= bitn_mask if root**n > num
+    end
+    root *= (self < 0 ? -1 : 1)
+  end
+
+  def iroot2; irootn(2) end
 end
 
-# Mixin 'root' and 'roots' as methods for all number classes.
-class Numeric; include Roots end
+# Mixin 'iroot2' and 'irootn(n)' methods for class Integer
+class Integer; include IntRoots end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: roots
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Jabari Zakiya
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-01 00:00:00.000000000 Z
+date: 2017-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -67,9 +67,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.10
 signing_key: 
 specification_version: 4
 summary: two methods 'root' and 'roots' to compute all n roots of real/complex numbers
 test_files: []
-has_rdoc: