euclidean 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9a73c24a00cc5b70d91928313b88a92fd4b7b911
-  data.tar.gz: 90fc4f8ec1974af5a8e7663e89d99564791ad673
+  metadata.gz: 46a78d38c196c8397bc3ec3ed43c9a8792c1c0d4
+  data.tar.gz: 26630fe11dc5fa52b7bc286b504dd7b30998070c
 SHA512:
-  metadata.gz: 5ec8e7d0cc9e81d4d974cd7b3d0a0bef4f636d2e0c17981937ab8fbeb48c8814763af0d61ec426536ffe2e0ffd300b497b12bc437d2aeca68c3f9f06e2db83c8
-  data.tar.gz: b31be403bbaaa9510a7efe67d3a40427fd7440488445955cc32ec938c18b5c3315f4e2ce3c809c94a4b19ad5d9d26332d4026cd8eb6c9a1c98ea4ed199091d81
+  metadata.gz: 8bef479af4f0ca678c8a64de6694f8e4a9555c94b6f2fe9746b72468a118ea52a8b3e8013c82685f58209b8fb30f7eba499914b0c96780467d237777f2036193
+  data.tar.gz: 16bd08dc5295ce944e03a99bc3174768cf8a821d3fcbbd18b159579a02bdcb5a1d5bb795583ba4ebcbd4ca96b26468a2dd9fecceebd741e6ab176c5b1e9576b4

data/lib/euclidean/circle.rb

@@ -1,3 +1,5 @@
+require 'mathn'
+
 module Euclidean
 =begin rdoc
 Circles come in all shapes and sizes, but they're usually round.
@@ -11,6 +13,7 @@ Circles come in all shapes and sizes, but they're usually round.
 
   class Circle
     include ClusterFactory
+    include Comparable
 
     # @return [Point]   The {Circle}'s center point
     attr_reader :center
@@ -72,6 +75,16 @@ Circles come in all shapes and sizes, but they're usually round.
       @radius*2
     end
 
+    # Two circles intersect if, and only if, the distance between their centers is between the sum and the difference of their radii.
+    # Given two circles (x0,y0,R0) and (x1,y1,R1), the formula is as follows:
+    # (R0-R1)^2 <= (x0-x1)^2+(y0-y1)^2 <= (R0+R1)^2
+    # @param  [Circle] a {Circle} object
+    # @return [Boolean]
+    def intersects_circle?(other)
+      raise TypeError, "#{other.class} must be a #{self.class}" unless other.kind_of? Euclidean::Circle
+      ( (self.center.x - other.center.x)**2 + (self.center.y - other.center.y)**2  ).between?( ((self.radius - other.radius)**2), ((self.radius + other.radius)**2) )
+    end
+
     # @return [Point]   The upper right corner of the bounding {Rectangle}
     def max
       @center+radius

data/lib/euclidean/version.rb

@@ -1,3 +1,3 @@
 module Euclidean
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/spec/euclidean/circle_spec.rb

@@ -112,4 +112,37 @@ describe Euclidean::Circle do
     end
   end
 
+  describe "#intersects_circle?" do
+    let(:circle_1) { Circle.new [1, 2], 3}
+    let(:circle_2) { Circle.new [3, 0], 3}
+    let(:circle_3) { Circle.new [9, 0], 3}
+    let(:circle_4) { Circle.new diameter: 4 }
+
+    context "When two circles intersect" do
+      it "returns true" do
+        expect(circle_1.intersects_circle?(circle_2)).to be true
+      end
+    end
+
+    context "When two circles intersect at only one point" do
+      it "returns true" do
+        expect(circle_2.intersects_circle?(circle_3)).to be true
+      end
+    end
+
+    context "When two circles do not intersect" do
+      it "returns false" do
+        expect(circle_1.intersects_circle?(circle_3)).to be false
+      end
+    end
+
+    context "When compared to a non-circle" do
+      it "raises an error" do
+        rectangle = Rectangle.new([-1,0], [3,4])
+        expect{ circle_1.intersects_circle?(rectangle) }.to raise_error TypeError
+        expect{ circle_4.intersects_circle?(rectangle) }.to raise_error TypeError
+      end
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: euclidean
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jeremy Ward