analytics_charts 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 239faf9fca54620fbff0cfac86d9f53e7b83b371
+  data.tar.gz: 639fa9f5fa16c0999fbec645c1587e2f94514bdd
+SHA512:
+  metadata.gz: 77b264d681853bf1c30a5996365b3e326956e0a29bb0926a3aa4cb6caa5947dc0e92202ee61ed7316b6022c61ee592a9ea66b3c1003570e9fea138c624a2c848
+  data.tar.gz: 7b7a7a3e50b27f3bc1bd2aa97c82a80c2ab5c2d828b9fcb67f3a5d34f4a44f19e96d77a58baab2ebb54d5eae4e3ae5c7f6d30d831fba571d300066ab6addce69

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/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 STEPHEN YU
+
+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,44 @@
+# AnalyticsCharts
+
+Custom library for a pie chart. Originated from the gruff library, but branched out.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'analytics_charts'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install analytics_charts
+
+## Usage
+
+#!/usr/bin/env ruby
+require 'analytics-charts'
+g = AnalyticsCharts::CustomPie.new('./yourImage.png')
+hash = {
+      'fill' => 'blue',
+      'font_family' => 'Helvetica',
+      'pointsize' => 64,
+      'font_weight' => 700
+    }
+
+g.set_pie_geometry(1242,620, 250)
+g.insert_pie_data("ndaf me3", 15.1,1)
+g.insert_pie_data("ndaf me4", 15,3)
+g.insert_pie_data("ndaf me2", 15.7,2)
+g.insert_pie_data("ndaf me1", 300.22,0)
+g.write
+
+## Contributing
+
+1. Fork it ( http://github.com/tryceattack/analytics_charts/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

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

data/analytics_charts.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'analytics_charts/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "analytics_charts"
+  spec.version       = AnalyticsCharts::VERSION
+  spec.authors       = ["STEPHEN YU"]
+  spec.email         = ["istephenyu@gmail.com"]
+  spec.summary       = %q{Chart for analytics_charts}
+  spec.description   = %q{Initially wrote code on top of gruff library. But eventually to do
+    more fined-tuned data rendering and the need for more lightweight code, I branched out to
+    this new library. Source for original code of gruff library.
+  https://github.com/topfunky/gruff/}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.5"
+  spec.add_development_dependency "rake"
+  spec.add_dependency 'rmagick'
+end

data/appendix.md

@@ -0,0 +1,20 @@
+        if small_slice_index[0] == 1 and small_slice_index[1] == 1
+          label_offset_degrees[0] = -15
+          label_offset_degrees[1] = 15
+          label_offset_degrees[2] = 15
+          label_offset_degrees[3] = -15
+        elsif small_slice_index[1] == 1 and small_slice_index[2] == 1
+          label_offset_degrees[0] = -15
+          label_offset_degrees[1] = -15
+          label_offset_degrees[2] = 15
+          label_offset_degrees[3] = 15
+        elsif small_slice_index[2] == 1 and small_slice_index[3] == 1
+          label_offset_degrees[0] = 15
+          label_offset_degrees[1] = -15
+          label_offset_degrees[2] = -15
+          label_offset_degrees[3] = 15
+        elsif small_slice_index[3] == 1 and small_slice_index[0] == 1
+          label_offset_degrees[0] = 15
+          label_offset_degrees[1] = 15
+          label_offset_degrees[2] = -15
+          label_offset_degrees[3] = -15

data/lib/analytics_charts/version.rb

@@ -0,0 +1,3 @@
+module AnalyticsCharts
+  VERSION = "0.0.1"
+end

data/lib/custom_pie.rb

@@ -0,0 +1,211 @@
+require 'RMagick'
+
+class AnalyticsCharts::CustomPie
+  include Magick
+  attr_accessor :pie_center_x
+  attr_accessor :pie_center_y
+  attr_accessor :pie_radius
+
+  def initialize(image_path)
+    @base_image = Image.read(image_path)[0]
+    @d = Draw.new
+    @data = Hash.new # Value is array with two items
+    @aggregate = Array([0,0,0,0]) # Cluster brands into categories
+    @columns = @base_image.columns
+    @rows = @base_image.rows
+    set_pie_colors(%w(#AD1F25 #BE6428 #C1B630 #1E753B))
+  end
+
+  def set_pie_geometry(x, y, radius)
+    @pie_center_x = x
+    @pie_center_y = y
+    @pie_radius = radius
+  end
+
+  def set_pie_colors(list)
+    @colors = list
+  end
+
+  def insert_pie_data(name, amount, quality)
+    #convert all '' instances to an apostrophe
+    name = name.gsub(/'/, "\'")
+    @data[name] =  [amount, quality]
+    @aggregate[quality] += amount
+  end
+
+  def insert_text(x_offset, y_offset, text, features = {})
+    features.each { |feature, attribute|
+      set_feature(feature, attribute)
+    }
+    #puts @d.get_type_metrics(@base_image, text.to_s).width,@d.get_type_metrics(@base_image, text.to_s).height,text
+    @d.annotate(@base_image, 0 ,0, x_offset, y_offset, text)
+  end
+
+  def draw
+    if @data.size > 0
+      @d = Draw.new
+      @d.stroke_width(@pie_radius)
+      total_sum = 0.0
+      prev_degrees = 60.0
+      @d.fill_opacity(0) # VERY IMPORTANT, otherwise undesired artifact can result.
+      total_sum = @aggregate.inject(:+) + 0.0 # Sum elements and make it a float
+      degrees = Array([0,0,0,0])
+      label_offset_degrees =  Array([0,0,0,0])
+      @aggregate.each_with_index do |data_row, index|
+        degrees[index] = (data_row / total_sum) * 360.0
+      end
+      num_small_slices = 0
+      small_slice_index = Array([0,0,0,0])
+      for i in 0..3
+        if degrees[i] != 0 and degrees[i] < 18.0
+          num_small_slices += 1
+          small_slice_index[i] = 1
+        end
+      end
+      for i in 0..3 # First draw slices
+        next if degrees[i] == 0
+        @d = @d.stroke @colors[i]
+        # ellipse will draw the the stroke centered on the first two parameters offset by the second two.
+        # therefore, in order to draw a circle of the proper diameter we must center the stroke at
+        # half the radius for both x and y
+        @d = @d.ellipse(@pie_center_x, @pie_center_y,
+                  @pie_radius / 2.0, @pie_radius / 2.0,
+                  prev_degrees, prev_degrees + degrees[i] + 0.5) # <= +0.5 'fudge factor' gets rid of the ugly gaps
+        prev_degrees += degrees[i]
+      end
+      # If less than two small slices, or there are two small slices that are not adjacent
+      if num_small_slices < 2 or (num_small_slices == 2 and small_slice_index[0] == small_slice_index[2])
+        #Do nothing
+      # If two adjacent small slices, push them apart. Non-adjacent case is taken care of above.
+      # I also push back the other labels too. The logic is condensed. To see original logic,
+      # consult appendix.html
+      elsif num_small_slices == 2
+        if small_slice_index[1] == 1
+          label_offset_degrees[0] = -15
+          label_offset_degrees[2] = 15
+        else
+          label_offset_degrees[0] = 15
+          label_offset_degrees[2] = -15
+        end
+        if small_slice_index[2] == 1
+          label_offset_degrees[1] = -15
+          label_offset_degrees[3] = 15
+        else
+          label_offset_degrees[1] = 15
+          label_offset_degrees[3] = -15
+        end
+      # In this case, push apart only the outside small slices.
+      elsif num_small_slices == 3
+        if small_slice_index[0] == 0
+          label_offset_degrees[1] = -15
+          label_offset_degrees[3] = 15
+        elsif small_slice_index[1] == 0
+          label_offset_degrees[2] = -15
+          label_offset_degrees[0] = 15
+        elsif small_slice_index[2] == 0
+          label_offset_degrees[3] = -15
+          label_offset_degrees[1] = 15
+        elsif small_slice_index[3] == 0
+          label_offset_degrees[0] = -15
+          label_offset_degrees[2] = 15
+        end
+      end
+      prev_degrees = 60.0 # Now focus on labels
+      @aggregate.each_with_index do |data_row, i|
+        next if degrees[i] == 0
+        half_angle = prev_degrees + degrees[i] / 2
+        label_string = '$' + data_row.to_s
+        draw_pie_label(@pie_center_x,@pie_center_y, half_angle + label_offset_degrees[i],
+          @pie_radius, label_string)
+        prev_degrees += degrees[i]
+      end
+      @d.draw(@base_image)
+    end
+  end
+
+  def write(filename='graph.png')
+    draw
+    draw_labels
+    @base_image.write(filename)
+  end
+
+  def draw_labels
+    @d.pointsize = 56
+    @d.align = LeftAlign
+    sorted_data = @data.sort_by{|key,value| -value[1]} # Sort by descending quality
+    x_offset = 180 #HARD CODED, fix later
+    y_offset = 440 #HARD CODED
+    for data in sorted_data
+      if data[1][0] > 0 # Amount > 0
+        font_weight = 900 # Very Bold
+        text = data[0] + ' <--'
+      else
+        text = data[0]
+        font_weight = 900 # Normal
+      end
+      case data[1][1]
+        when 3
+          insert_text(x_offset, y_offset, text, {'fill'=> '#1E753B', 'font_weight'=> font_weight })
+        when 2
+          insert_text(x_offset, y_offset, text, {'fill'=> '#C1B630', 'font_weight'=> font_weight })
+        when 1
+          insert_text(x_offset, y_offset, text, {'fill'=> '#BE6428', 'font_weight'=> font_weight })
+        when 0
+          insert_text(x_offset, y_offset, text, {'fill'=> '#AD1F25', 'font_weight'=> font_weight })
+      end
+      y_offset += 60 #HARD CODED, fix later
+    end
+  end
+
+  def draw_pie_label(center_x, center_y, angle, radius, percent)
+    @d.pointsize = 56 #HARD CODED, fix later
+    width = @d.get_type_metrics(@base_image, percent.to_s).width
+    ascent =  @d.get_type_metrics(@base_image, percent.to_s).ascent
+    descent =  @d.get_type_metrics(@base_image, percent.to_s).descent
+    radians = angle * Math::PI / 180.0
+    x = center_x +  radius * Math.cos(radians)
+    # By default, text is centered at bottom, so need to shift vertically to center it
+    y =  center_y + ascent / 2.0 + radius * Math.sin(radians)
+    # Imagine the text box around the text
+    # Shift text box so a corner is tangent to circle
+    if x > center_x
+      x += width / 2.0
+    end
+    if x < center_x
+      x -= width / 2.0
+    end
+    if y > center_y
+      y += ascent / 2.0
+    end
+    if y < center_y
+      y -= (ascent / 2.0 - descent) # descent to account for '$' descent,
+      # descent value retrieved is negative, so sub instead of add
+    end
+
+    @d.align = CenterAlign
+    insert_text(x, y, percent, {'fill'=> 'black', 'font_weight'=> 700})
+  end
+
+  def set_feature(feature, attribute)
+    case feature
+      when 'fill'
+        @d.fill = attribute
+      when 'font'
+        @d.font = attribute
+      when 'font_family'
+        @d.font_family = attribute
+      when 'font_stretch'
+        @d.font_stretch = attribute
+      when 'font_style'
+        @d.font_style = attribute
+      when 'font_weight'
+        @d.font_weight = attribute
+      when 'stroke'
+        @d.stroke = attribute
+      when 'pointsize'
+        @d.pointsize = attribute
+      when 'text_undercolor'
+        @d.undercolor = attribute
+    end
+  end
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: analytics_charts
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- STEPHEN YU
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |-
+  Initially wrote code on top of gruff library. But eventually to do
+      more fined-tuned data rendering and the need for more lightweight code, I branched out to
+      this new library. Source for original code of gruff library.
+    https://github.com/topfunky/gruff/
+email:
+- istephenyu@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- analytics_charts.gemspec
+- appendix.md
+- lib/analytics_charts/version.rb
+- lib/custom_pie.rb
+homepage: ''
+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.1.9
+signing_key: 
+specification_version: 4
+summary: Chart for analytics_charts
+test_files: []