simplify_rb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e13939f627822e4b0114f8d60c15a31788f0a03d
+  data.tar.gz: 41a9e75f2bd598f291849286f468b9bfd42b9829
+SHA512:
+  metadata.gz: 3e4a59ca16d463d9b236add0318e1ebad3fe5907652001bd7a85b8c7e9a542168be5d1a5dc4c266cf13fa79f8216f5e327e778723ecfc5934addae64aefd7789
+  data.tar.gz: 1ccd9699ab4066cb5903191334ea39a21d2425aa9788934bce288f7204a8aceaae1f826c1f53c7cb2122f50ca31fed3469e097353f4b5600a76674e578fdecc4

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in simplify_rb.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 odlp
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+# SimplifyRb - Polyline simplification
+
+SimplifyRb is a Ruby port of [simplify.js](https://github.com/mourner/simplify-js) by Vladimir Agafonkin. 
+
+You can use this gem to reduce the number of points in a complex polyline / polygon, making use of an optimized Douglas-Peucker algorithm.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'simplify_rb'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install simplify_rb
+
+## Usage
+
+```ruby
+require 'simplify_rb'
+
+SimplifyRb.simplify(points, tolerance, high_quality)
+```
+
+```points```: An array of hashes, containing x,y coordinates: ```{x: 51.5256, y: -0.0875}```
+
+```tolerance```: (optional, 1 by default): Affects the amount of simplification that occurs (the smaller, the less simplification)
+
+```highestQuality```: (optional, False by default): Flag to exclude the distance pre-processing. Produces higher quality results when true is passed, but runs slower

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/simplify_rb.rb

@@ -0,0 +1,113 @@
+require "simplify_rb/version"
+
+class SimplifyRb
+  # Main method
+  def self.simplify (points, tolerance=1, highest_quality=false)
+    return points if points.length <= 1
+
+    points = symbolize_keys(points) unless keys_are_symbols?(points.map{|p| p.keys})
+
+    sq_tolerance = tolerance * tolerance
+  
+    # Optimisation step 1
+    points = simplifyRadialDist(points, sq_tolerance) unless highest_quality
+    
+    # Optimisation step 2
+    simplifyDouglasPeucker(points, sq_tolerance)
+  end
+
+  # Basic distance-based simplification
+  def self.simplifyRadialDist (points, sq_tolerance)
+    new_points = [points.first]
+
+    points.each do |point|
+      new_points << point if (getSqDist(point, new_points.last) > sq_tolerance)
+    end
+
+    new_points << points.last unless new_points.last == points.last
+
+    new_points
+  end
+
+  # Simplification using optimized Douglas-Peucker algorithm with recursion elimination
+  def self.simplifyDouglasPeucker (points, sq_tolerance)
+    length  = points.length
+    first   = 0
+    last    = length - 1
+    index   = nil
+    stack   = []
+
+    points.first[:keep] = true
+    points.last[:keep]  = true
+
+    while last do
+      max_sq_dist = 0
+
+      ((first + 1)...last).each do |i|
+        sq_dist = getSqSegDist(points[i], points[first], points[last])
+
+        if sq_dist > max_sq_dist
+          index = i
+          max_sq_dist = sq_dist
+        end
+      end
+
+      if max_sq_dist > sq_tolerance
+        points[index][:keep] = true
+
+        stack.push(first, index, index, last)
+      end
+
+      last  = stack.pop
+      first = stack.pop
+
+    end # end while
+
+    points.keep_if { |p| p[:keep] && p.delete(:keep) }
+  end
+
+  # Square distance between two points
+  def self.getSqDist (point_1, point_2)
+    dx = point_1[:x] - point_2[:x]
+    dy = point_1[:y] - point_2[:y]
+
+    dx * dx + dy * dy
+  end
+
+  # Square distance from a point to a segment
+  def self.getSqSegDist (point, point_1, point_2)
+    x  = point_1[:x]
+    y  = point_1[:y]
+    dx = point_2[:x] - x
+    dy = point_2[:y] - y
+
+    if (dx != 0 || dy != 0)
+      t = ((point[:x] - x) * dx + (point[:y] - y) * dy) / (dx * dx + dy * dy)
+
+      if t > 1
+        x = point_2[:x]
+        y = point_2[:y]
+      elsif t > 0
+        x += dx * t
+        y += dy * t
+      end
+    end
+
+    dx = point[:x] - x
+    dy = point[:y] - y
+
+    dx * dx + dy * dy
+  end
+
+  # Check if keys are symbols
+  def self.keys_are_symbols? (keys)
+    keys.all? {|k| k.is_a? Symbol}
+  end
+
+  # Symbolize all the hash keys in an array of hashes
+  def self.symbolize_keys (collection)
+    collection.map do |item|
+      item.each_with_object({}) { |(k,v), memo| memo[k.to_sym] = v }
+    end
+  end
+end

data/lib/simplify_rb/version.rb

@@ -0,0 +1,3 @@
+class SimplifyRb
+  VERSION = "0.1.0"
+end

data/simplify_rb.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'simplify_rb/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "simplify_rb"
+  spec.version       = SimplifyRb::VERSION
+  spec.authors       = ["odlp"]
+  spec.description   = "You can use this gem to reduce the number of points in a complex polyline / polygon, making use of an optimized Douglas-Peucker algorithm."
+  spec.summary       = "Polyline simplification library. Ruby port of Simplify.js."
+  spec.homepage      = "https://github.com/odlp/simplify_rb"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake", "~> 10"
+  spec.add_development_dependency "rspec", "~> 3"
+end

data/spec/simplify_rb_spec.rb

@@ -0,0 +1,43 @@
+require "spec_helper"
+
+describe SimplifyRb do
+  context "simplifies points correctly with the given tolerance" do
+    before(:each) {@test_data = SimplifyTestData::points}
+
+    it "with the fast strategy (default)" do
+      expect(SimplifyRb.simplify(@test_data, 5)).to eq(SimplifyTestData::result_fast)
+    end
+
+    it "with the high quality strategy" do
+      expect(SimplifyRb.simplify(@test_data, 5, true)).to eq(SimplifyTestData::result_high_quality)
+    end
+  end
+
+  it "returns the points if it has only one point" do
+    data = [{x: 1, y: 2}]
+
+    expect(SimplifyRb.simplify(data)).to eq(data)
+  end
+
+  it "returns the array if it has no points" do
+    expect(SimplifyRb.simplify([])).to eq([])
+  end
+
+  context "#keys_are_symbols?" do
+    it "should return false if any key is not a Symbol" do
+      expect(SimplifyRb.keys_are_symbols? [:a, 'b', :c]).to equal(false)
+    end
+
+    it "should return true if all the keys are Symbols" do
+      expect(SimplifyRb.keys_are_symbols? [:a, :b, :c]).to equal(true)
+    end
+  end
+
+  context "#symbolize_keys" do
+    it "should convert all of the collection's keys to symbols" do
+      collection = [{'a' => 1, 'b' => 2}, {'c' => 3}]
+
+      expect(SimplifyRb.symbolize_keys(collection)).to eq([{a: 1, b: 2}, {c: 3}])
+    end
+  end
+end

data/spec/simplify_test_data.rb

@@ -0,0 +1,57 @@
+module SimplifyTestData
+  def self.points
+    [
+      {x:224.55,y:250.15},{x:226.91,y:244.19},{x:233.31,y:241.45},{x:234.98,y:236.06},
+      {x:244.21,y:232.76},{x:262.59,y:215.31},{x:267.76,y:213.81},{x:273.57,y:201.84},
+      {x:273.12,y:192.16},{x:277.62,y:189.03},{x:280.36,y:181.41},{x:286.51,y:177.74},
+      {x:292.41,y:159.37},{x:296.91,y:155.64},{x:314.95,y:151.37},{x:319.75,y:145.16},
+      {x:330.33,y:137.57},{x:341.48,y:139.96},{x:369.98,y:137.89},{x:387.39,y:142.51},
+      {x:391.28,y:139.39},{x:409.52,y:141.14},{x:414.82,y:139.75},{x:427.72,y:127.30},
+      {x:439.60,y:119.74},{x:474.93,y:107.87},{x:486.51,y:106.75},{x:489.20,y:109.45},
+      {x:493.79,y:108.63},{x:504.74,y:119.66},{x:512.96,y:122.35},{x:518.63,y:120.89},
+      {x:524.09,y:126.88},{x:529.57,y:127.86},{x:534.21,y:140.93},{x:539.27,y:147.24},
+      {x:567.69,y:148.91},{x:575.25,y:157.26},{x:580.62,y:158.15},{x:601.53,y:156.85},
+      {x:617.74,y:159.86},{x:622.00,y:167.04},{x:629.55,y:194.60},{x:638.90,y:195.61},
+      {x:641.26,y:200.81},{x:651.77,y:204.56},{x:671.55,y:222.55},{x:683.68,y:217.45},
+      {x:695.25,y:219.15},{x:700.64,y:217.98},{x:703.12,y:214.36},{x:712.26,y:215.87},
+      {x:721.49,y:212.81},{x:727.81,y:213.36},{x:729.98,y:208.73},{x:735.32,y:208.20},
+      {x:739.94,y:204.77},{x:769.98,y:208.42},{x:779.60,y:216.87},{x:784.20,y:218.16},
+      {x:800.24,y:214.62},{x:810.53,y:219.73},{x:817.19,y:226.82},{x:820.77,y:236.17},
+      {x:827.23,y:236.16},{x:829.89,y:239.89},{x:851.00,y:248.94},{x:859.88,y:255.49},
+      {x:865.21,y:268.53},{x:857.95,y:280.30},{x:865.48,y:291.45},{x:866.81,y:298.66},
+      {x:864.68,y:302.71},{x:867.79,y:306.17},{x:859.87,y:311.37},{x:860.08,y:314.35},
+      {x:858.29,y:314.94},{x:858.10,y:327.60},{x:854.54,y:335.40},{x:860.92,y:343.00},
+      {x:856.43,y:350.15},{x:851.42,y:352.96},{x:849.84,y:359.59},{x:854.56,y:365.53},
+      {x:849.74,y:370.38},{x:844.09,y:371.89},{x:844.75,y:380.44},{x:841.52,y:383.67},
+      {x:839.57,y:390.40},{x:845.59,y:399.05},{x:848.40,y:407.55},{x:843.71,y:411.30},
+      {x:844.09,y:419.88},{x:839.51,y:432.76},{x:841.33,y:441.04},{x:847.62,y:449.22},
+      {x:847.16,y:458.44},{x:851.38,y:462.79},{x:853.97,y:471.15},{x:866.36,y:480.77}
+    ]
+  end
+
+  def self.result_fast
+    [
+      {x:224.55,y:250.15},{x:267.76,y:213.81},{x:296.91,y:155.64},{x:330.33,y:137.57},
+      {x:409.52,y:141.14},{x:439.6,y:119.74},{x:486.51,y:106.75},{x:529.57,y:127.86},
+      {x:539.27,y:147.24},{x:617.74,y:159.86},{x:629.55,y:194.6},{x:671.55,y:222.55},
+      {x:727.81,y:213.36},{x:739.94,y:204.77},{x:769.98,y:208.42},{x:779.6,y:216.87},
+      {x:800.24,y:214.62},{x:820.77,y:236.17},{x:859.88,y:255.49},{x:865.21,y:268.53},
+      {x:857.95,y:280.3},{x:867.79,y:306.17},{x:859.87,y:311.37},{x:854.54,y:335.4},
+      {x:860.92,y:343},{x:849.84,y:359.59},{x:854.56,y:365.53},{x:844.09,y:371.89},
+      {x:839.57,y:390.4},{x:848.4,y:407.55},{x:839.51,y:432.76},{x:853.97,y:471.15},
+      {x:866.36,y:480.77}]
+  end
+
+  def self.result_high_quality
+    [{x:224.55,y:250.15},{x:267.76,y:213.81},{x:296.91,y:155.64},{x:330.33,y:137.57},
+      {x:409.52,y:141.14},{x:439.6,y:119.74},{x:486.51,y:106.75},{x:529.57,y:127.86},
+      {x:539.27,y:147.24},{x:617.74,y:159.86},{x:629.55,y:194.6},{x:671.55,y:222.55},
+      {x:727.81,y:213.36},{x:739.94,y:204.77},{x:769.98,y:208.42},{x:784.2,y:218.16},
+      {x:800.24,y:214.62},{x:820.77,y:236.17},{x:859.88,y:255.49},{x:865.21,y:268.53},
+      {x:857.95,y:280.3},{x:867.79,y:306.17},{x:858.29,y:314.94},{x:854.54,y:335.4},
+      {x:860.92,y:343},{x:849.84,y:359.59},{x:854.56,y:365.53},{x:844.09,y:371.89},
+      {x:839.57,y:390.4},{x:848.4,y:407.55},{x:839.51,y:432.76},{x:853.97,y:471.15},
+      {x:866.36,y:480.77}
+    ]
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'bundler/setup'
+require 'rspec'
+require File.expand_path '../simplify_test_data.rb', __FILE__
+require 'simplify_rb'
+
+Bundler.setup

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: simplify_rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- odlp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+description: You can use this gem to reduce the number of points in a complex polyline
+  / polygon, making use of an optimized Douglas-Peucker algorithm.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/simplify_rb.rb
+- lib/simplify_rb/version.rb
+- simplify_rb.gemspec
+- spec/simplify_rb_spec.rb
+- spec/simplify_test_data.rb
+- spec/spec_helper.rb
+homepage: https://github.com/odlp/simplify_rb
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Polyline simplification library. Ruby port of Simplify.js.
+test_files:
+- spec/simplify_rb_spec.rb
+- spec/simplify_test_data.rb
+- spec/spec_helper.rb