rubyllipse 1.0.0 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 234aac93632e7a7f43c1788e72eea0fb3ca700035965942bb4a122fa190ba539
-  data.tar.gz: 75af9f59827cc2c8998f9ba12f42bf35bd8a19a174b6b5eb8c03e96a34eec44b
+  metadata.gz: 3738c04c84d4f5266f64bc14349d7c5e781a80da94eba257398dd986ba85afb8
+  data.tar.gz: f381cca3160f7bb0119afc2686f98404984dea1aa6c73dd2c9e4a94cac4f319a
 SHA512:
-  metadata.gz: de4894844093f76e88aaa5f17707051b903aeaee34c3e75e6b387ed9ccfa083f5c308bf99b991b2052f6b79619a7631ddc87946fa4ea7e9a24231c9b7373c6fd
-  data.tar.gz: 988b8059eaf608b202f23705808bfe9fb2bc1fb3c608d1faa290c6ff092acf37fcfbd3a33f2675fd0c104c06720735abff95c7c2b1e69e94fd37bd3c35b73f07
+  metadata.gz: 5c059eb8eb22d82b2b5ab3ff00c0c3cb967541c2d36a556db78edc4908d6b872580c99fb72fe38ded41fc0bf3c10443ae03cfe95399595d53c8021f2bee3d758
+  data.tar.gz: 0d28b11b78d542c37910635a15f16586f6d8c8c798d6b0887a9c9d8707fd16df89683f1c628b4466b8e040c1c8cafe5806b7cfc61f856c288a4cd9e44797a4d1

data/README.md

@@ -0,0 +1,27 @@
+# Rubyllipse
+Yes, I know the name's dumb.
+
+A simple gem for managing and playing with ellipses.
+
+## Usage
+
+Create a new ```Ellipse``` object: ```Rubyllipse::Ellipse::new(major_radius, minor_radius, center_coordinates)```; ```myellipse = Rubyllipse::Ellipse::new(3, 3, [0,0])```.
+
+```myellipse.is_circle? == True``` as we can see we just created a circle. ```myellipse.area```, ```myellipse.perimeter``` will return the circle's area, perimeter.
+
+```myellipse.move_horizontally(3)``` will move the ellipse by 3 units towards the positive horizontal way and reinitialize the ```myellipse``` object. 
+
+One of the most important aspects of an ```Ellipse``` object is the ```form``` attribute. it can be either set to ```'horizontal'``` or ```'vertical'``` and it determines if the ellipse's major-axis will be vertical or horizontal (tilted, rotated ellipses are not available yet).
+
+Another important method is ```give_function!```. It returns a string for the purpose of mainly displaying the function of the ```Ellipse``` object.
+
+You can easily find a point by using the ```get_ordinates_for(abscissa)``` for example: ```Rubyllipse::Ellipse::new(10, 2, [3,3], form:'vertical')::get_ordinates_for(3)``` will return ```[13.0, -7]``` and ```get_abscissas_for(ordinate)``` is what you think it is. (Added in 1.0.4 and 1.0.5)
+
+You can also compute the points of intersection for the ellipse and the x, y axis with; ```Ellipse.pointsof_intersection_for_x``` and ```Ellipse.pointsof_intersection_for_y```. (added in 1.0.5)
+
+Other methods are for accessing the object's attributes and don't need further explanation. 
+
+
+## Notes
+If you used the module and found something odd, bad, please send me an e-mail; I am still new to Ruby.
+

data/lib/rubyllipse.rb

@@ -14,6 +14,9 @@ module Rubyllipse
       elsif @form == 'vertical'
         @vertexes = [[@center[0], @center[0]+@major_radius], [@center[0], @center[0]-@major_radius]]
         @co_vertexes = [[@center[0]+@minor_radius, @center[1]], [@center[0]-@minor_radius, @center[1]]]
+      elsif @form == 'tilted'
+        @vertexes = vertexes
+        @co_vertexes = co_vertexes
       end
       
       @radii = [@major_radius, @minor_radius]
@@ -29,6 +32,8 @@ module Rubyllipse
         @focii = [[@center[0]+@focal_length, @center[1]], [@center[0]-@focal_length, @center[1]]]
       elsif @form == 'vertical'
         @focii = [[@center[0], @center[1]+@focal_length], [@center[0], @center[1]-@focal_length]]
+      elsif @form == 'tilted'
+        @focii = focii
       end
       
       @eccentricity = Float(@focal_length)/@major_radius
@@ -69,6 +74,14 @@ module Rubyllipse
     def eccentricity
       return @eccentricity
     end
+
+    def center
+      return @center
+    end
+
+    def form
+      return @form
+    end
     
     def give_function!
       c_x = @center[0]
@@ -80,8 +93,96 @@ module Rubyllipse
         a = @major_radius**2
         b = @minor_radius**2
       end
-      equation = "(x-#{c_x})^2/#{a} + (y-#{c_y})^2/#{b} = 1"
+      equation = "(x-#{c_x})^2/#{b} + (y-#{c_y})^2/#{a} = 1"
       return equation 
     end
+
+    def move_horizontally!(distance)
+      @center = [@center[0]+distance, @center[1]]
+      self.initialize(@major_radius, @minor_radius, @center, form:@form)
+      return
+    end
+    
+    def move_vertically!(distance)
+      @center = [@center[0], @center[1]+distance]
+      self.initialize(@major_radius, @minor_radius, @center, form:@form)
+      return  
+    end
+
+    def get_ordinates_for(abscissa)
+      abscissa = Float(abscissa)     
+      
+      c_x = @center[0]
+      c_y = @center[1]
+      if @form == 'horizontal'
+        a = @minor_radius**2
+        b = @major_radius**2
+      elsif @form == 'vertical'
+        a = @major_radius**2
+        b = @minor_radius**2
+      end
+      
+      begin
+        ordinate1 = Math.sqrt(a)*Math.sqrt(1-((abscissa-c_x)**2/b))+c_y
+        ordinate2 = 2*@center[1]-ordinate1
+        ordinates = [ordinate1, ordinate2]
+      rescue 
+        puts "this ellipse is not defined for value: #{abscissa}"
+      end
+      
+      return ordinates
+    end
+    
+
+    def get_abscissas_for(ordinate)
+      ordinate = Float(ordinate)
+
+      c_x = @center[0]
+      c_y = @center[1]
+      if @form == 'horizontal'
+        a = @minor_radius**2
+        b = @major_radius**2
+      elsif @form == 'vertical'
+        a = @major_radius**2
+        b = @minor_radius**2
+      end
+
+      begin
+        abscissa1 = Math.sqrt(b)*Math.sqrt(1-((ordinate-c_y)**2/a))+c_x
+        abscissa2 = 2*@center[0]-abscissa1
+        abscissas = [abscissa1, abscissa2]
+      rescue
+        puts "this ellipse is not defined for value: #{ordinate}"
+      end
+
+      return abscissas
+    end
+    
+    def pointsof_intersection_for_y()
+      return [[0, self.get_ordinates_for(0)[0]], [0, self.get_ordinates_for(0)[1]]]
+    end
+
+    def pointsof_intersection_for_x()
+      return [[self.get_abscissas_for(0)[0], 0], [self.get_abscissas_for(0)[1], 0]]
+    end
   end
 end
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

metadata

@@ -1,21 +1,23 @@
 --- !ruby/object:Gem::Specification
 name: rubyllipse
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.5
 platform: ruby
 authors:
 - Burzum
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-11-04 00:00:00.000000000 Z
+date: 2020-11-09 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: 
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
+- README.md
 - lib/rubyllipse.rb
 homepage: 
 licenses: []
@@ -38,5 +40,5 @@ requirements: []
 rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
-summary: A gem for ellipses, this version excludes rotated ellipses.
+summary: A gem for managing ellipses, this version still excludes rotated ellipses.
 test_files: []