quadtree 1.0.7 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 93b38a02013f5c97126e742d2262be25f388e4c1
-  data.tar.gz: 82bb915f6bddf1f6c1f187cbaf5a3a6eb3a47b0d
+SHA256:
+  metadata.gz: 6cc1a164a8db13d4faf288086e402c3f640e7df3565c06fca0bcc412349e1c82
+  data.tar.gz: 7775b6a0a06fda4e720e8506e0bc6d5366a47097547df4ef92425d81e5d57756
 SHA512:
-  metadata.gz: f18c67ee620d739ddda87a0550f06eb770bb512a7781a0f1d534bdb3cbc51ee1d39fab47e96af94b2d7e75ad298d3b85bdc98ddb48d102efc53fe62be6233397
-  data.tar.gz: 3265235a06f9b067928906086849cca271a78eba0eec2efa48b6e4b6a1e065f006fa8d9274501724101c84e1ba0b69c7687eeac317312bd367f12bf4e7772381
+  metadata.gz: ddc066fdc14f81a13648370cf5f11391287c5ecca6914982c90b85491acfc74399acfbe52bff2c88a621a989624c4d2177d6743b5deb6e492ede6e9093f620c6
+  data.tar.gz: 87ccb5227454748c3c9a7eb9611a332976d9677023b8106b9de132e1a768b5a9cdcbdadd806cb4317585ad28e859fb7d8cb099ddb39f9e242ac9583abdaa65ba

data/.rubocop.yml

@@ -0,0 +1,28 @@
+inherit_from: .rubocop_todo.yml
+
+Layout/EmptyLinesAroundAttributeAccessor:
+    Enabled: true
+Layout/SpaceAroundMethodCallOperator:
+    Enabled: true
+Lint/DeprecatedOpenSSLConstant:
+    Enabled: true
+Lint/MixedRegexpCaptureTypes:
+    Enabled: true
+Lint/RaiseException:
+    Enabled: true
+Lint/StructNewOverride:
+    Enabled: true
+Style/ExponentialNotation:
+    Enabled: true
+Style/HashEachMethods:
+    Enabled: true
+Style/HashTransformKeys:
+    Enabled: true
+Style/HashTransformValues:
+    Enabled: true
+Style/RedundantRegexpCharacterClass:
+    Enabled: true
+Style/RedundantRegexpEscape:
+    Enabled: true
+Style/SlicingWithRange:
+    Enabled: true

data/.rubocop_todo.yml

@@ -0,0 +1,76 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2020-06-04 20:16:28 +0300 using RuboCop version 0.85.0.
+
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: native, lf, crlf
+Layout/EndOfLine:
+  EnforcedStyle: native
+
+# Configuration parameters: IgnoredMethods.
+Metrics/AbcSize:
+  Enabled: true
+  Max: 25
+  Exclude:
+    - lib/quadtree/quadtree.rb
+
+# Configuration parameters: CountComments, ExcludedMethods.
+# ExcludedMethods: refine
+Metrics/BlockLength:
+  CountComments: false
+  #Max: 47
+
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  CountComments: false
+  Exclude:
+    - lib/quadtree/quadtree.rb
+
+# Configuration parameters: IgnoredMethods.
+Metrics/CyclomaticComplexity:
+  Enabled: true
+  Exclude:
+    - lib/quadtree/quadtree.rb
+
+# Configuration parameters: CountComments, ExcludedMethods.
+Metrics/MethodLength:
+  CountComments: false
+  Exclude:
+    - lib/quadtree/quadtree.rb
+
+# Configuration parameters: CountKeywordArgs.
+Metrics/ParameterLists:
+  Enabled: true
+  Exclude:
+    - lib/quadtree/quadtree.rb
+
+# Configuration parameters: IgnoredMethods.
+Metrics/PerceivedComplexity:
+  Enabled: true
+  Exclude:
+    - lib/quadtree/quadtree.rb
+
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: io, id, to, by, on, in, at, ip, db, os, pp
+Naming/MethodParameterName:
+  Enabled: true
+  Exclude:
+    - lib/quadtree/point.rb
+
+# Configuration parameters: AllowedChars.
+Style/AsciiComments:
+  Enabled: true
+  Exclude:
+    - lib/quadtree/point.rb
+
+Style/Documentation:
+  Enabled: true
+
+# Configuration parameters: Strict.
+Style/NumericLiterals:
+  Enabled: true
+
+# Configuration parameters: AutoCorrect, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Enabled: true

data/README.md

@@ -1,67 +1,67 @@
-# Quadtree
-
-![Build Status](https://codebuild.us-east-1.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoidk1aMm1Ya212SjRsU1pVdWNVZ2FRTDVPUXlVM2NsY0dWU2UxL1dEUlh2VTdxdURhcmxRK1JDTGg5OXJxeURKeFRiZXV5VEtTbmRBZCt6bTdDTms1Rm5ZPSIsIml2UGFyYW1ldGVyU3BlYyI6ImlUamttMGtUckZRT0tvM0EiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
-[![Bitbucket Pipelines](https://img.shields.io/bitbucket/pipelines/janlindblom/ruby-quadtree.png)](https://bitbucket.org/janlindblom/ruby-quadtree)
-[![Gem](https://img.shields.io/gem/v/quadtree.png)](https://rubygems.org/gems/quadtree)
-[![Documentation](https://img.shields.io/badge/docs-rdoc.info-yellow.png)](http://www.rubydoc.info/gems/quadtree/frames)
-
-Quadtrees in Ruby. For searching spatially related nodes in some space, you know.
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'quadtree'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install quadtree
-
-## Usage
-
-Load it in your code to start building quadtrees:
-
-```ruby
-require 'quadtree'
-
-boundary = Quadtree::AxisAlignedBoundingBox.new(Quadtree::Point.new(19.8470050, 60.3747940), 8944.0)
-qt = Quadtree::Quadtree.new(boundary)
-```
-
-Then you can do lookups and such:
-
-```ruby
-getaboden = Quadtree::Point.new(19.8470050, 60.3747940, "Getaboden")
-knutnas = Quadtree::Point.new(19.8271170, 60.3505570, "Knutnäs")
-boundary = Quadtree::AxisAlignedBoundingBox.new(Quadtree::Point.new(19.8470050, 60.3747940), 8944.0)
-boundary2 = Quadtree::AxisAlignedBoundingBox.new(Quadtree::Point.new(19.8470050, 60.3747940), 4472.0)
-qt.insert! getaboden
-qt.insert! knutnas
-qt.query_range(boundary2)
-# [#<Quadtree::Point:0x00007fdcb19e0698 @data="Getaboden", @x=19.847005, @y=60.374794>,
- #<Quadtree::Point:0x00007fdcb19ec7b8 @data="Knutnäs", @x=19.827117, @y=60.350557>]
-```
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number using `rake version:create` or `rake version:bump`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on Bitbucket at https://bitbucket.org/janlindblom/ruby-quadtree. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the Quadtree project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/quadtree/blob/master/CODE_OF_CONDUCT.md).
+# Quadtree
+
+![Build Status](https://codebuild.us-east-1.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoidk1aMm1Ya212SjRsU1pVdWNVZ2FRTDVPUXlVM2NsY0dWU2UxL1dEUlh2VTdxdURhcmxRK1JDTGg5OXJxeURKeFRiZXV5VEtTbmRBZCt6bTdDTms1Rm5ZPSIsIml2UGFyYW1ldGVyU3BlYyI6ImlUamttMGtUckZRT0tvM0EiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
+[![Bitbucket Pipelines](https://img.shields.io/bitbucket/pipelines/janlindblom/ruby-quadtree.png)](https://bitbucket.org/janlindblom/ruby-quadtree)
+[![Gem](https://img.shields.io/gem/v/quadtree.png)](https://rubygems.org/gems/quadtree)
+[![Documentation](https://img.shields.io/badge/docs-rdoc.info-yellow.png)](http://www.rubydoc.info/gems/quadtree/frames)
+
+Quadtrees in Ruby. For searching spatially related nodes in some space, you know.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'quadtree'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install quadtree
+
+## Usage
+
+Load it in your code to start building quadtrees:
+
+```ruby
+require 'quadtree'
+
+boundary = Quadtree::AxisAlignedBoundingBox.new(Quadtree::Point.new(19.8470050, 60.3747940), 8944.0)
+qt = Quadtree::Quadtree.new(boundary)
+```
+
+Then you can do lookups and such:
+
+```ruby
+getaboden = Quadtree::Point.new(19.8470050, 60.3747940, "Getaboden")
+knutnas = Quadtree::Point.new(19.8271170, 60.3505570, "Knutnäs")
+boundary = Quadtree::AxisAlignedBoundingBox.new(Quadtree::Point.new(19.8470050, 60.3747940), 8944.0)
+boundary2 = Quadtree::AxisAlignedBoundingBox.new(Quadtree::Point.new(19.8470050, 60.3747940), 4472.0)
+qt.insert! getaboden
+qt.insert! knutnas
+qt.query_range(boundary2)
+# [#<Quadtree::Point:0x00007fdcb19e0698 @data="Getaboden", @x=19.847005, @y=60.374794>,
+ #<Quadtree::Point:0x00007fdcb19ec7b8 @data="Knutnäs", @x=19.827117, @y=60.350557>]
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number using `rake version:create` or `rake version:bump`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on Bitbucket at https://bitbucket.org/janlindblom/ruby-quadtree. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Quadtree project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://bitbucket.org/janlindblom/ruby-quadtree/src/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,64 +1,69 @@
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-
-require "rake/version_task"
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-require "yard"
-require "yard/rake/yardoc_task"
-require 'rubocop/rake_task'
-require "quadtree"
-
-RSpec::Core::RakeTask.new(:spec)
-
-spec = Gem::Specification.new do |s|
-  s.name          = "quadtree"
-  s.version       = Quadtree::VERSION
-  s.authors       = ["Jan Lindblom"]
-  s.email         = ["janlindblom@fastmail.fm"]
-
-  s.summary       = %q{Quadtrees in Ruby.}
-  s.homepage      = "https://bitbucket.org/janlindblom/ruby-quadtree"
-  s.license       = "MIT"
-
-  s.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(bin|test|spec|features)/}) ||
-    f == ".travis.yml" ||
-    f == "bitbucket-pipelines.yml" ||
-    f == "buildspec.yml"
-  end
-  s.bindir        = "exe"
-  s.executables   = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  s.require_paths = ["lib"]
-
-  s.required_ruby_version = '>= 2.3.0'
-
-  s.add_development_dependency "bundler", "~> 1.14"
-  s.add_development_dependency "rake", "~> 10.0"
-  s.add_development_dependency "rspec", "~> 3.0"
-  s.add_development_dependency "pry", "~> 0.11"
-  s.add_development_dependency "yard", "~> 0.9"
-  s.add_development_dependency "simplecov", "~> 0.16"
-  s.add_development_dependency "rubocop", "~> 0.54"
-  s.add_runtime_dependency "version", "~> 1.1"
-end
-
-Rake::VersionTask.new do |task|
-  task.with_gemspec = spec
-  task.with_git = false
-end
-
-YARD::Rake::YardocTask.new do |t|
-  t.files   = ['lib/**/*.rb']
-  t.stats_options = ['--list-undoc']
-end
-
-RuboCop::RakeTask.new(:rubocop) do |task|
-  task.patterns = ['lib/**/*.rb']
-  # only show the files with failures
-  task.formatters = ['worst']
-  # don't abort rake on failure
-  task.fail_on_error = false
-end
-
-task :default => :spec
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "rake/version_task"
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "yard"
+require "yard/rake/yardoc_task"
+require 'rubocop/rake_task'
+require "quadtree"
+
+RSpec::Core::RakeTask.new(:spec)
+
+spec = Gem::Specification.new do |s|
+  s.name          = "quadtree"
+  s.version       = Quadtree::VERSION
+  s.authors       = ["Jan Lindblom"]
+  s.email         = ["janlindblom@fastmail.fm"]
+
+  s.summary       = %q{Quadtrees in Ruby.}
+  s.homepage      = "https://bitbucket.org/janlindblom/ruby-quadtree"
+  s.license       = "MIT"
+
+  s.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(bin|test|spec|features)/}) ||
+    f == ".travis.yml" ||
+    f == ".gitignore" ||
+    f == ".editorconfig" ||
+    f == ".rspec" ||
+    f == "bitbucket-pipelines.yml" ||
+    f == "buildspec.yml" ||
+    f == ".gitlab-ci.yml"
+  end
+  s.bindir        = "exe"
+  s.executables   = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.required_ruby_version = '>= 2.3.0'
+
+  s.add_development_dependency "bundler", "~> 2"
+  s.add_development_dependency "rake", "~> 13.0"
+  s.add_development_dependency "rspec", "~> 3.9"
+  s.add_development_dependency "pry", "~> 0.13"
+  s.add_development_dependency "yard", "~> 0.9"
+  s.add_development_dependency "simplecov", "~> 0.18"
+  s.add_development_dependency "rspec_junit_formatter", "~> 0.4"
+  s.add_development_dependency "rubocop", "~> 0.85"
+  s.add_runtime_dependency "version", "~> 1.1"
+end
+
+Rake::VersionTask.new do |task|
+  task.with_gemspec = spec
+  task.with_git = false
+end
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.stats_options = ['--list-undoc']
+end
+
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.patterns = ['lib/**/*.rb']
+  # only show the files with failures
+  task.formatters = ['worst']
+  # don't abort rake on failure
+  task.fail_on_error = false
+end
+
+task :default => :spec

data/VERSION

@@ -1 +1 @@
-1.0.7
+1.0.8

data/lib/quadtree.rb

@@ -1,14 +1,16 @@
-require "version"
-require "quadtree/version"
-
-require "quadtree/unknown_type_error"
-
-require "quadtree/point"
-require "quadtree/axis_aligned_bounding_box"
-require "quadtree/quadtree"
-
-# Quadtrees.
-#
-# @author Jan Lindblom <janlindblom@fastmail.fm>
-module Quadtree
-end
+# frozen_string_literal: true
+
+require 'version'
+require 'quadtree/version'
+
+require 'quadtree/unknown_type_error'
+
+require 'quadtree/point'
+require 'quadtree/axis_aligned_bounding_box'
+require 'quadtree/quadtree'
+
+# Quadtrees.
+#
+# @author Jan Lindblom <janlindblom@fastmail.fm>
+module Quadtree
+end

data/lib/quadtree/axis_aligned_bounding_box.rb

@@ -1,108 +1,155 @@
-module Quadtree
-  # Axis-aligned bounding box with half dimension and center.
-  class AxisAlignedBoundingBox
-
-    # Center {Point} of this instance.
-    #
-    # @return [Point] the {Point} marking the center of this instance.
-    attr_accessor :center
-
-    # Half dimension of this instance (distance from the center {Point} to the
-    # edge).
-    #
-    # @return [Float] distance from the center {Point} to the edge.
-    attr_accessor :half_dimension
-
-    # @param center [Point]
-    # @param half_dimension [Float]
-    def initialize(center, half_dimension)
-      @center = center
-      @half_dimension = half_dimension.to_f
-    end
-
-    # Check if this instance contains a given {Point}.
-    #
-    # @param point [Point] the {Point} to check for.
-    # @return [Boolean] +true+ if given {Point} is contained, +false+
-    #   otherwise.
-    def contains_point?(point)
-      if point.x >= self.center.x - self.half_dimension &&
-          point.x <= self.center.x + self.half_dimension
-        if point.y >= self.center.y - self.half_dimension &&
-          point.y <= self.center.y + self.half_dimension
-          return true
-        end
-      end
-      false
-    end
-
-    # Check if this instance intersects with another instance.
-    #
-    # @param other [AxisAlignedBoundingBox] the other instance to check for.
-    # @return [Boolean] +true+ if these intersects, +false+ otherwise.
-    def intersects?(other)
-      other_lt_corner = Point.new(other.left, other.top)
-      other_rt_corner = Point.new(other.right, other.top)
-      other_lb_corner = Point.new(other.left, other.bottom)
-      other_rb_corner = Point.new(other.right, other.bottom)
-
-      [
-        other_lt_corner,
-        other_rt_corner,
-        other_lb_corner,
-        other_rb_corner
-      ].each do |corner|
-        return true if self.contains_point?(corner)
-      end
-      false
-    end
-
-    # Get the X coordinate of the left edge of this instance.
-    #
-    # @return [Float] the X coordinate of the left edge of this instance.
-    def left
-      @center.x - @half_dimension
-    end
-
-    # Get the X coordinate of the right edge of this instance.
-    #
-    # @return [Float] the X coordinate of the right edge of this instance.
-    def right
-      @center.x + @half_dimension
-    end
-
-    # Get the Y coordinate of the top edge of this instance.
-    #
-    # @return [Float] the Y coordinate of the top edge of this instance.
-    def top
-      @center.y + @half_dimension
-    end
-
-    # Get the Y coordinate of the bottom edge of this instance.
-    #
-    # @return [Float] the Y coordinate of the bottom edge of this instance.
-    def bottom
-      @center.y - @half_dimension
-    end
-
-    # Get the width of this instance.
-    #
-    # @return [Float]
-    def width
-      span
-    end
-
-    # Get the height of this instance.
-    #
-    # @return [Float]
-    def height
-      span
-    end
-
-    private
-
-    def span
-      @half_dimension * 2
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Quadtree
+  # Axis-aligned bounding box with half dimension and center.
+  class AxisAlignedBoundingBox
+    # Center {Point} of this instance.
+    #
+    # @return [Point] the {Point} marking the center of this instance.
+    attr_accessor :center
+
+    # Half dimension of this instance (distance from the center {Point} to the
+    # edge).
+    #
+    # @return [Float] distance from the center {Point} to the edge.
+    attr_accessor :half_dimension
+
+    # @param center [Point]
+    # @param half_dimension [Float]
+    def initialize(center, half_dimension)
+      @center = center
+      @half_dimension = half_dimension.to_f
+    end
+
+    #
+    # Create a Hash for this {AxisAlignedBoundingBox}.
+    #
+    # @return [Hash] Hash representation of this {AxisAlignedBoundingBox}.
+    #
+    def to_h
+      {
+        'center': center.to_h,
+        'half_dimension': half_dimension
+      }
+    end
+
+    #
+    # Create a Hash for this {AxisAlignedBoundingBox}.
+    #
+    # @return [Hash] Hash representation of this {AxisAlignedBoundingBox}.
+    #
+    def to_hash
+      to_h
+    end
+
+    #
+    # Create a JSON String representation of this {AxisAlignedBoundingBox}.
+    #
+    # @return [String] JSON String of this {AxisAlignedBoundingBox}.
+    #
+    def to_json(*_args)
+      require 'json'
+      to_h.to_json
+    end
+
+    #
+    # Create a String for this {AxisAlignedBoundingBox}.
+    #
+    # @return [String] String representation of this {AxisAlignedBoundingBox}.
+    #
+    def to_s
+      to_h.to_s
+    end
+
+    #
+    # Construct a {AxisAlignedBoundingBox} from a JSON String.
+    #
+    # @param [String] json_data input JSON String.
+    #
+    # @return [AxisAlignedBoundingBox] the {AxisAlignedBoundingBox} contained in the JSON String.
+    #
+    def self.from_json(json_data)
+      new(Point.from_json(json_data['center']), json_data['half_dimension'])
+    end
+
+    # Check if this instance contains a given {Point}.
+    #
+    # @param point [Point] the {Point} to check for.
+    # @return [Boolean] +true+ if given {Point} is contained, +false+
+    #   otherwise.
+    def contains_point?(point)
+      if point.x >= center.x - half_dimension &&
+         point.x <= center.x + half_dimension
+        if point.y >= center.y - half_dimension &&
+           point.y <= center.y + half_dimension
+          return true
+        end
+      end
+      false
+    end
+
+    # Check if this instance intersects with another instance.
+    #
+    # @param other [AxisAlignedBoundingBox] the other instance to check for.
+    # @return [Boolean] +true+ if these intersects, +false+ otherwise.
+    def intersects?(other)
+      other_lt_corner = Point.new(other.left, other.top)
+      other_rt_corner = Point.new(other.right, other.top)
+      other_lb_corner = Point.new(other.left, other.bottom)
+      other_rb_corner = Point.new(other.right, other.bottom)
+
+      [other_lt_corner, other_rt_corner, other_lb_corner, other_rb_corner].each do |corner|
+        return true if contains_point?(corner)
+      end
+      false
+    end
+
+    # Get the X coordinate of the left edge of this instance.
+    #
+    # @return [Float] the X coordinate of the left edge of this instance.
+    def left
+      @center.x - @half_dimension
+    end
+
+    # Get the X coordinate of the right edge of this instance.
+    #
+    # @return [Float] the X coordinate of the right edge of this instance.
+    def right
+      @center.x + @half_dimension
+    end
+
+    # Get the Y coordinate of the top edge of this instance.
+    #
+    # @return [Float] the Y coordinate of the top edge of this instance.
+    def top
+      @center.y + @half_dimension
+    end
+
+    # Get the Y coordinate of the bottom edge of this instance.
+    #
+    # @return [Float] the Y coordinate of the bottom edge of this instance.
+    def bottom
+      @center.y - @half_dimension
+    end
+
+    # Get the width of this instance.
+    #
+    # @return [Float]
+    def width
+      span
+    end
+
+    # Get the height of this instance.
+    #
+    # @return [Float]
+    def height
+      span
+    end
+
+    private
+
+    def span
+      @half_dimension * 2
+    end
+  end
+end