ghazel-googlecharts 1.4.0

data/History.txt

@@ -0,0 +1,48 @@
+== 1.3.6
+* support nil values. The Google Charts API specifies that a single underscore (_) can be used to omit a value from a line chart with 'simple' data encoding, and a double underscore (__) can do the same for a chart with 'extended' data encoding. (Matt Moyer)
+* allow a label to appear on a google-o-meter via the :legend option. (hallettj)
+
+== 1.3.5
+* added code to properly escape image tag URLs (mokolabs)
+* added themes support + 4 default themes (keynote, thirty7signals, pastel, greyscale) chart.line(:theme=>:keynote) (jakehow)
+
+== 1.3.4
+* updated documentation and cleaned it up (mokolabs)
+* added support for custom class, id and alt tags when using the image_tag format (i.e Gchart.line(:data => [0, 26], :format => 'image_tag')) (mokolabs)
+
+== 1.3.2 - 1.3.3
+* changes required by github
+
+== 1.3.1
+* added width and spacing options
+
+== 1.3.0
+* added support for google-o-meter
+* fixed a bug when the max value of a data set was 0
+
+== 1.2.0
+* added support for sparklines
+
+== 1.1.0
+* fixed another bug fix related to the uri escaping required to download the file properly.
+
+== 1.0.0
+* fixed the (URI::InvalidURIError) issue
+
+== 0.2.0
+* added export options (file and image tag)
+* added support for all arguments to be passed as a string or an array
+
+== 0.1.0 2007-12-11
+* fixed the axis labels
+
+== 0.0.3 2007-12-11
+* added :chart_background alias and fixed a bug related to the background colors.
+
+== 0.0.2 2007-12-11
+* added support for more features and aliases
+
+== 0.0.1 2007-12-08
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Matt Aimonetti
+
+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/Manifest.txt

@@ -0,0 +1,18 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+config/hoe.rb
+config/requirements.rb
+lib/gchart.rb
+lib/gchart/aliases.rb
+lib/gchart/theme.rb
+lib/gchart/version.rb
+setup.rb
+spec/gchart_spec.rb
+spec/theme_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/environment.rake
+tasks/rspec.rake

data/README.txt

@@ -0,0 +1,9 @@
+CHECK README.markdown  (open as a text file)
+
+Or check:
+
+  http://googlecharts.rubyforge.org
+
+and/or 
+
+  http://github.com/mattetti/googlecharts

data/Rakefile

@@ -0,0 +1,32 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }
+
+desc %{Update ".manifest" with the latest list of project filenames. Respect\
+.gitignore by excluding everything that git ignores. Update `files` and\
+`test_files` arrays in "*.gemspec" file if it's present.}
+task :manifest do
+  list = Dir['**/*'].sort
+  spec_file = Dir['*.gemspec'].first
+  list -= [spec_file] if spec_file
+  
+  File.read('.gitignore').each_line do |glob|
+    glob = glob.chomp.sub(/^\//, '')
+    list -= Dir[glob]
+    list -= Dir["#{glob}/**/*"] if File.directory?(glob) and !File.symlink?(glob)
+    puts "excluding #{glob}"
+  end
+ 
+  if spec_file
+    spec = File.read spec_file
+    spec.gsub! /^(\s* s.(test_)?files \s* = \s* )( \[ [^\]]* \] | %w\( [^)]* \) )/mx do
+      assignment = $1
+      bunch = $2 ? list.grep(/^test\//) : list
+      '%s%%w(%s)' % [assignment, bunch.join(' ')]
+    end
+      
+    File.open(spec_file, 'w') {|f| f << spec }
+  end
+  File.open('.manifest', 'w') {|f| f << list.join("\n") }
+end

data/config/hoe.rb

@@ -0,0 +1,71 @@
+require 'gchart/version'
+
+AUTHOR = 'Matt Aimonetti'  # can also be an array of Authors
+EMAIL = "mattaimonetti@gmail.com"
+DESCRIPTION = "description of gem"
+GEM_NAME = 'googlecharts' # what ppl will type to install your gem
+RUBYFORGE_PROJECT = 'googlecharts' # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "matt_a"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil 
+# UNCOMMENT IF REQUIRED: 
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = GchartInfo::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'gchart documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' } 
+    @extra_deps
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+hoe.rsync_args = '-av --delete --ignore-errors'

data/config/requirements.rb

@@ -0,0 +1,16 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe newgem rubigen].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile could use '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))
+
+require 'gchart'

data/lib/gchart.rb

@@ -0,0 +1,526 @@
+$:.unshift File.dirname(__FILE__)
+require 'gchart/version'
+require 'gchart/theme'
+require "open-uri"
+require "uri"
+require "cgi"
+require 'enumerator'
+
+class Gchart
+
+  include GchartInfo
+  
+  @@url = "http://chart.apis.google.com/chart?"  
+  @@types = ['line', 'line_xy', 'scatter', 'bar', 'venn', 'pie', 'pie_3d', 'jstize', 'sparkline', 'meter', 'map']
+  @@simple_chars = ('A'..'Z').to_a + ('a'..'z').to_a + ('0'..'9').to_a
+  @@chars = @@simple_chars + ['-', '.']
+  @@ext_pairs = @@chars.map { |char_1| @@chars.map { |char_2| char_1 + char_2 } }.flatten
+  @@file_name = 'chart.png'
+  
+  attr_accessor :title, :type, :width, :height, :horizontal, :grouped, :legend, :data, :encoding, :bar_colors,
+                :title_color, :title_size, :custom, :axis_with_labels, :axis_labels, :bar_width_and_spacing, :id, :alt, :class,
+                :range_markers, :geographical_area, :map_colors, :country_codes, :axis_range
+    
+  # Support for Gchart.line(:title => 'my title', :size => '400x600')
+  def self.method_missing(m, options={})
+    # Start with theme defaults if a theme is set
+    theme = options[:theme]
+    options = theme ? Chart::Theme.load(theme).to_options.merge(options) : options 
+    # Extract the format and optional filename, then clean the hash
+    format = options[:format] || 'url'
+    @@file_name = options[:filename] unless options[:filename].nil?
+    options.delete(:format)
+    options.delete(:filename)
+    #update map_colors to be bar_colors
+    options.update(:bar_colors => options[:map_colors]) if options.has_key?(:map_colors)
+    # create the chart and return it in the format asked for
+    if @@types.include?(m.to_s)  
+      chart = new(options.merge!({:type => m}))
+      chart.send(format)
+    elsif m.to_s == 'version' 
+      Gchart::VERSION::STRING
+    else
+      "#{m} is not a supported chart format, please use one of the following: #{supported_types}."
+    end  
+  end
+  
+  def initialize(options={})
+      @type = :line
+      @data = []
+      @width = 300
+      @height = 200
+      @horizontal = false
+      @grouped = false
+      @encoding = 'simple'
+      self.min_value = 'auto'
+      self.max_value = 'auto'
+      # Sets the alt tag when chart is exported as image tag
+      @alt = 'Google Chart'
+      # Sets the CSS id selector when chart is exported as image tag
+      @id = false
+      # Sets the CSS class selector when chart is exported as image tag
+      @class = false
+
+      # set the options value if definable
+      options.each do |attribute, value|
+          send("#{attribute.to_s}=", value) if self.respond_to?("#{attribute}=")
+      end
+  end
+  
+  def self.supported_types
+    @@types.join(' ')
+  end
+  
+  # Defines the Graph size using the following format:
+  # width X height
+  def size=(size='300x200')
+    @width, @height = size.split("x").map { |dimension| dimension.to_i }
+  end
+  
+  def size
+    "#{@width}x#{@height}"
+  end
+
+  def dimensions
+    # TODO: maybe others?
+    [:line_xy, :scatter].include?(@type) ? 2 : 1
+  end
+
+  # Sets the orientation of a bar graph
+  def orientation=(orientation='h')
+    if orientation == 'h' || orientation == 'horizontal'
+      self.horizontal = true
+    elsif orientation == 'v' || orientation == 'vertical'
+      self.horizontal = false
+    end
+  end
+  
+  # Sets the bar graph presentation (stacked or grouped)
+  def stacked=(option=true)
+   @grouped = option ? false : true
+  end
+  
+  def bg=(options)
+    if options.is_a?(String)
+      @bg_color = options
+    elsif options.is_a?(Hash)
+      @bg_color = options[:color]
+      @bg_type = options[:type]
+      @bg_angle = options[:angle]
+    end
+  end
+  
+  def graph_bg=(options)
+    if options.is_a?(String)
+      @chart_color = options
+    elsif options.is_a?(Hash)
+      @chart_color = options[:color]
+      @chart_type = options[:type]
+      @chart_angle = options[:angle]
+    end
+  end
+
+  def max_value=(max_value)
+    @max_value = max_value
+    @max_value = nil if ['auto', :auto].include? @max_value
+    @max_value = false if ['false', :false].include? @max_value
+  end
+
+  def min_value=(min_value)
+    @min_value = min_value
+    @min_value = nil if ['auto', :auto].include? @min_value
+    @min_value = false if ['false', :false].include? @min_value
+  end
+
+  # auto sets the range if required
+  # it also sets the axis_range if not defined
+  def full_data_range(ds)
+    return if @max_value == false
+
+    @axis = []
+    # TODO: text encoding should use @axis too
+    if dimensions == 2 and @encoding != :text
+      ds.each_with_index do |mds,index|
+        cmds = mds.compact
+        if cmds.empty?
+          @axis << nil
+          next
+        end
+        @axis[index%dimensions] ||= []
+        ax = @axis[index%dimensions]
+        ax[0] = @min_value.nil? ? [ax[0], cmds.min].compact.min : @min_value
+        ax[1] = @max_value.nil? ? [ax[0], cmds.max].compact.max : @max_value
+      end
+    else
+      @min_value = ds.compact.map{|mds| mds.compact.min}.min if @min_value.nil?
+      @max_value = ds.compact.map{|mds| mds.compact.max}.max if @max_value.nil?
+      @axis << [@min_value, @max_value]
+    end
+
+    if not @axis_range
+      @axis_range = @axis.map{|axis| axis.nil? ? [] : axis}
+      if @type != :line_xy and (@type != :bar or not @horizontal)
+        tmp = @axis_range.fetch(0, [])
+        @axis_range[0] = @axis_range.fetch(1, [])
+        @axis_range[1] = tmp
+      end
+    end
+  end
+  
+  def dataset
+    @dataset ||= prepare_dataset(data)
+    full_data_range(@dataset)
+    @dataset
+  end
+  
+  def self.jstize(string)
+    string.gsub(' ', '+').gsub(/\[|\{|\}|\||\\|\^|\[|\]|\`|\]/) {|c| "%#{c[0].to_s(16).upcase}"}
+  end    
+  # load all the custom aliases
+  require 'gchart/aliases'
+  
+  protected
+  
+  # Returns the chart's generated PNG as a blob. (borrowed from John's gchart.rubyforge.org)
+  def fetch
+    open(query_builder) { |io| io.read }
+  end
+
+  # Writes the chart's generated PNG to a file. (borrowed from John's gchart.rubyforge.org)
+  def write(io_or_file=@@file_name)
+    return io_or_file.write(fetch) if io_or_file.respond_to?(:write)
+    open(io_or_file, "w+") { |io| io.write(fetch) }
+  end
+  
+  # Format
+  
+  def image_tag
+    image = "<img"
+    image += " id=\"#{@id}\"" if @id  
+    image += " class=\"#{@class}\"" if @class      
+    image += " src=\"#{query_builder(:html)}\""
+    image += " width=\"#{@width}\""
+    image += " height=\"#{@height}\""
+    image += " alt=\"#{@alt}\""
+    image += " title=\"#{@title}\"" if @title
+    image += " />"
+  end
+  
+  alias_method :img_tag, :image_tag
+  
+  def url
+    query_builder
+  end
+  
+  def file
+    write
+  end
+  
+  #
+  def jstize(string)
+    Gchart.jstize(string)
+  end 
+  
+  private
+  
+  # The title size cannot be set without specifying a color.
+  # A dark key will be used for the title color if no color is specified 
+  def set_title
+    title_params = "chtt=#{title}"
+    unless (title_color.nil? && title_size.nil? )
+      title_params << "&chts=" + (color, size = (@title_color || '454545'), @title_size).compact.join(',')
+    end
+    title_params
+  end
+  
+  def set_size
+    "chs=#{size}"
+  end
+  
+  def set_data
+    data = send("#{@encoding}_encoding")
+    "chd=#{data}"
+  end
+  
+  def set_colors
+    bg_type = fill_type(@bg_type) || 's' if @bg_color
+    chart_type = fill_type(@chart_type) || 's' if @chart_color
+    
+    "chf=" + {'bg' => fill_for(bg_type, @bg_color, @bg_angle), 'c' => fill_for(chart_type, @chart_color, @chart_angle)}.map{|k,v| "#{k},#{v}" unless v.nil?}.compact.join('|')      
+  end
+  
+  # set bar, line colors
+  def set_bar_colors
+    @bar_colors = @bar_colors.join(',') if @bar_colors.is_a?(Array)
+    "chco=#{@bar_colors}"
+  end
+  
+  def set_country_codes
+    @country_codes = @country_codes.join() if @country_codes.is_a?(Array)
+    "chld=#{@country_codes}"
+  end
+  
+  # set bar spacing
+  # chbh=
+  # <bar width in pixels>,
+  # <optional space between bars in a group>,
+  # <optional space between groups>
+  def set_bar_width_and_spacing
+    width_and_spacing_values = case @bar_width_and_spacing
+    when String
+      @bar_width_and_spacing
+    when Array
+      @bar_width_and_spacing.join(',')
+    when Hash
+      width = @bar_width_and_spacing[:width] || 23
+      spacing = @bar_width_and_spacing[:spacing] || 4
+      group_spacing = @bar_width_and_spacing[:group_spacing] || 8
+      [width,spacing,group_spacing].join(',')
+    else
+      @bar_width_and_spacing.to_s
+    end
+    "chbh=#{width_and_spacing_values}"
+  end
+  
+  def set_range_markers
+    markers = case @range_markers
+    when Hash
+      set_range_marker(@range_markers)
+    when Array
+      range_markers.collect{|marker| set_range_marker(marker)}.join('|')
+    end
+    "chm=#{markers}"
+  end
+  
+  def set_range_marker(options)
+    orientation = ['vertical', 'Vertical', 'V', 'v', 'R'].include?(options[:orientation]) ? 'R' : 'r'
+    "#{orientation},#{options[:color]},0,#{options[:start_position]},#{options[:stop_position]}#{',1' if options[:overlaid?]}"  
+  end
+  
+  def fill_for(type=nil, color='', angle=nil)
+    unless type.nil? 
+      case type
+        when 'lg'
+          angle ||= 0
+          color = "#{color},0,ffffff,1" if color.split(',').size == 1
+          "#{type},#{angle},#{color}"
+        when 'ls'
+          angle ||= 90
+          color = "#{color},0.2,ffffff,0.2" if color.split(',').size == 1
+          "#{type},#{angle},#{color}"
+        else
+          "#{type},#{color}"
+        end
+    end
+  end
+  
+  # A chart can have one or many legends. 
+  # Gchart.line(:legend => 'label')
+  # or
+  # Gchart.line(:legend => ['first label', 'last label'])
+  def set_legend
+    return set_labels if @type == :pie || @type == :pie_3d || @type == :meter
+    
+    if @legend.is_a?(Array)
+      "chdl=#{@legend.map{|label| "#{CGI::escape(label)}"}.join('|')}"
+    else
+      "chdl=#{@legend}"
+    end
+    
+  end
+  
+  def set_labels
+     if @legend.is_a?(Array)
+        "chl=#{@legend.map{|label| "#{label}"}.join('|')}"
+      else
+        "chl=#{@legend}"
+      end
+  end
+  
+  def set_axis_with_labels
+    @axis_with_labels = @axis_with_labels.join(',') if @axis_with_labels.is_a?(Array)
+    "chxt=#{@axis_with_labels}"
+  end
+  
+  def set_axis_labels
+    if axis_labels.is_a?(Array)
+      labels_arr = axis_labels.enum_with_index.map{|labels,index| [index,labels]}
+    elsif axis_labels.is_a?(Hash)
+      labels_arr = axis_labels.to_a
+    end
+    labels_arr.map! do |index,labels|
+      if labels.is_a?(Array)
+        "#{index}:|#{labels.to_a.join('|')}"
+      else
+        "#{index}:|#{labels}"
+      end
+    end
+    "chxl=#{labels_arr.join('|')}"
+  end
+  
+  # http://code.google.com/apis/chart/labels.html#axis_range
+  # Specify a range for axis labels
+  def set_axis_range
+    # a passed axis_range should look like:
+    # [[10,100]] or [[10,100,4]] or [[10,100], [20,300]]
+    # in the second example, 4 is the interval 
+    dataset # just making sure we processed the data before
+    if axis_range && axis_range.respond_to?(:each) && axis_range.first.respond_to?(:each)
+     'chxr=' + axis_range.enum_for(:each_with_index).map{|range, index| [index, range[0], range[1], range[2]].compact.join(',')}.join("|")
+    else
+      nil
+    end
+  end
+  
+  def set_geographical_area
+    "chtm=#{@geographical_area}"
+  end
+  
+  def set_type
+    case @type
+      when :line
+        "cht=lc"
+      when :line_xy
+        "cht=lxy"
+      when :bar
+        "cht=b" + (horizontal? ? "h" : "v") + (grouped? ? "g" : "s")
+      when :pie_3d
+        "cht=p3"
+      when :pie
+        "cht=p"
+      when :venn
+        "cht=v"
+      when :scatter
+        "cht=s"
+      when :sparkline
+        "cht=ls"
+      when :meter
+        "cht=gom"
+      when :map
+        "cht=t"
+      end
+  end
+  
+  def fill_type(type)
+    case type
+    when 'solid'
+      's'
+    when 'gradient'
+      'lg'
+    when 'stripes'
+      'ls'
+    end
+  end
+  
+  # Wraps a single dataset inside another array to support more datasets
+  def prepare_dataset(ds)
+    ds = [ds] unless ds.first.is_a?(Array)
+    ds
+  end
+
+  def encode_scaled_dataset chars, nil_char
+    dataset.enum_with_index.map do |ds, index|
+      if @max_value != false
+        ax = @axis[index%dimensions]
+        min = ax[0]
+        range = ax[1] - min
+        range = 1 if range == 0
+      end
+      ds.map do |number|
+       if number.nil?
+         nil_char
+       else
+         if not range.nil?
+           number = chars.size * (number - min) / range
+           number = [number, chars.size - 1].min
+         end
+         chars[number.to_i]
+       end
+      end.join
+    end.join(',')
+  end
+
+  # http://code.google.com/apis/chart/#simple
+  # Simple encoding has a resolution of 62 different values. 
+  # Allowing five pixels per data point, this is sufficient for line and bar charts up
+  # to about 300 pixels. Simple encoding is suitable for all other types of chart regardless of size.
+  def simple_encoding
+    "s:" + encode_scaled_dataset(@@simple_chars, '_')
+  end
+
+  # http://code.google.com/apis/chart/#text
+  # Text encoding with data scaling lets you specify arbitrary positive or
+  # negative floating point numbers, in combination with a scaling parameter
+  # that lets you specify a custom range for your chart. This chart is useful
+  # when you don't want to worry about limiting your data to a specific range,
+  # or do the calculations to scale your data down or up to fit nicely inside
+  # a chart.
+  #
+  # Valid values range from (+/-)9.999e(+/-)100, and only four non-zero digits are supported (that is, 123400, 1234, 12.34, and 0.1234 are valid, but 12345, 123.45 and 123400.5 are not).
+  #
+  # This encoding is not available for maps.
+  #
+  def text_encoding
+    # TODO: text encoding should use @axis too
+    "t:" + dataset.map{ |ds| ds.join(',') }.join('|') + "&chds=#{@min_value},#{@max_value}"
+  end
+
+  # http://code.google.com/apis/chart/#extended
+  # Extended encoding has a resolution of 4,096 different values 
+  # and is best used for large charts where a large data range is required.
+  def extended_encoding
+    "e:" + encode_scaled_dataset(@@ext_pairs, '__')
+  end
+
+  def query_builder(options="")
+    dataset 
+    query_params = instance_variables.map do |var|
+      case var
+      when '@data'
+        set_data unless @data == []  
+      # Set the graph size  
+      when '@width'
+        set_size unless @width.nil? || @height.nil?
+      when '@type'
+        set_type
+      when '@title'
+        set_title unless @title.nil?
+      when '@legend'
+        set_legend unless @legend.nil?
+      when '@bg_color'
+        set_colors
+      when '@chart_color'
+        set_colors if @bg_color.nil?
+      when '@bar_colors'
+        set_bar_colors
+      when '@bar_width_and_spacing'
+        set_bar_width_and_spacing
+      when '@axis_with_labels'
+        set_axis_with_labels
+      when '@axis_range'
+        set_axis_range if dataset
+      when '@axis_labels'
+        set_axis_labels
+      when '@range_markers'
+        set_range_markers
+      when '@geographical_area'
+        set_geographical_area
+      when '@country_codes'
+        set_country_codes
+      when '@custom'
+        @custom
+      end
+    end.compact
+    
+    # Use ampersand as default delimiter
+    unless options == :html
+      delimiter = '&'
+    # Escape ampersand for html image tags
+    else
+      delimiter = '&amp;'
+    end
+    
+    jstize(@@url + query_params.join(delimiter))
+  end
+  
+end