color_matcher 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 11c17e7cf33220d83cfbf69c356cfa4efd80f3e1
+  data.tar.gz: 25f6955f0d58b576542c2012a84e5d2d10d2b994
+SHA512:
+  metadata.gz: 7a8307d61802d15299ad07b3af38f27c8cf1aac62c79f4c01502fb5161cd0e6c57d549ce254eb4ebadbd7ff1f580eabbb607a72a9b3f97e3d4b988f72d2466eb
+  data.tar.gz: 80c81affa292a4033b3dfcf9a1cc157278d64a4721abb075b243175191dd8824ffb72bfed572db75ffea109e841c5e9cf3ac125a96a1e656e4d567abf7f97215

data/README.md

@@ -0,0 +1,32 @@
+ColorMatcher
+======
+
+[![Build Status](https://img.shields.io/travis/chicisimo/color_matcher/master.svg)](https://travis-ci.org/chicisimo/color_matcher)
+
+ColorMatcher it's a gem that given a color, returns the nearest one from a collection.
+
+## Usage
+
+You should read the [tests](https://github.com/chicisimo/color_matcher/blob/master/spec/color_matcher_spec.rb) as they are the most updated documentation.
+
+There's only one method:
+
+```ruby
+  ColorMatcher.closest_color("000000", ["000000", "ffffff"]) # => 000000
+```
+
+## How do we use it at Chicisimo
+
+We use the color matcher at Chicisimo to match our looks with the color picked using the slider in our discover section:
+
+<p align="center">
+  <img src="doc/discover.png" width="200">
+</p>
+
+## Algorithm
+
+We are using the Euclidean distance algorithm as described [here](http://www.compuphase.com/cmetric.htm).
+
+## License
+
+ColorMatcher is open-sourced software licensed under the MIT license.

data/lib/color_matcher.rb

@@ -0,0 +1,45 @@
+module ColorMatcher
+  extend self
+
+  Match = Struct.new(:color, :proximity)
+
+  def closest_color(color, collection)
+    return if color.empty? || collection.empty?
+
+    matches = collection.map do |collection_color|
+      Match.new(collection_color, proximity_of(color, collection_color))
+    end
+
+    matches.min_by(&:proximity).color
+  end
+
+  def proximity_of(color, another_color)
+    color_red, color_green, color_blue = split_color(color)
+    another_color_red, another_color_green, another_color_blue = split_color(another_color)
+
+    color_red_mean = (color_red + another_color_red) / 2
+    color_red_gap  = color_red - another_color_red
+    color_green_gap = color_green - another_color_green
+    color_blue_gap  = color_blue - another_color_blue
+
+    euclidean_distance(color_red_mean, color_red_gap, color_green_gap, color_blue_gap)
+  end
+
+  def split_color(color)
+    red   = (color[0] + color[1]).to_i(16)
+    green = (color[2] + color[3]).to_i(16)
+    blue  = (color[4] + color[5]).to_i(16)
+
+    [red, green, blue]
+  end
+
+  def euclidean_distance(red_mean, red_gap, green_gap, blue_gap)
+    red_weight   = ((512 + red_mean) * red_gap ** 2) >> 8
+    green_weight = 4 * green_gap ** 2
+    blue_weight  = ((767 - red_mean) * blue_gap ** 2) >> 8
+
+    Math.sqrt(red_weight + green_weight + blue_weight);
+  end
+
+  private_class_method :proximity_of, :split_color, :euclidean_distance
+end

data/spec/color_matcher_spec.rb

@@ -0,0 +1,32 @@
+require "color_matcher"
+
+describe ColorMatcher do
+  it "matches an exact hex color" do
+    match = ColorMatcher.closest_color("000000", ["000000", "000001"])
+    expect(match).to eq("000000")
+  end
+
+  it "matches to the closest color" do
+    match = ColorMatcher.closest_color("fffff1", ["000001", "000002", "ffffff"])
+    expect(match).to eq("ffffff")
+
+    match = ColorMatcher.closest_color("000000", ["ffffff"])
+    expect(match).to eq("ffffff")
+
+    match = ColorMatcher.closest_color("fe0e00", ["33cc00", "fe0000"])
+    expect(match).to eq("fe0000")
+
+    match = ColorMatcher.closest_color("cdf200", ["33cc00", "867f86"])
+    expect(match).to eq("33cc00")
+  end
+
+  it "returns nil when an empty collection is given" do
+    match = ColorMatcher.closest_color("cdf200", [])
+    expect(match).to be_nil
+  end
+
+  it "returns nil when an empty color is given" do
+    match = ColorMatcher.closest_color("", ["000000", "ffffff"])
+    expect(match).to be_nil
+  end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: color_matcher
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Pedro Gimenez
+- Juan Guerrero
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Matches the nearest HEX color in a collection given a color
+email:
+- pedro@chicisimo.com
+- juan@chicisimo.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/color_matcher.rb
+- spec/color_matcher_spec.rb
+- README.md
+homepage: http://github.com/chicisimo/color_matcher
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Matches the nearest HEX color in a collection given a color
+test_files: []