gruffy 0.1.2 → 0.7.1.dev

data/lib/gruffy/pie.rb

@@ -1,271 +0,0 @@
-require File.dirname(__FILE__) + '/base'
-
-##
-# Here's how to make a Pie graph:
-#
-#   g = Gruffy::Pie.new
-#   g.title = "Visual Pie Graph Test"
-#   g.data 'Fries', 20
-#   g.data 'Hamburgers', 50
-#   g.write("test/output/pie_keynote.png")
-#
-# To control where the pie chart starts creating slices, use #zero_degree.
-
-class Gruffy::Pie < Gruffy::Base
-
-  DEFAULT_TEXT_OFFSET_PERCENTAGE = 0.15
-
-  # Can be used to make the pie start cutting slices at the top (-90.0)
-  # or at another angle. Default is 0.0, which starts at 3 o'clock.
-  attr_writer :zero_degree
-
-  # Do not show labels for slices that are less than this percent. Use 0 to always show all labels.
-  # Defaults to 0
-  attr_writer :hide_labels_less_than
-
-  # Affect the distance between the percentages and the pie chart
-  # Defaults to 0.15
-  attr_writer :text_offset_percentage
-
-  ## Use values instead of percentages
-  attr_accessor :show_values_as_labels
-
-  def initialize_ivars
-    super
-
-    @show_values_as_labels = false
-  end
-
-  def zero_degree
-    @zero_degree ||= 0.0
-  end
-
-  def hide_labels_less_than
-    @hide_labels_less_than ||= 0.0
-  end
-
-  def text_offset_percentage
-    @text_offset_percentage ||= DEFAULT_TEXT_OFFSET_PERCENTAGE
-  end
-
-  def options
-    {
-      :zero_degree            => zero_degree,
-      :hide_labels_less_than  => hide_labels_less_than,
-      :text_offset_percentage => text_offset_percentage,
-      :show_values_as_labels  => show_values_as_labels
-    }
-  end
-
-  def draw
-    hide_line_markers
-
-    super
-
-    return unless data_given?
-
-    slices.each do |slice|
-      if slice.value > 0
-        set_stroke_color slice
-        set_fill_color
-        set_stroke_width
-        set_drawing_points_for slice
-        process_label_for slice
-        update_chart_degrees_with slice.degrees
-      end
-    end
-
-    trigger_final_draw
-  end
-
-  private
-
-  def slices
-    @slices ||= begin
-      slices = @data.map { |data| slice_class.new(data, options) }
-
-      slices.sort_by(&:value) if @sort
-
-      total = slices.map(&:value).inject(:+).to_f
-      slices.each { |slice| slice.total = total }
-    end
-  end
-
-  # General Helper Methods
-
-  def hide_line_markers
-    @hide_line_markers = true
-  end
-
-  def data_given?
-    @has_data
-  end
-
-  def update_chart_degrees_with(degrees)
-    @chart_degrees = chart_degrees + degrees
-  end
-
-  def slice_class
-    PieSlice
-  end
-
-  # Spatial Value-Related Methods
-
-  def chart_degrees
-    @chart_degrees ||= zero_degree
-  end
-
-  def graph_height
-    @graph_height
-  end
-
-  def graph_width
-    @graph_width
-  end
-
-  def diameter
-    graph_height
-  end
-
-  def half_width
-    graph_width / 2.0
-  end
-
-  def half_height
-    graph_height / 2.0
-  end
-
-  def radius
-    @radius ||= ([graph_width, graph_height].min / 2.0) * 0.8
-  end
-
-  def center_x
-    @center_x ||= @graph_left + half_width
-  end
-
-  def center_y
-    @center_y ||= @graph_top + half_height - 10
-  end
-
-  def distance_from_center
-    20.0
-  end
-
-  def radius_offset
-    radius + (radius * text_offset_percentage) + distance_from_center
-  end
-
-  def ellipse_factor
-    radius_offset * text_offset_percentage
-  end
-
-  # Label-Related Methods
-
-  def process_label_for(slice)
-    if slice.percentage >= hide_labels_less_than
-      x, y  = label_coordinates_for slice
-
-      @d = draw_label(x, y, slice.label)
-    end
-  end
-
-  def label_coordinates_for(slice)
-    angle = chart_degrees + slice.degrees / 2
-
-    [x_label_coordinate(angle), y_label_coordinate(angle)]
-  end
-
-  def x_label_coordinate(angle)
-    center_x + ((radius_offset + ellipse_factor) * Math.cos(deg2rad(angle)))
-  end
-
-  def y_label_coordinate(angle)
-    center_y + (radius_offset * Math.sin(deg2rad(angle)))
-  end
-
-  # Drawing-Related Methods
-
-  def set_stroke_width
-    @d.stroke_width(radius)
-  end
-
-  def set_stroke_color(slice)
-    @d = @d.stroke slice.color
-  end
-
-  def set_fill_color
-    @d = @d.fill 'transparent'
-  end
-
-  def set_drawing_points_for(slice)
-    @d = @d.ellipse(
-      center_x,
-      center_y,
-      radius / 2.0,
-      radius / 2.0,
-      chart_degrees,
-      chart_degrees + slice.degrees + 0.5
-    )
-  end
-
-  def trigger_final_draw
-    @d.draw(@base_image)
-  end
-
-  def configure_label_styling
-    @d.fill        = @font_color
-    @d.font        = @font if @font
-    @d.pointsize   = scale_fontsize(@marker_font_size)
-    @d.stroke      = 'transparent'
-    @d.font_weight = BoldWeight
-    @d.gravity     = CenterGravity
-  end
-
-  def draw_label(x, y, value)
-    configure_label_styling
-
-    @d.annotate_scaled(
-      @base_image,
-      0,
-      0,
-      x,
-      y,
-      value,
-      @scale
-    )
-  end
-
-  # Helper Classes
-
-  class PieSlice < Struct.new(:data_array, :options)
-    attr_accessor :total
-
-    def name
-      data_array[0]
-    end
-
-    def value
-      data_array[1].first
-    end
-
-    def color
-      data_array[2]
-    end
-
-    def size
-      @size ||= value / total
-    end
-
-    def percentage
-      @percentage ||= (size * 100.0).round
-    end
-
-    def degrees
-      @degrees ||= size * 360.0
-    end
-
-    def label
-      options[:show_values_as_labels] ? value.to_s : "#{percentage}%"
-    end
-  end
-end

data/lib/gruffy/scatter.rb

@@ -1,314 +0,0 @@
-require File.dirname(__FILE__) + '/base'
-
-# Here's how to set up an XY Scatter Chart
-#
-# g = Gruffy::Scatter.new(800)
-# g.data(:apples, [1,2,3,4], [4,3,2,1])
-# g.data('oranges', [5,7,8], [4,1,7])
-# g.write('test/output/scatter.png')
-# 
-#
-class Gruffy::Scatter < Gruffy::Base
-
-  # Maximum X Value. The value will get overwritten by the max in the
-  # datasets.  
-  attr_accessor :maximum_x_value
-  
-  # Minimum X Value. The value will get overwritten by the min in the 
-  # datasets.  
-  attr_accessor :minimum_x_value
-  
-  # The number of vertical lines shown for reference
-  attr_accessor :marker_x_count
-  
-  #~ # Draw a dashed horizontal line at the given y value
-  #~ attr_accessor :baseline_y_value
-	
-  #~ # Color of the horizontal baseline
-  #~ attr_accessor :baseline_y_color
-  
-  #~ # Draw a dashed horizontal line at the given y value
-  #~ attr_accessor :baseline_x_value
-	
-  #~ # Color of the horizontal baseline
-  #~ attr_accessor :baseline_x_color
-
-  # Attributes to allow customising the size of the points
-  attr_accessor :circle_radius
-  attr_accessor :stroke_width
-
-  # Allow disabling the significant rounding when labeling the X axis
-  # This is useful when working with a small range of high values (for example, a date range of months, while seconds as units)
-  attr_accessor :disable_significant_rounding_x_axis
-
-  # Allow enabling vertical lines. When you have a lot of data, they can work great
-  attr_accessor :enable_vertical_line_markers
-
-  # Allow using vertical labels in the X axis (and setting the label margin)
-  attr_accessor :x_label_margin
-  attr_accessor :use_vertical_x_labels
-
-  # Allow passing lambdas to format labels
-  attr_accessor :y_axis_label_format
-  attr_accessor :x_axis_label_format
-  
-  
-  # Gruffy::Scatter takes the same parameters as the Gruffy::Line graph
-  #
-  # ==== Example
-  #
-  # g = Gruffy::Scatter.new
-  #
-  def initialize(*)
-    super
-
-    @baseline_x_color = @baseline_y_color = 'red'
-    @baseline_x_value = @baseline_y_value = nil
-    @circle_radius = nil
-    @disable_significant_rounding_x_axis = false
-    @enable_vertical_line_markers = false
-    @marker_x_count = nil
-    @maximum_x_value = @minimum_x_value = nil
-    @stroke_width = nil
-    @use_vertical_x_labels = false
-    @x_axis_label_format = nil
-    @x_label_margin = nil
-    @y_axis_label_format = nil
-  end
-
-  def setup_drawing
-    # TODO Need to get x-axis labels working. Current behavior will be to not allow.
-    @labels = {}
-
-    super
-
-    # Translate our values so that we can use the base methods for drawing
-    # the standard chart stuff
-    @column_count = @x_spread
-  end
-
-  def draw
-    super
-    return unless @has_data
-
-    # Check to see if more than one datapoint was given. NaN can result otherwise.  
-    @x_increment = (@column_count > 1) ? (@graph_width / (@column_count - 1).to_f) : @graph_width
-
-    #~ if (defined?(@norm_y_baseline)) then
-      #~ level = @graph_top + (@graph_height - @norm_baseline * @graph_height)
-      #~ @d = @d.push
-      #~ @d.stroke_color @baseline_color
-      #~ @d.fill_opacity 0.0
-      #~ @d.stroke_dasharray(10, 20)
-      #~ @d.stroke_width 5
-      #~ @d.line(@graph_left, level, @graph_left + @graph_width, level)
-      #~ @d = @d.pop
-    #~ end
-
-    #~ if (defined?(@norm_x_baseline)) then
-      
-    #~ end
-
-    @norm_data.each do |data_row|      
-      data_row[DATA_VALUES_INDEX].each_with_index do |data_point, index|
-        x_value = data_row[DATA_VALUES_X_INDEX][index]
-        next if data_point.nil? || x_value.nil? 
-
-        new_x = get_x_coord(x_value, @graph_width, @graph_left)
-        new_y = @graph_top + (@graph_height - data_point * @graph_height)
-
-        # Reset each time to avoid thin-line errors
-        @d = @d.stroke data_row[DATA_COLOR_INDEX]
-        @d = @d.fill data_row[DATA_COLOR_INDEX]
-        @d = @d.stroke_opacity 1.0
-        @d = @d.stroke_width @stroke_width || clip_value_if_greater_than(@columns / (@norm_data.first[1].size * 4), 5.0)
-
-        circle_radius = @circle_radius || clip_value_if_greater_than(@columns / (@norm_data.first[1].size * 2.5), 5.0)
-        @d = @d.circle(new_x, new_y, new_x - circle_radius, new_y)
-      end
-    end
-
-    @d.draw(@base_image)
-  end
-  
-  # The first parameter is the name of the dataset.  The next two are the
-  # x and y axis data points contain in their own array in that respective
-  # order.  The final parameter is the color.
-  #
-  # Can be called multiple times with different datasets for a multi-valued
-  # graph.
-  #
-  # If the color argument is nil, the next color from the default theme will
-  # be used.
-  #
-  # NOTE: If you want to use a preset theme, you must set it before calling
-  # data().
-  #
-  # ==== Parameters
-  # name:: String or Symbol containing the name of the dataset.
-  # x_data_points:: An Array of of x-axis data points. 
-  # y_data_points:: An Array of of y-axis data points. 
-  # color:: The hex string for the color of the dataset.  Defaults to nil.
-  #
-  # ==== Exceptions
-  # Data points contain nil values::
-  #   This error will get raised if either the x or y axis data points array
-  #   contains a <tt>nil</tt> value.  The graph will not make an assumption
-  #   as how to graph <tt>nil</tt>
-  # x_data_points is empty::
-  #   This error is raised when the array for the x-axis points are empty
-  # y_data_points is empty::
-  #   This error is raised when the array for the y-axis points are empty
-  # x_data_points.length != y_data_points.length::
-  #   Error means that the x and y axis point arrays do not match in length
-  #
-  # ==== Examples
-  # g = Gruffy::Scatter.new
-  # g.data(:apples, [1,2,3], [3,2,1])
-  # g.data('oranges', [1,1,1], [2,3,4])
-  # g.data('bitter_melon', [3,5,6], [6,7,8], '#000000')
-  #
-  def data(name, x_data_points=[], y_data_points=[], color=nil)
-    
-    raise ArgumentError, 'Data Points contain nil Value!' if x_data_points.include?(nil) || y_data_points.include?(nil)
-    raise ArgumentError, 'x_data_points is empty!' if x_data_points.empty?
-    raise ArgumentError, 'y_data_points is empty!' if y_data_points.empty?
-    raise ArgumentError, 'x_data_points.length != y_data_points.length!' if x_data_points.length != y_data_points.length
-    
-    # Call the existing data routine for the y axis data
-    super(name, y_data_points, color)
-    
-    #append the x data to the last entry that was just added in the @data member
-    last_elem = @data.length()-1
-    @data[last_elem] << x_data_points
-    
-    if @maximum_x_value.nil? && @minimum_x_value.nil?
-      @maximum_x_value = @minimum_x_value = x_data_points.first
-    end
-    
-    @maximum_x_value = x_data_points.max > @maximum_x_value ?
-                        x_data_points.max : @maximum_x_value
-    @minimum_x_value = x_data_points.min < @minimum_x_value ?
-                        x_data_points.min : @minimum_x_value
-  end
-  
-protected
-  
-  def calculate_spread #:nodoc:
-    super
-    @x_spread = @maximum_x_value.to_f - @minimum_x_value.to_f
-    @x_spread = @x_spread > 0 ? @x_spread : 1
-  end
-  
-  def normalize(force=nil)
-    if @norm_data.nil? || force 
-      @norm_data = []
-      return unless @has_data
-      
-      @data.each do |data_row|
-        norm_data_points = [data_row[DATA_LABEL_INDEX]]
-        norm_data_points << data_row[DATA_VALUES_INDEX].map do |r|  
-                                (r.to_f - @minimum_value.to_f) / @spread
-                            end
-        norm_data_points << data_row[DATA_COLOR_INDEX]
-        norm_data_points << data_row[DATA_VALUES_X_INDEX].map do |r|  
-                                (r.to_f - @minimum_x_value.to_f) / @x_spread 
-                            end
-        @norm_data << norm_data_points
-      end
-    end
-    #~ @norm_y_baseline = (@baseline_y_value.to_f / @maximum_value.to_f) if @baseline_y_value
-    #~ @norm_x_baseline = (@baseline_x_value.to_f / @maximum_x_value.to_f) if @baseline_x_value
-  end
-  
-  def draw_line_markers
-    # do all of the stuff for the horizontal lines on the y-axis
-    super
-    return if @hide_line_markers
-    
-    @d = @d.stroke_antialias false
-
-    if @x_axis_increment.nil?
-      # TODO Do the same for larger numbers...100, 75, 50, 25
-      if @marker_x_count.nil?
-        (3..7).each do |lines|
-          if @x_spread % lines == 0.0
-            @marker_x_count = lines
-            break
-          end
-        end
-        @marker_x_count ||= 4
-      end
-      @x_increment = (@x_spread > 0) ? (@x_spread / @marker_x_count) : 1
-      unless @disable_significant_rounding_x_axis
-        @x_increment = significant(@x_increment)
-      end
-    else
-      # TODO Make this work for negative values
-      @maximum_x_value = [@maximum_value.ceil, @x_axis_increment].max
-      @minimum_x_value = @minimum_x_value.floor
-      calculate_spread
-      normalize(true)
-      
-      @marker_count = (@x_spread / @x_axis_increment).to_i
-      @x_increment = @x_axis_increment
-    end
-    @increment_x_scaled = @graph_width.to_f / (@x_spread / @x_increment)
-
-    # Draw vertical line markers and annotate with numbers
-    (0..@marker_x_count).each do |index|
-
-      # TODO Fix the vertical lines, and enable them by default. Not pretty when they don't match up with top y-axis line
-      if @enable_vertical_line_markers
-        x = @graph_left + @graph_width - index.to_f * @increment_x_scaled
-        @d = @d.stroke(@marker_color)
-        @d = @d.stroke_width 1
-        @d = @d.line(x, @graph_top, x, @graph_bottom)
-      end
-
-      unless @hide_line_numbers
-        marker_label = index * @x_increment + @minimum_x_value.to_f
-        y_offset = @graph_bottom + (@x_label_margin || LABEL_MARGIN)
-        x_offset = get_x_coord(index.to_f, @increment_x_scaled, @graph_left)
-
-        @d.fill = @font_color
-        @d.font = @font if @font
-        @d.stroke('transparent')
-        @d.pointsize = scale_fontsize(@marker_font_size)
-        @d.gravity = NorthGravity
-        @d.rotation = -90.0 if @use_vertical_x_labels
-        @d = @d.annotate_scaled(@base_image, 
-                          1.0, 1.0, 
-                          x_offset, y_offset, 
-                          vertical_label(marker_label, @x_increment), @scale)
-        @d.rotation = 90.0 if @use_vertical_x_labels
-      end
-    end
-    
-    @d = @d.stroke_antialias true
-  end
-
-
-  def label(value, increment)
-    if @y_axis_label_format
-      @y_axis_label_format.call(value)
-    else
-      super
-    end
-  end
-
-  def vertical_label(value, increment)
-    if @x_axis_label_format
-      @x_axis_label_format.call(value)
-    else
-      label(value, increment)
-    end
-  end
-  
-private
-  
-  def get_x_coord(x_data_point, width, offset) #:nodoc:
-    x_data_point * width + offset
-  end
-  
-end # end Gruffy::Scatter