gerbilcharts 0.2.13 → 0.5.9

data/History.txt

@@ -1,3 +1,38 @@
+== 0.5.9 2011-01-15
+* Changes
+  * New public release
+  * Across the board improvements & new features 
+  * Used in production environments by Trisul Network Security Monitoring
+  * New bubble chart 
+
+
+== 0.3.7 2010-04-15
+* Changes
+  * Lots of bug fixes rolled up
+  * Better scaling in 1G to 10G range
+  * Time zone support for gerbil.js
+
+== 0.3.2 2010-01-05
+* Changes
+  * New parameter :enable_detailed_legend :enable_legend
+  * Larger default fonts
+  * Better layout logic for detailed legend panel 
+  * Block button to open/close legend panel
+
+
+== 0.2.17 2009-12-16
+* Changes
+  * Traffic Matrix and Conversation Error Rectified
+  * Angled labels for matrix
+
+== 0.2.15 2009-12-11
+* Changes
+  * More hardening of gerbilcharts against bad data 
+
+== 0.2.14 2009-12-10
+* Changes
+  * Traffic matrix and conversation ring 
+
 == 0.2.13 2009-12-01
 * Changes
   * inline javascript option now fixed

data/Manifest.txt

@@ -30,6 +30,7 @@ lib/gerbilcharts/models/discrete_time_range.rb
 lib/gerbilcharts/models/sampled_timeseries_graph_model.rb
 lib/gerbilcharts/models/time_series_graph_model.rb
 lib/gerbilcharts/models/simple_timeseries_model_group.rb
+lib/gerbilcharts/models/matrix_model.rb
 lib/gerbilcharts/surfaces/area_surface.rb
 lib/gerbilcharts/surfaces/axis.rb
 lib/gerbilcharts/surfaces/bar_surface.rb
@@ -53,10 +54,13 @@ lib/gerbilcharts/surfaces/stacked_grid.rb
 lib/gerbilcharts/surfaces/surface_background.rb
 lib/gerbilcharts/surfaces/surface.rb
 lib/gerbilcharts/surfaces/title_panel.rb
+lib/gerbilcharts/surfaces/bubble_surface.rb
 lib/gerbilcharts/surfaces/tracker.rb
 lib/gerbilcharts/surfaces/vertical_axis.rb
 lib/gerbilcharts/surfaces/pie_surface.rb
 lib/gerbilcharts/surfaces/square_line_surface.rb
+lib/gerbilcharts/surfaces/matrix_surface.rb
+lib/gerbilcharts/surfaces/conversation_ring.rb
 lib/gerbilcharts/charts/area_chart.rb
 lib/gerbilcharts/charts/bar_chart_compact.rb
 lib/gerbilcharts/charts/bar_chart.rb
@@ -66,6 +70,9 @@ lib/gerbilcharts/charts/line_chart.rb
 lib/gerbilcharts/charts/stacked_area_chart.rb
 lib/gerbilcharts/charts/pie_chart.rb
 lib/gerbilcharts/charts/square_line_chart.rb
+lib/gerbilcharts/charts/matrix_chart.rb
+lib/gerbilcharts/charts/conversation_ring.rb
+lib/gerbilcharts/charts/bubble_chart.rb
 lib/gerbilcharts/svgdc/svgdc.rb
 lib/gerbilcharts/svgdc/svg_element.rb
 lib/gerbilcharts/svgdc/filters.rb
@@ -75,6 +82,7 @@ lib/gerbilcharts/svgdc/svg_win.rb
 lib/gerbilcharts/svgdc/svg_custom_win.rb
 lib/gerbilcharts/svgdc/svg_shape.rb
 lib/gerbilcharts/svgdc/svg_circle.rb
+lib/gerbilcharts/svgdc/svg_ellipse.rb
 lib/gerbilcharts/svgdc/svg_line.rb
 lib/gerbilcharts/svgdc/svg_polygon.rb
 lib/gerbilcharts/svgdc/svg_polyline.rb

data/README.txt

@@ -4,23 +4,23 @@
 
 == DESCRIPTION:
 
-SVG based charting library especially suited for timeseries data.
+SVG based Ruby charting library. 
 
 == FEATURES/PROBLEMS:
 
-* Many predefined models
-* Many chart types
-* Customize via stylesheets instead of calls to setFont, setLineStyle, setColor etc
-* Interactive show tooltips, handle clicks on chart objects
+* All common chart types supported (Line, Stacked Area, Pie, Bar, Area)
+* If used in a Rails app, SVG is fully generated server side 
+* Javascript is used within the SVG document for interactivity only
+* Completely change look and feel via a SVG CSS 
+* Show tooltips, handle clicks on chart objects
 * Ajax enabled. gerbil.js allows each chart to autoupdate itself with new SVG elements.
 
 Known issues :
 * Requires a browser that can handle SVG such as Firefox/Opera.
 * IE + Adobe SVG Viewer works but has some problems w/ Ajax
-* Still needs some work on negative numbers
-* Needs better min/max/avg plotting on bucketized data
 
 ===Note on stylesheets
+
 GerbilCharts uses stylesheets to customize appearances of almost all visual
 elements (colors, fonts, line strokes, fills). You can use the supplied
 stylesheet (eg, brushmetal.css) or derive your own from it. GerbilCharts
@@ -245,7 +245,7 @@ Todo: A sample please (extract from Web Trisul)
 
 (The MIT License)
 
-Copyright (c) 2008 Vivek Rajagopalan (vivek at unleashnetworks )
+Copyright (c) 2008-10 Vivek Rajagopalan (vivek at unleashnetworks )
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/gerbilcharts/charts.rb

@@ -16,3 +16,6 @@ require 'gerbilcharts/charts/line_chart'
 require 'gerbilcharts/charts/stacked_area_chart'
 require 'gerbilcharts/charts/pie_chart'
 require 'gerbilcharts/charts/square_line_chart'
+require 'gerbilcharts/charts/matrix_chart'
+require 'gerbilcharts/charts/conversation_ring'
+require 'gerbilcharts/charts/bubble_chart'

data/lib/gerbilcharts/charts/bubble_chart.rb

@@ -0,0 +1,30 @@
+module GerbilCharts::Charts
+
+# = Bubble chart
+# Size of SVG bubbles (can be shapes) determined by occurances
+#
+class BubbleChart < ChartBase
+
+  def initialize(opt={})
+    super(opt)
+  end
+  
+  def create_chart_elements
+    
+    # other elements
+    @thechart.add_child(GerbilCharts::Surfaces::SurfaceBackground.new(:orient => ORIENT_OVERLAY))
+    @thechart.add_child(GerbilCharts::Surfaces::TitlePanel.new(:orient => ORIENT_OVERLAY, :dim => 30))
+    @thechart.add_child(GerbilCharts::Surfaces::BubbleSurface.new(:orient => ORIENT_OVERLAY),:anchor => true)
+    @thechart.add_child(GerbilCharts::Surfaces::Legend.new(:orient=> ORIENT_OVERLAY, :dim => 2*@legend_width))  
+    @thechart.add_child(GerbilCharts::Surfaces::DetailedLegend.new(:orient=> ORIENT_OVERLAY, :dim => 4*@legend_width))  
+    @thechart.add_child(GerbilCharts::Surfaces::HorizontalTimeAxis.new(:orient => ORIENT_SOUTH, :dim => 25 ))
+
+    # optional features
+    if @feature_timetracker
+        @thechart.add_child(GerbilCharts::Surfaces::Tracker.new(:orient => ORIENT_SOUTH, :dim => 10 ))
+    end
+  end
+end
+
+end
+

data/lib/gerbilcharts/charts/conversation_ring.rb

@@ -0,0 +1,31 @@
+module GerbilCharts::Charts
+
+# Matrix Chart
+class ConversationRing < ChartBase
+  
+  def initialize(opt={})
+    super(opt)
+  end
+
+  
+  def create_chart_elements
+    # filters if required 
+    @thechart.create_filter(GerbilCharts::SVGDC::LinearGradientVertical.new("vertgrad","rgb(255,255,255)","rgb(224,224,224)"))
+
+    # additional filter by name
+    @thechart.create_filter(GerbilCharts::SVGDC::LikeButton.new('LikeButton')) if @gerbilfilter == 'LikeButton'   
+
+ 
+    # other elements    
+    @thechart.add_child(GerbilCharts::Surfaces::SurfaceBackground.new(:orient => ORIENT_OVERLAY))
+    @thechart.add_child(GerbilCharts::Surfaces::TitlePanel.new(:orient => ORIENT_OVERLAY, :dim => 30))
+    @thechart.add_child(GerbilCharts::Surfaces::ConversationRing.new(:orient => ORIENT_OVERLAY), :anchor => true)  
+end
+
+
+
+end
+
+
+
+end

data/lib/gerbilcharts/charts/line_chart.rb

@@ -29,6 +29,7 @@ class LineChart < ChartBase
     @thechart.add_child(GerbilCharts::Surfaces::TitlePanel.new(:orient => ORIENT_OVERLAY, :dim => 30))
     @thechart.add_child(GerbilCharts::Surfaces::LineSurface.new(:orient => ORIENT_OVERLAY),:anchor => true)
     @thechart.add_child(GerbilCharts::Surfaces::Legend.new(:orient=> ORIENT_OVERLAY, :dim => @legend_width))  
+    @thechart.add_child(GerbilCharts::Surfaces::DetailedLegend.new(:orient=> ORIENT_OVERLAY, :dim => 3*@legend_width))
     @thechart.add_child(GerbilCharts::Surfaces::VerticalAxis.new(:orient => ORIENT_WEST, :dim => 40 ))
     @thechart.add_child(GerbilCharts::Surfaces::HorizontalTimeAxis.new(:orient => ORIENT_SOUTH, :dim => 25 ))
   end

data/lib/gerbilcharts/charts/matrix_chart.rb

@@ -0,0 +1,32 @@
+module GerbilCharts::Charts
+
+# Matrix Chart
+class MatrixChart < ChartBase
+
+  
+  def initialize(opt={})
+    super(opt)
+  end
+
+  
+  def create_chart_elements
+    
+    # filters if required 
+    @thechart.create_filter(GerbilCharts::SVGDC::LinearGradientVertical.new("vertgrad","rgb(255,255,255)","rgb(224,224,224)"))
+
+    # additional filter by name
+    @thechart.create_filter(GerbilCharts::SVGDC::LikeButton.new('LikeButton')) if @gerbilfilter == 'LikeButton'
+
+    # other elements    
+    @thechart.add_child(GerbilCharts::Surfaces::SurfaceBackground.new(:orient => ORIENT_OVERLAY))
+    @thechart.add_child(GerbilCharts::Surfaces::TitlePanel.new(:orient => ORIENT_NORTH, :dim => 30))
+    @thechart.add_child(GerbilCharts::Surfaces::MatrixSurface.new(:orient => ORIENT_OVERLAY), :anchor => true)  
+end
+
+
+
+end
+
+
+
+end

data/lib/gerbilcharts/charts/square_line_chart.rb

@@ -26,12 +26,19 @@ class SquareLineChart < ChartBase
     
     # other elements
     @thechart.add_child(GerbilCharts::Surfaces::SurfaceBackground.new(:orient => ORIENT_OVERLAY))
+    @thechart.add_child(GerbilCharts::Surfaces::MarkBand.new(:orient => ORIENT_OVERLAY))
     @thechart.add_child(GerbilCharts::Surfaces::BasicGrid.new(:orient => ORIENT_OVERLAY))
     @thechart.add_child(GerbilCharts::Surfaces::TitlePanel.new(:orient => ORIENT_OVERLAY, :dim => 30))
     @thechart.add_child(GerbilCharts::Surfaces::SquareLineSurface.new(:orient => ORIENT_OVERLAY),:anchor => true)
     @thechart.add_child(GerbilCharts::Surfaces::Legend.new(:orient=> ORIENT_OVERLAY, :dim => @legend_width))  
+    @thechart.add_child(GerbilCharts::Surfaces::DetailedLegend.new(:orient=> ORIENT_OVERLAY, :dim => 3*@legend_width))
     @thechart.add_child(GerbilCharts::Surfaces::VerticalAxis.new(:orient => ORIENT_WEST, :dim => 40 ))
     @thechart.add_child(GerbilCharts::Surfaces::HorizontalTimeAxis.new(:orient => ORIENT_SOUTH, :dim => 25 ))
+
+    # optional features
+    if @feature_timetracker
+        @thechart.add_child(GerbilCharts::Surfaces::Tracker.new(:orient => ORIENT_OVERLAY ))
+    end
   end
 end
 

data/lib/gerbilcharts/models.rb

@@ -17,3 +17,4 @@ require 'gerbilcharts/models/time_series_graph_model'
 require 'gerbilcharts/models/bucketized_timeseries_graph_model'
 require 'gerbilcharts/models/sampled_timeseries_graph_model'
 require 'gerbilcharts/models/simple_timeseries_model_group'
+require 'gerbilcharts/models/matrix_model.rb'

data/lib/gerbilcharts/models/bucketized_timeseries_graph_model.rb

@@ -35,6 +35,7 @@ class BucketizedTimeSeriesGraphModel < TimeSeriesGraphModel
    def add(x_tm,y_val)
     buckettm_in = to_buckettime(x_tm)
     
+
     # first time
     if @xarr.length==0
         super(buckettm_in,y_val)
@@ -42,7 +43,6 @@ class BucketizedTimeSeriesGraphModel < TimeSeriesGraphModel
         return
     end
       
-    
     # subsequent times
     if buckettm_in== latest_x
         ynew = bucketize(y_val)

data/lib/gerbilcharts/models/graph_model_group.rb

@@ -10,6 +10,8 @@ class GraphModelGroup
   attr_accessor :href
   attr_accessor :emptycaption
   attr_accessor :units
+  attr_accessor :x_markers
+  attr_accessor :ref_model
   
   def initialize(n="Untitled-Group")
     @models=[]
@@ -187,14 +189,17 @@ class GraphModelGroup
   # sum of model ranges  with min y being 0
   def cumulative_round_range_y0
 
-    return 0,100 if models.empty?
+    return 0,100 if models.empty? 
 
     reffy = RawRange.new
     reffy.update(0)
     @models.each do |m|
-      reffy.update(m.yrange.rmax+reffy.rmax)
+      reffy.update(m.yrange.rmax+reffy.rmax) if m.yrange.rmax
     end    
+
+ 	reffy.update(ref_model.yrange.rmax)  if has_ref_model?
     return models[0].round_given_y(reffy)
+
   end
 
   # sum of model ranges  
@@ -203,6 +208,7 @@ class GraphModelGroup
     @models.each do |m|
       reffy.update(m.yrange.rmax+reffy.rmax)
     end    
+ 	reffy.update(ref_model.yrange.rmax)  if has_ref_model?
     return models[0].round_given_y(reffy)
   end
 
@@ -292,6 +298,15 @@ class GraphModelGroup
     return @emptycaption
   end
 
+  def has_x_markers?
+	not x_markers.nil?
+  end
+
+  def has_ref_model?
+  	not @ref_model.nil?
+  end
+
+
 
 private
 
@@ -318,6 +333,8 @@ private
 		reffy.update(acc_y)
 	end
 
+ 	reffy.update(ref_model.yrange.rmax)  if has_ref_model?
+
     return models[0].round_given_y(reffy)
       
   end  

data/lib/gerbilcharts/models/matrix_model.rb

@@ -0,0 +1,85 @@
+module GerbilCharts::Models
+
+class MatrixModel 
+
+attr_reader :aend, :zend, :aenduniq, :zenduniq
+attr_accessor :name 
+attr_reader :aendlen , :zendlen
+attr_reader :hash , :sort,:multiply_factor,:name
+
+  # Create the model group for matrix chart
+  # Input = {"a","b",1000}
+  #         {"a","c",1030}
+  #         {"b","v",2345}
+  #
+  # Output = {"a"=>[1000,1030,0],"b"=>[0,0,2345]}
+  
+  def initialize(opts)
+        @name=opts
+        @aend = []
+	@zend = []
+	@input_values = []
+	@arr = []
+	@hash = {}
+        @sort = []	
+        @unsort_value = []
+        @multiply_factor = 1.0
+        @flag = 1
+  end
+
+# Construct the input values
+# Eg : @input_values = [["a","b",3000],["a","c",4000],["d","r",4500]] 
+  def add(item1,item2,item3) 
+      @aend << item1
+      @zend << item2         
+      for i in 0...@input_values.count
+           if ((@input_values[i][0] == item1) and (@input_values[i][1] == item2))
+              @input_values[i][2] = @input_values[i][2] + item3
+              @flag = 0 
+           end         
+      end
+      if(@flag==1)
+         @input_values << [item1,item2,item3]
+      end
+      @flag=1    
+end
+  
+# calculates the conversation matrix based on the raw arrays a/zend 
+  def calc_matrix           
+      @aenduniq = @aend.uniq
+      @zenduniq = @zend.uniq
+      @aendlen = @aenduniq.length
+      @zendlen = @zenduniq.length
+
+      @input_values.each do |item|
+            @unsort_value << item[2]
+      end
+      @sort = @unsort_value.sort.reverse
+      
+      @aenduniq.each do |aitem|          
+          @zenduniq.each_with_index do |zitem,i|
+               @input_values.each do |vitem|
+                     if ((vitem[0] == aitem) and (vitem[1] == zitem))
+                        @arr << vitem[2]                       
+                     end                       
+               end
+              if @arr[i].nil?
+                 @arr << 0
+              end
+          end             
+      @hash.store(aitem,@arr)
+      @arr = []
+      end  
+  end
+
+ def hasHref?
+	return false
+ end
+
+ def empty?
+	return false
+ end
+
+end
+end
+

data/lib/gerbilcharts/models/monotonous_graph_model.rb

@@ -27,7 +27,9 @@ class MonotonousGraphModel < GraphModel
   def add(x_val,y_val)
 
     if @xarr.length > 0 and @xarr.last > x_val
-      raise "Expecting monotonous series data"  
+	  # ignoring out of order data 
+      # raise "Expecting monotonous series data"  
+	  return 
     end
   
   	# x updates
@@ -158,6 +160,8 @@ class MonotonousGraphModel < GraphModel
   #  todo : support :ninety_fifth
   #
   def get_statistical_analysis(mode = :normal)
+  	return [0,0,0,0,0] if @yarr.size==0
+
   	a = []
 	a[0]= @yrange.rmin
 	a[1]= @yrange.rmax