Class: Gchart

Inherits:
Object
  • Object
show all
Includes:
GchartInfo
Defined in:
lib/gchart.rb,
lib/gchart/aliases.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Gchart

Returns a new instance of Gchart.



70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
 
# File 'lib/gchart.rb', line 70

def initialize(options={})
  @type = options[:type] || 'line'
  @data = []
  @width = 300
  @height = 200
  @horizontal = false
  @grouped = false
  @encoding = 'simple'
  # @max_value = 'auto'
  # @min_value defaults to nil meaning zero
  @filename = options[:filename]
  # 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
  @klass = options[:class] || false
  # set the options value if definable
  options.each do |attribute, value| 
    send("#{attribute}=", value) if self.respond_to?("#{attribute}=")
  end
end

Instance Attribute Details

#alt ⇒ Object

Returns the value of attribute alt.



36
37
38
 
# File 'lib/gchart.rb', line 36

def alt
  @alt
end

#axis_labels ⇒ Object

Returns the value of attribute axis_labels.



36
37
38
 
# File 'lib/gchart.rb', line 36

def axis_labels
  @axis_labels
end

#axis_range ⇒ Object

Returns the value of attribute axis_range.



36
37
38
 
# File 'lib/gchart.rb', line 36

def axis_range
  @axis_range
end

#axis_with_labels ⇒ Object

Returns the value of attribute axis_with_labels.



36
37
38
 
# File 'lib/gchart.rb', line 36

def axis_with_labels
  @axis_with_labels
end

#bar_colors ⇒ Object

Returns the value of attribute bar_colors.



36
37
38
 
# File 'lib/gchart.rb', line 36

def bar_colors
  @bar_colors
end

#bar_width_and_spacing ⇒ Object

Returns the value of attribute bar_width_and_spacing.



36
37
38
 
# File 'lib/gchart.rb', line 36

def bar_width_and_spacing
  @bar_width_and_spacing
end

#bg_angle ⇒ Object

Returns the value of attribute bg_angle.



40
41
42
 
# File 'lib/gchart.rb', line 40

def bg_angle
  @bg_angle
end

#bg_color ⇒ Object

Returns the value of attribute bg_color.



40
41
42
 
# File 'lib/gchart.rb', line 40

def bg_color
  @bg_color
end

#bg_type ⇒ Object

Returns the value of attribute bg_type.



40
41
42
 
# File 'lib/gchart.rb', line 40

def bg_type
  @bg_type
end

#chart_angle ⇒ Object

Returns the value of attribute chart_angle.



40
41
42
 
# File 'lib/gchart.rb', line 40

def chart_angle
  @chart_angle
end

#chart_color ⇒ Object

Returns the value of attribute chart_color.



40
41
42
 
# File 'lib/gchart.rb', line 40

def chart_color
  @chart_color
end

#chart_type ⇒ Object

Returns the value of attribute chart_type.



40
41
42
 
# File 'lib/gchart.rb', line 40

def chart_type
  @chart_type
end

#colors ⇒ Object

Returns the value of attribute colors.



36
37
38
 
# File 'lib/gchart.rb', line 36

def colors
  @colors
end

#country_codes ⇒ Object

Returns the value of attribute country_codes.



36
37
38
 
# File 'lib/gchart.rb', line 36

def country_codes
  @country_codes
end

#custom ⇒ Object

Returns the value of attribute custom.



36
37
38
 
# File 'lib/gchart.rb', line 36

def custom
  @custom
end

#data ⇒ Object

Returns the value of attribute data.



36
37
38
 
# File 'lib/gchart.rb', line 36

def data
  @data
end

#encoding ⇒ Object

Returns the value of attribute encoding.



36
37
38
 
# File 'lib/gchart.rb', line 36

def encoding
  @encoding
end

#filename ⇒ Object

Returns the value of attribute filename.



36
37
38
 
# File 'lib/gchart.rb', line 36

def filename
  @filename
end

#geographical_area ⇒ Object

Returns the value of attribute geographical_area.



36
37
38
 
# File 'lib/gchart.rb', line 36

def geographical_area
  @geographical_area
end

#grid_lines ⇒ Object

Returns the value of attribute grid_lines.



40
41
42
 
# File 'lib/gchart.rb', line 40

def grid_lines
  @grid_lines
end

#grouped ⇒ Object Also known as: grouped?

Returns the value of attribute grouped.



36
37
38
 
# File 'lib/gchart.rb', line 36

def grouped
  @grouped
end

#height ⇒ Object

Returns the value of attribute height.



36
37
38
 
# File 'lib/gchart.rb', line 36

def height
  @height
end

#horizontal ⇒ Object Also known as: horizontal?

Returns the value of attribute horizontal.



36
37
38
 
# File 'lib/gchart.rb', line 36

def horizontal
  @horizontal
end

#id ⇒ Object

Returns the value of attribute id.



36
37
38
 
# File 'lib/gchart.rb', line 36

def id
  @id
end

#klass ⇒ Object

Returns the value of attribute klass.



36
37
38
 
# File 'lib/gchart.rb', line 36

def klass
  @klass
end

#legend ⇒ Object

Returns the value of attribute legend.



36
37
38
 
# File 'lib/gchart.rb', line 36

def legend
  @legend
end

#map_colors ⇒ Object

Returns the value of attribute map_colors.



36
37
38
 
# File 'lib/gchart.rb', line 36

def map_colors
  @map_colors
end

#max ⇒ Object

Returns the value of attribute max.



36
37
38
 
# File 'lib/gchart.rb', line 36

def max
  @max
end

#max_value ⇒ Object

Returns the value of attribute max_value.



42
43
44
 
# File 'lib/gchart.rb', line 42

def max_value
  @max_value
end

#min ⇒ Object

Returns the value of attribute min.



36
37
38
 
# File 'lib/gchart.rb', line 36

def min
  @min
end

#min_value ⇒ Object

Returns the value of attribute min_value.



42
43
44
 
# File 'lib/gchart.rb', line 42

def min_value
  @min_value
end

#new_markers ⇒ Object

Returns the value of attribute new_markers.



40
41
42
 
# File 'lib/gchart.rb', line 40

def new_markers
  @new_markers
end

#range_markers ⇒ Object

Returns the value of attribute range_markers.



36
37
38
 
# File 'lib/gchart.rb', line 36

def range_markers
  @range_markers
end

#thickness ⇒ Object

Returns the value of attribute thickness.



40
41
42
 
# File 'lib/gchart.rb', line 40

def thickness
  @thickness
end

#title ⇒ Object

Returns the value of attribute title.



36
37
38
 
# File 'lib/gchart.rb', line 36

def title
  @title
end

#title_color ⇒ Object

Returns the value of attribute title_color.



36
37
38
 
# File 'lib/gchart.rb', line 36

def title_color
  @title_color
end

#title_size ⇒ Object

Returns the value of attribute title_size.



36
37
38
 
# File 'lib/gchart.rb', line 36

def title_size
  @title_size
end

#type ⇒ Object

Returns the value of attribute type.



36
37
38
 
# File 'lib/gchart.rb', line 36

def type
  @type
end

#width ⇒ Object

Returns the value of attribute width.



36
37
38
 
# File 'lib/gchart.rb', line 36

def width
  @width
end

Class Method Details

.chars ⇒ Object 



24
25
26
 
# File 'lib/gchart.rb', line 24

def self.chars
  @chars ||= simple_chars + ['-', '.']
end

.default_filename ⇒ Object 



32
33
34
 
# File 'lib/gchart.rb', line 32

def self.default_filename
  'chart.png'
end

.ext_pairs ⇒ Object 



28
29
30
 
# File 'lib/gchart.rb', line 28

def self.ext_pairs
  @ext_pairs ||= chars.map { |char_1| chars.map { |char_2| char_1 + char_2 } }.flatten
end

.jstize(string) ⇒ Object 



253
254
255
256
257
 
# File 'lib/gchart.rb', line 253

def self.jstize(string)
  # See discussion: http://github.com/mattetti/googlecharts/commit/9b5cfb93aa51aae06611057668e631cd515ec4f3#comment_51347
  string.gsub(' ', '+').gsub(/\[|\{|\}|\\|\^|\[|\]|\`|\]/) {|c| "%#{c[0].to_s.upcase}"}
  #string.gsub(' ', '+').gsub(/\[|\{|\}|\||\\|\^|\[|\]|\`|\]/) {|c| "%#{c[0].to_s.upcase}"}
end

.method_missing(m, options = {}) ⇒ Object

Raises:

  • (NoMethodError) 


66
67
68
 
# File 'lib/gchart.rb', line 66

def self.method_missing(m, options={})
  raise NoMethodError, "#{m} is not a supported chart format, please use one of the following: #{supported_types}."
end

.simple_chars ⇒ Object 



20
21
22
 
# File 'lib/gchart.rb', line 20

def self.simple_chars
  @simple_chars ||= ('A'..'Z').to_a + ('a'..'z').to_a + ('0'..'9').to_a
end

.supported_types ⇒ Object 



94
95
96
 
# File 'lib/gchart.rb', line 94

def self.supported_types
  Gchart.types.join(' ')
end

.types ⇒ Object 



16
17
18
 
# File 'lib/gchart.rb', line 16

def self.types
  @types ||= ['line', 'line_xy', 'scatter', 'bar', 'venn', 'pie', 'pie_3d', 'jstize', 'sparkline', 'meter', 'map']
end

.url ⇒ Object 



12
13
14
 
# File 'lib/gchart.rb', line 12

def self.url
  "http://chart.apis.google.com/chart?" 
end

.version ⇒ Object 



62
63
64
 
# File 'lib/gchart.rb', line 62

def self.version
  Gchart::VERSION::STRING
end

Instance Method Details

#bg=(options) ⇒ Object Also known as: background= 



135
136
137
138
139
140
141
142
143
 
# File 'lib/gchart.rb', line 135

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

#dataset ⇒ Object 



230
231
232
233
234
235
236
237
238
 
# File 'lib/gchart.rb', line 230

def dataset
  if @dataset
    @dataset 
  else
    @dataset = convert_dataset(data || [])
    full_data_range(@dataset)   # unless axis_range
    @dataset
  end
end

#datasets ⇒ Object

Sets of data to handle multiple sets



241
242
243
244
245
246
247
248
249
250
251
 
# File 'lib/gchart.rb', line 241

def datasets
  datasets = []
  dataset.each do |d|
    if d[:data].first.is_a?(Array)
      datasets += d[:data]
    else
      datasets << d[:data]
    end
  end
  datasets
end

#dimensions ⇒ Object 



116
117
118
119
 
# File 'lib/gchart.rb', line 116

def dimensions
  # TODO: maybe others?
  [:line_xy, :scatter].include?(type) ? 2 : 1
end

#fetch ⇒ Object

Returns the chart’s generated PNG as a blob. (borrowed from John’s gchart.rubyforge.org)



262
263
264
 
# File 'lib/gchart.rb', line 262

def fetch
  open(query_builder) { |io| io.read }
end

#file ⇒ Object 



293
294
295
 
# File 'lib/gchart.rb', line 293

def file
  write
end

#full_data_range(ds) ⇒ Object

returns the full data range as an array it also sets the data range if not defined



173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
 
# File 'lib/gchart.rb', line 173

def full_data_range(ds)
  return if max_value == false

  ds.each_with_index do |mds, mds_index|
    mds[:min_value] ||= min_value
    mds[:max_value] ||= max_value
    
    if mds_index == 0 && type.to_s == 'bar'
      # TODO: unless you specify a zero line (using chp or chds),
      #       the min_value of a bar chart is always 0.
      #mds[:min_value] ||= mds[:data].first.to_a.compact.min
      mds[:min_value] ||= 0
    end
    if (mds_index == 0 && type.to_s == 'bar' && 
      !grouped && mds[:data].first.is_a?(Array))
      totals = []
      mds[:data].each do |l|
        l.each_with_index do |v, index|
          next if v.nil?
          totals[index] ||= 0
          totals[index] += v
        end
      end
      mds[:max_value] ||= totals.compact.max
    else
      all = mds[:data].flatten.compact
      # default min value should be 0 unless set to auto
      if mds[:min_value] == 'auto'
        mds[:min_value] = all.min
      else
        min = all.min
        mds[:min_value] ||=  (min && min < 0 ? min : 0)
      end
      mds[:max_value] ||= all.max
    end
  end

  unless axis_range
    @axis_range = ds.map{|mds| [mds[:min_value], mds[:max_value]]}
    if dimensions == 1 && (type.to_s != 'bar' || horizontal)
      tmp = axis_range.fetch(0, [])
      @axis_range[0] = axis_range.fetch(1, [])
      @axis_range[1] = tmp
    end
  end
  # return [min, max] unless (min.nil? || max.nil?)
  # @max = (max_value.nil? || max_value == 'auto') ? ds.compact.map{|mds| mds.compact.max}.max : max_value
  # 
  # if min_value.nil? 
  #   min_ds_value = ds.compact.map{|mds| mds.compact.min}.min || 0
  #   @min = (min_ds_value < 0) ? min_ds_value : 0
  # else
  #   @min = min_value == 'auto' ? ds.compact.map{|mds| mds.compact.min}.min || 0 : min_value      
  # end
  # @axis_range = [[min,max]]
end

#graph_bg=(options) ⇒ Object Also known as: chart_bg=, chart_color=, chart_background= 



145
146
147
148
149
150
151
152
153
 
# File 'lib/gchart.rb', line 145

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

#image_tag ⇒ Object Also known as: img_tag

Format



275
276
277
278
279
280
281
282
283
284
285
 
# File 'lib/gchart.rb', line 275

def image_tag
  image = "<img"
  image += " id=\"#{id}\"" if id  
  image += " class=\"#{klass}\"" if klass      
  image += " src=\"#{query_builder(:html)}\""
  image += " width=\"#{width}\""
  image += " height=\"#{height}\""
  image += " alt=\"#{alt}\""
  image += " title=\"#{title}\"" if title
  image += " />"
end

#jstize(string) ⇒ Object 



298
299
300
 
# File 'lib/gchart.rb', line 298

def jstize(string)
  Gchart.jstize(string)
end

#orientation=(orientation = 'h') ⇒ Object

Sets the orientation of a bar graph



122
123
124
125
126
127
128
 
# File 'lib/gchart.rb', line 122

def orientation=(orientation='h')
  if orientation == 'h' || orientation == 'horizontal'
    self.horizontal = true
  elsif orientation == 'v' || orientation == 'vertical'
    self.horizontal = false
  end
end

#size ⇒ Object 



112
113
114
 
# File 'lib/gchart.rb', line 112

def size
  "#{width}x#{height}"
end

#size=(size = '300x200') ⇒ Object

Defines the Graph size using the following format: width X height



100
101
102
 
# File 'lib/gchart.rb', line 100

def size=(size='300x200')
  @width, @height = size.split("x").map { |dimension| dimension.to_i }
end

#stacked=(option = true) ⇒ Object

Sets the bar graph presentation (stacked or grouped)



131
132
133
 
# File 'lib/gchart.rb', line 131

def stacked=(option=true)
  @grouped = option ? false : true
end

#url ⇒ Object 



289
290
291
 
# File 'lib/gchart.rb', line 289

def url
  query_builder
end

#write ⇒ Object

Writes the chart’s generated PNG to a file. (borrowed from John’s gchart.rubyforge.org)



267
268
269
270
271
 
# File 'lib/gchart.rb', line 267

def write
  io_or_file = filename || Gchart.default_filename
  return io_or_file.write(fetch) if io_or_file.respond_to?(:write)
  open(io_or_file, "wb+") { |io| io.write(fetch) }
end