borel 0.3.0 → 0.3.1

data/README.md

@@ -8,7 +8,9 @@ Borelian sets are formed by enumerable union, intersection or
  of any comparable class.
 
 **Borel** borrows many of the ideas _(and code)_
- from the  **Intervals** [gem][1].
+ from the  **Intervals** [gem][1]. However it differs from Intervals in which
+ it's aim is not on numerical precision and calculation, but on ease of use and
+ solving some general interval related problems.
 
 [1]: http://intervals.rubyforge.org
 
@@ -31,8 +33,8 @@ Usage
 ### Initializing
 
 An Interval can be initialized with an empty, one or two sized array
- (respectively for an _empty_, _degenerate_ or _simple_ interval), or
- an array of one or two sized arrays (for a _multiple_ interval).
+ (respectively for an _empty_, _degenerate_ or `Simple` interval), or
+ an array of one or two sized arrays (for a `Multiple` interval).
 
 ```ruby
   Interval[]
@@ -42,15 +44,17 @@ An Interval can be initialized with an empty, one or two sized array
 ```
 
 Another way to initialize an Interval is by using the
- **to_interval** method on Ranges or Numbers.
+ `#to_interval` method extension.
 
 ```ruby
-  1.to_interval
-  (0..1).to_interval
-  (0...2).to_interval
+  nil.to_interval     # -> Interval[]
+  1.to_interval       # -> Interval[1]
+  (1..2).to_interval  # -> Interval[1,2]
+  (1...3).to_interval # -> Interval[1,2]
+  [1,2].to_interval   # -> Interval[1,2]
 ```
 
-The **Infinity** constant is available for specifying intervals
+The `Infinity` constant is available for specifying intervals
  with no upper or lower boundary.
 
 ```ruby
@@ -64,6 +68,8 @@ The **Infinity** constant is available for specifying intervals
 Some natural properties of intervals:
 
 ```ruby
+  Interval[1,2].inf             # -> 1
+  Interval[1,2].sup             # -> 2
   Interval[1].degenerate?       # -> true
   Interval[[0,1],[2,3]].simple? # -> false
   Interval[].empty?             # -> true
@@ -74,7 +80,7 @@ Some natural properties of intervals:
 
 * Complement
 
-__complement__ and __~__
+`#complement`, alias: `#~`
 
 ```ruby
     ~Interval[0,5]             # -> Interval[[-Infinity, 0], [5, Infinity]]
@@ -82,7 +88,7 @@ __complement__ and __~__
 
 * Union
 
-__union__, __|__ and __+__
+`#union`, aliases: `#|`,`#+`
 
 ```ruby
 Interval[0,5] | Interval[-1,3] # -> Interval[-1,5]
@@ -90,7 +96,7 @@ Interval[0,5] | Interval[-1,3] # -> Interval[-1,5]
 
 * Intersection
 
-__intersect__, __&__, __^__
+`#intersect`, aliases: `#&`,`#^`
 
 ```ruby
 Interval[0,5] ^ Interval[-1,3] # -> Interval[0,3]
@@ -98,7 +104,7 @@ Interval[0,5] ^ Interval[-1,3] # -> Interval[0,3]
 
 * Subtraction
 
-__minus__ and __-__
+`#minus`, alias: `#-`
 
 ```ruby
 Interval[0,5] - Interval[-1,3] # -> Interval[3,5]
@@ -140,13 +146,13 @@ Interval[1,5].rand  # -> Random.new.rand 1..5
 Interval[1,5].width # -> 5-1, only for simple intervals
 ```
 
-It's supported only for Numeric Comparable and arithmetic supported classes
+It's supported only for `Numeric`, `Comparable` and arithmetic supported classes
 
 Remarks
 -------
 
 * There is no distinction between _open_ and _closed_ intervals
-* _complement_ and _minus_ operations, and also _Math Extensions_ have limited
+* `complement` and `minus` operations, and also _Math Extensions_ have limited
 support for non numeric-comparable classes
 
 License

data/borel.gemspec

@@ -6,7 +6,7 @@ Gem::Specification.new do |s|
   s.platform = Gem::Platform::RUBY
   s.authors = ["Amadeus Folego"]
   s.email = ["amadeusfolego@gmail.com"]
-  s.homepage = "http://github.com/amadeusfolego/borel"
+  s.homepage = "http://github.com/badosu/borel"
   s.summary = "Generic ordered set's operations"
   s.description = "Borel sets are made of enumerable union and intersection of
 intervals. Borel performs regular operations on any interval of any

data/lib/borel/interval.rb

@@ -5,7 +5,7 @@ Infinity = 1/0.0
 class Interval
   include Enumerable
 
-  def Interval.[](*array)
+  def self.[](*array)
     union(*
       if array.empty?
         []
@@ -16,14 +16,13 @@ class Interval
       end
     )
   rescue
-    unless
-        array.size <= 2 || array.all?{|x| Array === x && x.size <= 2}
+    unless array.size <= 2 || array.all?{|x| Array === x && x.size <= 2}
       raise Exception::Construction, array
     end
     raise
   end
 
-  def Interval.union(*array)
+  def self.union(*array)
     l = []
     array.map(&:components).flatten.sort_by(&:inf).each do |x|
       if x.sup < x.inf
@@ -51,6 +50,11 @@ class Interval
       flatten.reduce(:union)
   end
 
+  def intersect(other)
+    other.to_interval.map{|y| map{|x| x.intersect(y)}}.
+      flatten.reduce(:union) || Interval[]
+  end
+
   def minus(other)
     if other.empty?
       self
@@ -64,22 +68,10 @@ class Interval
     construction == other.construction
   end
 
-  def include?(x)
-    any?{|i| i.include? x}
-  end
-
   def empty?
     components.empty?
   end
 
-  def construction
-    map &:construction
-  end
-
-  def degenerate?
-    all? &:degenerate?
-  end
-
   def to_interval
     self
   end
@@ -92,14 +84,6 @@ class Interval
     inspect
   end
 
-  def inf
-    first.inf
-  end
-
-  def sup
-    last.sup
-  end
-
   def hull
     if empty?
       Interval[]

data/lib/borel/interval_multiple.rb

@@ -11,6 +11,26 @@ class Interval::Multiple < Interval
     self
   end
 
+  def inf
+    first.inf
+  end
+
+  def sup
+    last.sup
+  end
+
+  def construction
+    map &:construction
+  end
+
+  def include?(x)
+    any?{|i| i.include? x}
+  end
+
+  def degenerate?
+    all? &:degenerate?
+  end
+
   def simple?
     false
   end

data/lib/borel/version.rb

@@ -1,7 +1,7 @@
 module Borel
   MAJOR = 0
   MINOR = 3
-  TINY = 0
+  TINY = 1
 
   VERSION = [MAJOR, MINOR, TINY].join('.')
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: borel
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -53,7 +53,7 @@ files:
 - spec/range_spec.rb
 - tasks/gem.rb
 - tasks/rspec.rb
-homepage: http://github.com/amadeusfolego/borel
+homepage: http://github.com/badosu/borel
 licenses: []
 post_install_message: 
 rdoc_options: []