colorfulness 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 61edbcd378454f2eebe6c3ee9055205060b35ad6
+  data.tar.gz: ae0a4ab32b49c0f02705e84811aa2062c76ebc50
+SHA512:
+  metadata.gz: 3dfb82ba53fe752bc7970525e92e9dc03b3c8fd783e676ccfad4634f2936d84bc53e86ac13b153c2f301f4a2dfdf08357f67ff029c5397095b1dc00e6d1dfcf2
+  data.tar.gz: 38fda323aacfd78123f92066cc8e5c5a1bf2efbc63243dc7399f9880caf964a55eaba5bda79ab7b774d13fa1a0210252a8ae7781dfdb042057d7b487f071d00a

data/.gitignore

@@ -0,0 +1,4 @@
+*.jpg
+*.png
+Gemfile.lock
+pkg

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1,19 @@
+# Colorfulness
+
+A Ruby library for calculating the colorfulness of an image, using a technique
+described in ["Measuring colourfulness in natural images" (Hasler and
+Susstrunk, 2003)][1] (See section 7: 'A More Efficient Metric').
+
+It uses ChunkyPNG to read the pixels of an image, and expects to be passed
+a ChunkyPNG `Image`.
+
+For example:
+
+```ruby
+image = ChunkyPNG::Image.from_file(path)
+calculator = Colorfulness::Calculator.new(image)
+puts image.colorfulness
+# 0.3207628365648987
+```
+
+[1]: http://infoscience.epfl.ch/record/33994/files/HaslerS03.pdf

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'  
+Bundler::GemHelper.install_tasks

data/bin/colorfulness

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+require 'colorfulness'
+
+if ARGV[0].nil?
+  raise "No input path supplied"
+end
+
+image = ChunkyPNG::Image.from_file(ARGV[0])
+processor = Colorfulness::Calculator.new(image)
+
+puts processor.colorfulness

data/colorfulness.gemspec

@@ -0,0 +1,20 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "colorfulness"
+  s.version     = "0.0.1"
+  s.authors     = ["Tom Taylor"]
+  s.email       = ["tom@tomtaylor.co.uk"]
+  s.homepage    = "https://github.com/tomtaylor/colorfulness"
+  s.summary     = "Ruby library to calculate the colorfulness of a ChunkyPNG Image"
+
+  s.files         = `git ls-files`.split($\)
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ["lib"]
+  s.executables   = ["colorfulness"]
+
+  s.add_dependency "chunky_png", '~> 1.2.9'
+  s.add_dependency "oily_png", '~> 1.1.0'
+
+  s.add_development_dependency "rake"
+end

data/lib/colorfulness/calculator.rb

@@ -0,0 +1,53 @@
+require 'chunky_png'
+require 'oily_png'
+
+module Colorfulness
+  class Calculator
+
+    def initialize(image)
+      @image = image
+    end
+
+    # Technique from https://gist.github.com/zabela/8539116, a MATLAB
+    # implementation of the algorithm described in "Measuring colourfulness in
+    # natural images" (Hasler and Susstrunk, 2003).
+    def colorfulness
+      rg = []
+      yb = []
+
+      (0...@image.width).each do |x|
+        (0...@image.height).each do |y|
+          pixel = @image.get_pixel(x, y)
+          rgb = ChunkyPNG::Color.to_truecolor_bytes(pixel)
+          r, g, b = rgb.map { |c| c.to_f / ChunkyPNG::Color::MAX }
+
+          rg << (r - g).abs
+          yb << ((0.5 * (r + g)) - b).abs
+        end
+      end
+
+      rg_std  = calculate_standard_deviation(rg)
+      rg_mean = calculate_mean(rg)
+
+      yb_std  = calculate_standard_deviation(yb)
+      yb_mean = calculate_mean(yb)
+
+      rg_yb_std = Math.sqrt(rg_std**2 + yb_std**2)
+      rg_yb_mean = Math.sqrt(rg_mean**2 + yb_mean**2)
+
+      rg_yb_std + (rg_yb_mean * 0.3)
+    end
+
+    private
+
+    def calculate_standard_deviation(array)
+      mean = calculate_mean(array)
+      Math.sqrt(array.inject(0) { |sum,val| sum + (val - mean)**2 } / array.size)
+    end
+
+    def calculate_mean(array)
+      array.inject(:+).to_f / array.size
+    end
+
+  end
+end

data/lib/colorfulness.rb

@@ -0,0 +1 @@
+require 'colorfulness/calculator'

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: colorfulness
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Tom Taylor
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.9
+- !ruby/object:Gem::Dependency
+  name: oily_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: 
+email:
+- tom@tomtaylor.co.uk
+executables:
+- colorfulness
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- bin/colorfulness
+- colorfulness.gemspec
+- lib/colorfulness.rb
+- lib/colorfulness/calculator.rb
+homepage: https://github.com/tomtaylor/colorfulness
+licenses: []
+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: Ruby library to calculate the colorfulness of a ChunkyPNG Image
+test_files: []