samhendley-scruffy 0.2.7

data/lib/scruffy/renderers/split.rb

@@ -0,0 +1,48 @@
+module Scruffy
+  module Renderers
+    # Renderer that splits the graphs up into four other little graphs.
+    class Split < Empty
+      def define_layout
+        super do |components|
+          components << Scruffy::Components::Title.new(:title, :position => [5, 2], :size => [90, 7])
+          components << Scruffy::Components::Label.new(:label_one, :text => self.options[:split_label] || '', 
+                                                      :position => [30, 54.5], :size => [40, 3])
+
+          # Viewports
+          components << Scruffy::Components::Viewport.new(:top, :position => [3, 20], 
+                                                         :size => [90, 30], &graph_block(:top))
+          components << Scruffy::Components::Viewport.new(:bottom, :position => [3, 65], 
+                                                         :size => [90, 30], &graph_block(:bottom))
+        
+          components << Scruffy::Components::Legend.new(:legend, :position => [5, 11], :size => [90, 4])
+        end
+      end
+
+      protected
+        def labels
+          [component(:top).component(:labels), component(:bottom).component(:labels)]
+        end
+    
+        def values
+          [component(:top).component(:values), component(:bottom).component(:values)]
+        end
+      
+        def grids
+          [component(:top).component(:grid), component(:bottom).component(:grid)]
+        end
+      
+
+      private
+        def graph_block(graph_filter)
+          block = Proc.new { |components|
+            components << Scruffy::Components::Grid.new(:grid, :position => [10, 0], :size => [90, 89])
+            components << Scruffy::Components::ValueMarkers.new(:values, :position => [0, 2], :size => [8, 89])
+            components << Scruffy::Components::DataMarkers.new(:labels, :position => [10, 92], :size => [90, 8])
+            components << Scruffy::Components::Graphs.new(:graphs, :position => [10, 0], :size => [90, 89], :only => graph_filter)
+          }
+          
+          block
+        end
+    end
+  end
+end

data/lib/scruffy/renderers/standard.rb

@@ -0,0 +1,36 @@
+module Scruffy::Renderers
+  class Standard < Empty
+    
+    def define_layout
+      super do |components|
+        components << Scruffy::Components::Title.new(:title, :position => [5, 2], :size => [90, 7])
+        components << Scruffy::Components::Viewport.new(:view, :position => [2, 26], :size => [89, 66]) do |graph|
+          graph << Scruffy::Components::ValueMarkers.new(:values, :position => [0, 2], :size => [18, 89])
+          graph << Scruffy::Components::Grid.new(:grid, :position => [20, 0], :size => [80, 89], :stroke_width => 1)
+          graph << Scruffy::Components::DataMarkers.new(:labels, :position => [20, 92], :size => [80, 8])
+          graph << Scruffy::Components::Graphs.new(:graphs, :position => [20, 0], :size => [80, 89])
+        end
+        components << Scruffy::Components::Legend.new(:legend, :position => [5, 13], :size => [90, 6])
+      end
+    end
+    
+    protected
+      def hide_values
+        super
+        component(:view).position[0] = -10
+        component(:view).size[0] = 100
+      end
+    
+      def labels
+        [component(:view).component(:labels)]
+      end
+    
+      def values
+        [component(:view).component(:values)]
+      end
+      
+      def grids
+        [component(:view).component(:grid)]
+      end
+  end
+end

data/lib/scruffy/renderers.rb

@@ -0,0 +1,22 @@
+# ===Scruffy Renderers
+#
+# Author:: Brasten Sager
+# Date:: August 14th, 2006
+#
+# Renderers piece the entire graph together from a collection
+# of components.  Creating new renderers allows you to create
+# entirely new layouts for your graphs.
+#
+# Scruffy::Renderers::Base contains the basic functionality needed
+# by a layout.  The easiest way to create a new layout is by subclassing
+# Base.
+module Scruffy::Renderers; end
+
+require 'scruffy/renderers/base'
+require 'scruffy/renderers/empty'
+require 'scruffy/renderers/standard'
+require 'scruffy/renderers/reversed'
+require 'scruffy/renderers/cubed'
+require 'scruffy/renderers/split'
+require 'scruffy/renderers/cubed3d'
+require 'scruffy/renderers/pie'

data/lib/scruffy/themes.rb

@@ -0,0 +1,156 @@
+# ===Scruffy Themes
+#
+# Author:: Brasten Sager & A.J. Ostman
+# Date:: August 27th, 2006
+#
+# Scruffy Themes allow you to alter the colors and appearances of
+# your graph.
+module Scruffy::Themes
+  
+  # ==Scruffy::Themes::Base
+  #
+  # Author:: Brasten Sager & A.J. Ostman
+  # Date:: August 27th, 2006
+  #
+  # The base theme class.  Most themes can be constructed simply
+  # by instantiating a new Base object with a hash of color values.
+  #
+  # See Scruffy::Themes::Base#instantiate for examples.
+  class Base
+    attr_accessor :background     # Background color or array of two colors
+    attr_accessor :colors         # Array of colors for data graphs
+    attr_accessor :marker         # Marker color for grid lines, values, etc.
+    attr_accessor :font_family    # Font family: Not really supported.  Maybe in the future.
+
+    # Returns a new Scruffy::Themes::Base object.
+    #
+    # Hash options:
+    # background:: background color.
+    # colors:: an array of color values to use for graphs.
+    # marker:: color used for grid lines, values, data points, etc.
+    # font_family:: in general, allows you to change the font used in the graph.
+    #               This is not yet supported in most graph elements, 
+    #               and may be deprecated soon anyway.
+    def initialize(descriptor)
+      self.background = descriptor[:background]
+      self.colors     = descriptor[:colors]
+      self.marker     = descriptor[:marker]
+      self.font_family = descriptor[:font_family]
+    end
+    
+    # Returns the next available color in the color array.
+    def next_color
+      @previous_color = 0 if @previous_color.nil?
+      @previous_color += 1
+              
+      self.colors[(@previous_color-1) % self.colors.size]
+    end
+
+    # todo: Implement darken function.
+    def darken(color, shift=20); end
+    
+    # todo: Implement lighten function.
+    def lighten(color, shift=20); end
+    
+  end
+  
+
+  
+  # A basic default theme
+  # Based on http://www.wellstyled.com/tools/colorscheme2/index-en.html?tetrad;50;0;255;1;-1;1;-0.6;0.1;1;0.6;1;1;-1;1;-0.6;0.1;1;0.6;1;1;-1;1;-0.6;0.1;1;0.6;1;1;-1;1;-0.6;0.1;1;0.6;1;0
+  class Standard < Base
+    def initialize
+      super({
+              :background => ['#FFFFFF', '#FFFFFF'],
+              :marker => '#999999',
+              :colors => %w(#1919B3 #FFB200 #FFFF00 #660099 #E9E9FF #FFF7E6 #FFFFE6 #F7E6FF #0F0F6B #996B00 #999900 #3D005C)
+            })
+    
+    end
+  end
+  
+  # Keynote theme, based on Apple's Keynote presentation software.
+  #
+  # Color values used from Gruff's default theme.
+  class Keynote < Base
+    def initialize
+      super({  
+              :background => [:black, '#4A465A'],
+              :marker => :white, 
+              :colors => %w(#6886B4 #FDD84E #72AE6E #D1695E #8A6EAF #EFAA43 white)
+             })
+    end
+  end
+
+  # Roughly, roughly based on the color scheme of www.mephistoblog.com.
+  class Mephisto < Base
+    def initialize
+      super({
+              :background => ['#101010', '#999977'],
+              :marker => :white,
+              :colors => %w(#DD3300 #66AABB #225533 #992200)
+            })
+      
+    end
+  end
+  
+  # Based on the color scheme used by almost every Ruby blogger.
+  class RubyBlog < Base
+    def initialize
+      super({
+              :background => ['#670A0A', '#831515'],
+              :marker => '#DBD1C1',
+              :colors => %w(#007777 #444477 #994444 #77FFBB #D75A20)
+            })
+    end
+  end
+  
+  # Inspired by http://www.colorschemer.com/schemes/
+  class Apples < Base
+    def initialize
+      super({
+              :background => ['#3B411F', '#4A465A'],
+              :marker => '#DBD1C1',
+              :colors => %w(#AA3322 #DD3322 #DD6644 #FFEE88 #BBCC66 #779933)
+            })
+    end
+  end
+  
+  # Inspired by http://www.colorschemer.com/schemes/  
+  class CareBears < Base
+    def initialize
+      super({
+              # Playing with Sky Background
+              # :background => ['#2774B6', '#5EA6D8'],
+              # :marker => :white,
+              :background => [:black, '#4A465A'],
+              :marker => :white,
+              :colors => %w(#FFBBBB #00CC33 #7788BB #EEAA44 #FFDD11 #44BBDD #DD6677)
+            })
+    end
+  end  
+  
+  
+  # Inspired by http://www.colorschemer.com/schemes/
+  class Vitamins < Base
+    def initialize
+      super({
+              :background => [:black, '#4A465A'],
+              :marker => :white,
+              :colors => %w(#CC9933 #FFCC66 #CCCC99 #CCCC33 #99CC33 #3333CC #336699 #6633CC #9999CC #333366)
+            })
+    end
+  end
+  
+  # Inspired by http://www.colorschemer.com/schemes/
+  class Tulips < Base
+    def initialize
+      super({
+              :background => ['#670A0A', '#831515'],
+              :marker => '#DBD1C1',
+              :colors => %w(#F2C8CA #BF545E #D2808E #97985C #B3B878 #A24550)
+            })
+    end
+  end
+  
+end

data/lib/scruffy/version.rb

@@ -0,0 +1,9 @@
+module Scruffy
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 2
+    TINY  = 6
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/scruffy.rb

@@ -0,0 +1,30 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+# ===Scruffy Graphing Library for Ruby
+#
+# Author:: Brasten Sager
+# Date:: August 5th, 2006
+#
+# For information on generating graphs using Scruffy, see the
+# documentation in Scruffy::Graph.
+#
+# For information on creating your own graph types, see the
+# documentation in Scruffy::Layers::Base.
+module Scruffy
+end
+  
+require 'rubygems'
+gem 'builder', '>= 2.0'
+require 'builder'
+
+require 'scruffy/helpers'
+require 'scruffy/graph_state'
+require 'scruffy/graph'
+require 'scruffy/themes'
+require 'scruffy/version'
+require 'scruffy/formatters'
+require 'scruffy/rasterizers'
+require 'scruffy/layers'
+require 'scruffy/components'
+require 'scruffy/renderers'

data/test/graph_creation_test.rb

@@ -0,0 +1,101 @@
+require 'test/unit'
+require 'scruffy'
+
+class SimpleTheme < Scruffy::Themes::Base
+  def initialize
+    super({
+        :background => [:white, :white],
+        :marker => :black,
+        :colors => %w(blue green red orange yellow purple pink),
+        :stroke_color => 'white'
+      })
+  end
+end
+
+class GraphCreationTest < Test::Unit::TestCase
+  BASE_DIR = File.dirname(__FILE__)
+  WEBSITE_DIR = BASE_DIR + "/../website/images/graphs"
+
+  def test_create_pie
+    graph = Scruffy::Graph.new
+    graph.title = "Favourite Snacks"
+    graph.renderer = Scruffy::Renderers::Pie.new
+
+    graph.add :pie, '', {
+      'Apple' => 20,
+      'Banana' => 100,
+      'Orange' => 70,
+      'Taco' => 30
+    }
+
+    graph.render :to => "#{WEBSITE_DIR}/pie_test.svg"
+    graph.render :width => 400, :to => "#{WEBSITE_DIR}/pie_test.png", :as => 'png'
+  end
+  
+  def test_create_line
+    graph = Scruffy::Graph.new
+    graph.title = "Sample Line Graph"
+    graph.renderer = Scruffy::Renderers::Standard.new
+
+    graph.add :line, 'Example', [20, 100, 70, 30, 106]
+
+    graph.render :to => "#{WEBSITE_DIR}/line_test.svg"
+    graph.render  :width => 400, :to => "#{WEBSITE_DIR}/line_test.png", :as => 'png'
+  end
+
+  
+  def test_create_bar
+    graph = Scruffy::Graph.new
+    graph.title = "Sample Bar Graph"
+    graph.renderer = Scruffy::Renderers::Standard.new
+    graph.add :bar, 'Example', [20, 100, 70, 30, 106]
+    graph.render :to => "#{WEBSITE_DIR}/bar_test.svg"
+    graph.render  :width => 400, :to => "#{WEBSITE_DIR}/bar_test.png", :as => 'png'
+  end
+  
+  def test_split
+    graph = Scruffy::Graph.new
+    graph.title = "Long-term Comparisons"
+    graph.value_formatter = Scruffy::Formatters::Currency.new(:special_negatives => true, :negative_color => '#ff7777')
+    graph.renderer = Scruffy::Renderers::Split.new(:split_label => 'Northeastern (Top) / Central (Bottom)')
+
+    graph.add :area, 'Jeff', [20, -5, 100, 70, 30, 106, 203, 100, 50, 203, 289, 20], :category => :top    
+    graph.add :area, 'Jerry', [-10, 70, 20, 102, 201, 26, 30, 106, 203, 100, 50, 39], :category => :top
+    graph.add :bar,  'Jack', [30, 0, 49, 29, 100, 203, 70, 20, 102, 201, 26, 130], :category => :bottom
+    graph.add :line, 'Brasten', [42, 10, 75, 150, 130, 70, -10, -20, 50, 92, -21, 19], :categories => [:top, :bottom]
+    graph.add :line, 'Jim', [-10, -20, 50, 92, -21, 56, 92, 84, 82, 100, 39, 120], :categories => [:top, :bottom]
+    graph.point_markers = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
+    
+    graph.render :to => "#{WEBSITE_DIR}/split_test.svg"
+    graph.render  :width => 500, :to => "#{WEBSITE_DIR}/split_test.png", :as => 'png'
+  end
+  
+  def test_stacking
+    graph = Scruffy::Graph.new
+    graph.title = "Comparative Agent Performance"
+    graph.value_formatter = Scruffy::Formatters::Percentage.new(:precision => 0)
+    graph.add :stacked do |stacked|
+      stacked.add :bar, 'Jack', [30, 60, 49, 29, 100, 120]
+      stacked.add :bar, 'Jill', [120, 240, 0, 100, 140, 20]
+      stacked.add :bar, 'Hill', [10, 10, 90, 20, 40, 10]
+    end
+    graph.point_markers = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun']
+    graph.render :to => "#{WEBSITE_DIR}/stacking_test.svg"
+    graph.render  :width => 500, :to => "#{WEBSITE_DIR}/stacking_test.png", :as => 'png'
+  end
+  
+  def test_multi_layered
+    graph = Scruffy::Graph.new
+    graph.title = "Some Kind of Information"
+    graph.renderer = Scruffy::Renderers::Cubed.new
+
+    graph.add :area, 'Jeff', [20, -5, 100, 70, 30, 106], :categories => [:top_left, :bottom_right]    
+    graph.add :area, 'Jerry', [-10, 70, 20, 102, 201, 26], :categories => [:bottom_left, :buttom_right]
+    graph.add :bar,  'Jack', [30, 0, 49, 29, 100, 203], :categories => [:bottom_left, :top_right]
+    graph.add :line, 'Brasten', [42, 10, 75, 150, 130, 70], :categories => [:top_right, :bottom_left]
+    graph.add :line, 'Jim', [-10, -20, 50, 92, -21, 56], :categories => [:top_left, :bottom_right]
+    graph.point_markers = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun']
+    graph.render :to => "#{WEBSITE_DIR}/multi_test.svg"
+    graph.render  :width => 500, :to => "#{WEBSITE_DIR}/multi_test.png", :as => 'png'
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/scruffy'

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification 
+name: samhendley-scruffy
+version: !ruby/object:Gem::Version 
+  version: 0.2.7
+platform: ruby
+authors: 
+- Brasten Sager
+- samhendley
+- delano
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-28 21:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: builder
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: Scruffy is a Ruby library for generating high quality, good looking graphs. It is designed to be easy to use and highly customizable.
+email: 
+- brasten@nagilum.com
+- david.parry@suranyami.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/scruffy/rasterizers/rmagick_rasterizer.rb
+- lib/scruffy/rasterizers/batik_rasterizer.rb
+- lib/scruffy/version.rb
+- lib/scruffy/layers/base.rb
+- lib/scruffy/layers/area.rb
+- lib/scruffy/layers/stacked.rb
+- lib/scruffy/layers/pie_slice.rb
+- lib/scruffy/layers/scatter.rb
+- lib/scruffy/layers/bar.rb
+- lib/scruffy/layers/sparkline_bar.rb
+- lib/scruffy/layers/pie.rb
+- lib/scruffy/layers/all_smiles.rb
+- lib/scruffy/layers/average.rb
+- lib/scruffy/layers/line.rb
+- lib/scruffy/rasterizers.rb
+- lib/scruffy/renderers.rb
+- lib/scruffy/themes.rb
+- lib/scruffy/helpers/canvas.rb
+- lib/scruffy/helpers/point_container.rb
+- lib/scruffy/helpers/layer_container.rb
+- lib/scruffy/helpers/meta.rb
+- lib/scruffy/components.rb
+- lib/scruffy/graph_state.rb
+- lib/scruffy/components/style_info.rb
+- lib/scruffy/components/value_markers.rb
+- lib/scruffy/components/viewport.rb
+- lib/scruffy/components/base.rb
+- lib/scruffy/components/graphs.rb
+- lib/scruffy/components/background.rb
+- lib/scruffy/components/legend.rb
+- lib/scruffy/components/data_markers.rb
+- lib/scruffy/components/label.rb
+- lib/scruffy/components/grid.rb
+- lib/scruffy/components/title.rb
+- lib/scruffy/graph.rb
+- lib/scruffy/renderers/sparkline.rb
+- lib/scruffy/renderers/base.rb
+- lib/scruffy/renderers/reversed.rb
+- lib/scruffy/renderers/split.rb
+- lib/scruffy/renderers/cubed3d.rb
+- lib/scruffy/renderers/standard.rb
+- lib/scruffy/renderers/pie.rb
+- lib/scruffy/renderers/empty.rb
+- lib/scruffy/renderers/cubed.rb
+- lib/scruffy/formatters.rb
+- lib/scruffy/helpers.rb
+- lib/scruffy/layers.rb
+- lib/scruffy.rb
+- LICENCE.txt
+- README.txt
+- CHANGES.txt
+has_rdoc: true
+homepage: http://scruffy.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --quiet
+- --title
+- scruffy documentation
+- --opname
+- index.html
+- --line-numbers
+- --main
+- README.txt
+- --inline-source
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A powerful, clean graphing library for Ruby.
+test_files: 
+- test/graph_creation_test.rb
+- test/test_helper.rb