Class: Gruff::Base
- Inherits:
-
Object
- Object
- Gruff::Base
- Includes:
- Deprecated, Magick
- Defined in:
- lib/gruff/base.rb
Direct Known Subclasses
Area, Bar, Bullet, Dot, Line, Net, PhotoBar, Pie, Scatter, Scene, SideBar, Spider, StackedArea, StackedBar
Defined Under Namespace
Modules: StackedMixin
Constant Summary collapse
- DEBUG =
Draw extra lines showing where the margins and text centers are
false
- DATA_LABEL_INDEX =
Used for navigating the array of data to plot
0
- DATA_VALUES_INDEX =
1
- DATA_COLOR_INDEX =
2
- DATA_VALUES_X_INDEX =
3
- LEGEND_MARGIN =
Space around text elements. Mostly used for vertical spacing
TITLE_MARGIN = 20.0
- LABEL_MARGIN =
10.0
- DEFAULT_MARGIN =
20.0
- DEFAULT_TARGET_WIDTH =
800
- THOUSAND_SEPARATOR =
','
Instance Attribute Summary collapse
-
#additional_line_values ⇒ Object
Experimental.
-
#bottom_margin ⇒ Object
Blank space below the graph.
-
#center_labels_over_point ⇒ Object
Used internally for spacing.
-
#colors ⇒ Object
Get or set the list of colors that will be used to draw the bars or lines.
-
#font ⇒ Object
Font used for titles, labels, etc.
-
#font_color ⇒ Object
Returns the value of attribute font_color.
-
#has_left_labels ⇒ Object
Used internally for horizontal graph types.
-
#hide_legend ⇒ Object
Prevent drawing of the legend.
-
#hide_line_markers ⇒ Object
Prevent drawing of line markers.
-
#hide_line_numbers ⇒ Object
Prevent drawing of line numbers.
-
#hide_title ⇒ Object
Prevent drawing of the title.
-
#labels ⇒ Object
A hash of names for the individual columns, where the key is the array index for the column this label represents.
-
#left_margin ⇒ Object
Blank space to the left of the graph.
-
#legend_box_size ⇒ Object
Optionally set the size of the colored box by each item in the legend.
-
#legend_font_size ⇒ Object
Optionally set the size of the font.
-
#legend_margin ⇒ Object
Blank space below the legend.
-
#marker_color ⇒ Object
The color of the auxiliary lines.
-
#marker_count ⇒ Object
The number of horizontal lines shown for reference.
-
#marker_font_size ⇒ Object
The font size of the labels around the graph.
-
#maximum_value ⇒ Object
You can manually set a maximum value, such as a percentage-based graph that always goes to 100.
-
#minimum_value ⇒ Object
You can manually set a minimum value instead of having the values guessed for you.
-
#no_data_message ⇒ Object
Message shown when there is no data.
-
#right_margin ⇒ Object
Blank space to the right of the graph.
-
#sort ⇒ Object
Set to false if you don’t want the data to be sorted with largest avg values at the back.
-
#stacked ⇒ Object
Experimental.
-
#title ⇒ Object
The large title of the graph displayed at the top.
-
#title_font_size ⇒ Object
The font size of the large title at the top of the graph.
-
#title_margin ⇒ Object
Blank space below the title.
-
#top_margin ⇒ Object
Blank space above the graph.
-
#x_axis_label ⇒ Object
A label for the bottom of the graph.
-
#y_axis_increment ⇒ Object
Manually set increment of the horizontal marking lines.
-
#y_axis_label ⇒ Object
A label for the left side of the graph.
Instance Method Summary collapse
-
#add_color(colorname) ⇒ Object
Add a color to the list of available colors for lines.
-
#data(name, data_points = [], color = nil) ⇒ Object
Parameters are an array where the first element is the name of the dataset and the value is an array of values to plot.
-
#initialize(target_width = DEFAULT_TARGET_WIDTH) ⇒ Base
constructor
If one numerical argument is given, the graph is drawn at 4/3 ratio according to the given width (800 results in 800x600, 400 gives 400x300, etc.).
-
#initialize_ivars ⇒ Object
Set instance variables for this object.
-
#margins=(margin) ⇒ Object
Sets the top, bottom, left and right margins to
margin
. -
#replace_colors(color_list = []) ⇒ Object
Replace the entire color list with a new array of colors.
-
#theme=(options) ⇒ Object
You can set a theme manually.
-
#theme_37signals ⇒ Object
A color scheme plucked from the colors on the popular usability blog.
-
#theme_greyscale ⇒ Object
A greyscale theme.
-
#theme_keynote ⇒ Object
A color scheme similar to the popular presentation software.
-
#theme_odeo ⇒ Object
A color scheme similar to that used on the popular podcast site.
-
#theme_pastel ⇒ Object
A pastel theme.
-
#theme_rails_keynote ⇒ Object
A color scheme from the colors used on the 2005 Rails keynote presentation at RubyConf.
-
#to_blob(fileformat = 'PNG') ⇒ Object
Return the graph as a rendered binary blob.
-
#write(filename = "graph.png") ⇒ Object
Writes the graph to a file.
Methods included from Deprecated
#graph_height, #graph_left, #graph_top, #graph_width, #scale_measurements, #total_height
Constructor Details
#initialize(target_width = DEFAULT_TARGET_WIDTH) ⇒ Base
If one numerical argument is given, the graph is drawn at 4/3 ratio according to the given width (800 results in 800x600, 400 gives 400x300, etc.).
Or, send a geometry string for other ratios (‘800x400’, ‘400x225’).
Looks for Bitstream Vera as the default font. Expects an environment var of MAGICK_FONT_PATH to be set. (Uses RMagick’s default font otherwise.)
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 |
# File 'lib/gruff/base.rb', line 180 def initialize(target_width=DEFAULT_TARGET_WIDTH) if not Numeric === target_width geometric_width, geometric_height = target_width.split('x') @columns = geometric_width.to_f @rows = geometric_height.to_f else @columns = target_width.to_f @rows = target_width.to_f * 0.75 end initialize_ivars reset_themes theme_keynote end |
Instance Attribute Details
#additional_line_values ⇒ Object
Experimental
161 162 163 |
# File 'lib/gruff/base.rb', line 161 def additional_line_values @additional_line_values end |
#bottom_margin ⇒ Object
Blank space below the graph
49 50 51 |
# File 'lib/gruff/base.rb', line 49 def bottom_margin @bottom_margin end |
#center_labels_over_point ⇒ Object
Used internally for spacing.
By default, labels are centered over the point they represent.
74 75 76 |
# File 'lib/gruff/base.rb', line 74 def center_labels_over_point @center_labels_over_point end |
#colors ⇒ Object
Get or set the list of colors that will be used to draw the bars or lines.
91 92 93 |
# File 'lib/gruff/base.rb', line 91 def colors @colors end |
#font ⇒ Object
Font used for titles, labels, etc. Works best if you provide the full path to the TTF font file. RMagick must be built with the Freetype libraries for this to work properly.
Tries to find Bitstream Vera (Vera.ttf) in the location specified by ENV. Uses default RMagick font otherwise.
The font= method below fulfills the role of the writer, so we only need a reader here.
105 106 107 |
# File 'lib/gruff/base.rb', line 105 def font @font end |
#font_color ⇒ Object
Returns the value of attribute font_color.
107 108 109 |
# File 'lib/gruff/base.rb', line 107 def font_color @font_color end |
#has_left_labels ⇒ Object
Used internally for horizontal graph types.
77 78 79 |
# File 'lib/gruff/base.rb', line 77 def has_left_labels @has_left_labels end |
#hide_legend ⇒ Object
Prevent drawing of the legend
113 114 115 |
# File 'lib/gruff/base.rb', line 113 def hide_legend @hide_legend end |
#hide_line_markers ⇒ Object
Prevent drawing of line markers
110 111 112 |
# File 'lib/gruff/base.rb', line 110 def hide_line_markers @hide_line_markers end |
#hide_line_numbers ⇒ Object
Prevent drawing of line numbers
119 120 121 |
# File 'lib/gruff/base.rb', line 119 def hide_line_numbers @hide_line_numbers end |
#hide_title ⇒ Object
Prevent drawing of the title
116 117 118 |
# File 'lib/gruff/base.rb', line 116 def hide_title @hide_title end |
#labels ⇒ Object
A hash of names for the individual columns, where the key is the array index for the column this label represents.
Not all columns need to be named.
Example: 0 => 2005, 3 => 2006, 5 => 2007, 7 => 2008
69 70 71 |
# File 'lib/gruff/base.rb', line 69 def labels @labels end |
#left_margin ⇒ Object
Blank space to the left of the graph
55 56 57 |
# File 'lib/gruff/base.rb', line 55 def left_margin @left_margin end |
#legend_box_size ⇒ Object
Optionally set the size of the colored box by each item in the legend. Default is 20.0
Will be scaled down if graph is smaller than 800px wide.
170 171 172 |
# File 'lib/gruff/base.rb', line 170 def legend_box_size @legend_box_size end |
#legend_font_size ⇒ Object
Optionally set the size of the font. Based on an 800x600px graph. Default is 20.
Will be scaled down if graph is smaller than 800px wide.
132 133 134 |
# File 'lib/gruff/base.rb', line 132 def legend_font_size @legend_font_size end |
#legend_margin ⇒ Object
Blank space below the legend
61 62 63 |
# File 'lib/gruff/base.rb', line 61 def legend_margin @legend_margin end |
#marker_color ⇒ Object
The color of the auxiliary lines
138 139 140 |
# File 'lib/gruff/base.rb', line 138 def marker_color @marker_color end |
#marker_count ⇒ Object
The number of horizontal lines shown for reference
141 142 143 |
# File 'lib/gruff/base.rb', line 141 def marker_count @marker_count end |
#marker_font_size ⇒ Object
The font size of the labels around the graph
135 136 137 |
# File 'lib/gruff/base.rb', line 135 def marker_font_size @marker_font_size end |
#maximum_value ⇒ Object
You can manually set a maximum value, such as a percentage-based graph that always goes to 100.
If you use this, you must set it after you have given all your data to the graph object.
154 155 156 |
# File 'lib/gruff/base.rb', line 154 def maximum_value @maximum_value end |
#minimum_value ⇒ Object
You can manually set a minimum value instead of having the values guessed for you.
Set it after you have given all your data to the graph object.
147 148 149 |
# File 'lib/gruff/base.rb', line 147 def minimum_value @minimum_value end |
#no_data_message ⇒ Object
Message shown when there is no data. Fits up to 20 characters. Defaults to “No Data.”
123 124 125 |
# File 'lib/gruff/base.rb', line 123 def @no_data_message end |
#right_margin ⇒ Object
Blank space to the right of the graph
52 53 54 |
# File 'lib/gruff/base.rb', line 52 def right_margin @right_margin end |
#sort ⇒ Object
Set to false if you don’t want the data to be sorted with largest avg values at the back.
158 159 160 |
# File 'lib/gruff/base.rb', line 158 def sort @sort end |
#stacked ⇒ Object
Experimental
164 165 166 |
# File 'lib/gruff/base.rb', line 164 def stacked @stacked end |
#title ⇒ Object
The large title of the graph displayed at the top
94 95 96 |
# File 'lib/gruff/base.rb', line 94 def title @title end |
#title_font_size ⇒ Object
The font size of the large title at the top of the graph
126 127 128 |
# File 'lib/gruff/base.rb', line 126 def title_font_size @title_font_size end |
#title_margin ⇒ Object
Blank space below the title
58 59 60 |
# File 'lib/gruff/base.rb', line 58 def title_margin @title_margin end |
#top_margin ⇒ Object
Blank space above the graph
46 47 48 |
# File 'lib/gruff/base.rb', line 46 def top_margin @top_margin end |
#x_axis_label ⇒ Object
A label for the bottom of the graph
80 81 82 |
# File 'lib/gruff/base.rb', line 80 def x_axis_label @x_axis_label end |
#y_axis_increment ⇒ Object
Manually set increment of the horizontal marking lines
88 89 90 |
# File 'lib/gruff/base.rb', line 88 def y_axis_increment @y_axis_increment end |
#y_axis_label ⇒ Object
A label for the left side of the graph
83 84 85 |
# File 'lib/gruff/base.rb', line 83 def y_axis_label @y_axis_label end |
Instance Method Details
#add_color(colorname) ⇒ Object
Add a color to the list of available colors for lines.
Example:
add_color('#c0e9d3')
262 263 264 |
# File 'lib/gruff/base.rb', line 262 def add_color(colorname) @colors << colorname end |
#data(name, data_points = [], color = nil) ⇒ Object
Parameters are an array where the first element is the name of the dataset and the value is an array of values to plot.
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().
Example:
data("Bart S.", [95, 45, 78, 89, 88, 76], '#ffcc00')
455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 |
# File 'lib/gruff/base.rb', line 455 def data(name, data_points=[], color=nil) data_points = Array(data_points) # make sure it's an array @data << [name, data_points, (color || increment_color)] # Set column count if this is larger than previous counts @column_count = (data_points.length > @column_count) ? data_points.length : @column_count # Pre-normalize data_points.each_with_index do |data_point, index| next if data_point.nil? # Setup max/min so spread starts at the low end of the data points if @maximum_value.nil? && @minimum_value.nil? @maximum_value = @minimum_value = data_point end # TODO Doesn't work with stacked bar graphs # Original: @maximum_value = larger_than_max?(data_point, index) ? max(data_point, index) : @maximum_value @maximum_value = larger_than_max?(data_point) ? data_point : @maximum_value @has_data = true if @maximum_value >= 0 @minimum_value = less_than_min?(data_point) ? data_point : @minimum_value @has_data = true if @minimum_value < 0 end end |
#initialize_ivars ⇒ Object
Set instance variables for this object.
Subclasses can override this, call super, then set values separately.
This makes it possible to set defaults in a subclass but still allow developers to change this values in their program.
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 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 |
# File 'lib/gruff/base.rb', line 202 def initialize_ivars # Internal for calculations @raw_columns = 800.0 @raw_rows = 800.0 * (@rows/@columns) @column_count = 0 @marker_count = nil @maximum_value = @minimum_value = nil @has_data = false @data = Array.new @labels = Hash.new @labels_seen = Hash.new @sort = true @title = nil @scale = @columns / @raw_columns vera_font_path = File.('Vera.ttf', ENV['MAGICK_FONT_PATH']) @font = File.exists?(vera_font_path) ? vera_font_path : nil @marker_font_size = 21.0 @legend_font_size = 20.0 @title_font_size = 36.0 @top_margin = @bottom_margin = @left_margin = @right_margin = DEFAULT_MARGIN @legend_margin = LEGEND_MARGIN @title_margin = TITLE_MARGIN @legend_box_size = 20.0 @no_data_message = "No Data" @hide_line_markers = @hide_legend = @hide_title = @hide_line_numbers = false @center_labels_over_point = true @has_left_labels = false @additional_line_values = [] @additional_line_colors = [] @theme_options = {} @x_axis_label = @y_axis_label = nil @y_axis_increment = nil @stacked = nil @norm_data = nil end |
#margins=(margin) ⇒ Object
Sets the top, bottom, left and right margins to margin
.
248 249 250 |
# File 'lib/gruff/base.rb', line 248 def margins=(margin) @top_margin = @left_margin = @right_margin = @bottom_margin = margin end |
#replace_colors(color_list = []) ⇒ Object
Replace the entire color list with a new array of colors. Also aliased as the colors= setter method.
If you specify fewer colors than the number of datasets you intend to draw, ‘increment_color’ will cycle through the array, reusing colors as needed.
Note that (as with the ‘theme’ method), you should set up your color list before you send your data (via the ‘data’ method). Calls to the ‘data’ method made prior to this call will use whatever color scheme was in place at the time data was called.
Example:
replace_colors ['#cc99cc', '#d9e043', '#34d8a2']
280 281 282 283 |
# File 'lib/gruff/base.rb', line 280 def replace_colors(color_list=[]) @colors = color_list @color_index = 0 end |
#theme=(options) ⇒ Object
You can set a theme manually. Assign a hash to this method before you send your data.
graph.theme = {
:colors => %w(orange purple green white red),
:marker_color => 'blue',
:background_colors => %w(black grey)
}
:background_image => ‘squirrel.png’ is also possible.
(Or hopefully something better looking than that.)
298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 |
# File 'lib/gruff/base.rb', line 298 def theme=() reset_themes() defaults = { :colors => ['black', 'white'], :additional_line_colors => [], :marker_color => 'white', :font_color => 'black', :background_colors => nil, :background_image => nil } @theme_options = defaults.merge @colors = @theme_options[:colors] @marker_color = @theme_options[:marker_color] @font_color = @theme_options[:font_color] || @marker_color @additional_line_colors = @theme_options[:additional_line_colors] render_background end |
#theme_37signals ⇒ Object
A color scheme plucked from the colors on the popular usability blog.
340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 |
# File 'lib/gruff/base.rb', line 340 def theme_37signals # Colors @green = '#339933' @purple = '#cc99cc' @blue = '#336699' @yellow = '#FFF804' @red = '#ff0000' @orange = '#cf5910' @black = 'black' @colors = [@yellow, @blue, @green, @red, @purple, @orange, @black] self.theme = { :colors => @colors, :marker_color => 'black', :font_color => 'black', :background_colors => ['#d1edf5', 'white'] } end |
#theme_greyscale ⇒ Object
A greyscale theme
422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 |
# File 'lib/gruff/base.rb', line 422 def theme_greyscale # Colors @colors = [ '#282828', # '#383838', # '#686868', # '#989898', # '#c8c8c8', # '#e8e8e8', # ] self.theme = { :colors => @colors, :marker_color => '#aea9a9', # Grey :font_color => 'black', :background_colors => 'white' } end |
#theme_keynote ⇒ Object
A color scheme similar to the popular presentation software.
320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 |
# File 'lib/gruff/base.rb', line 320 def theme_keynote # Colors @blue = '#6886B4' @yellow = '#FDD84E' @green = '#72AE6E' @red = '#D1695E' @purple = '#8A6EAF' @orange = '#EFAA43' @white = 'white' @colors = [@yellow, @blue, @green, @red, @purple, @orange, @white] self.theme = { :colors => @colors, :marker_color => 'white', :font_color => 'white', :background_colors => ['black', '#4a465a'] } end |
#theme_odeo ⇒ Object
A color scheme similar to that used on the popular podcast site.
381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 |
# File 'lib/gruff/base.rb', line 381 def theme_odeo # Colors @grey = '#202020' @white = 'white' @dark_pink = '#a21764' @green = '#8ab438' @light_grey = '#999999' @dark_blue = '#3a5b87' @black = 'black' @colors = [@grey, @white, @dark_blue, @dark_pink, @green, @light_grey, @black] self.theme = { :colors => @colors, :marker_color => 'white', :font_color => 'white', :background_colors => ['#ff47a4', '#ff1f81'] } end |
#theme_pastel ⇒ Object
A pastel theme
401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 |
# File 'lib/gruff/base.rb', line 401 def theme_pastel # Colors @colors = [ '#a9dada', # blue '#aedaa9', # green '#daaea9', # peach '#dadaa9', # yellow '#a9a9da', # dk purple '#daaeda', # purple '#dadada' # grey ] self.theme = { :colors => @colors, :marker_color => '#aea9a9', # Grey :font_color => 'black', :background_colors => 'white' } end |
#theme_rails_keynote ⇒ Object
A color scheme from the colors used on the 2005 Rails keynote presentation at RubyConf.
361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 |
# File 'lib/gruff/base.rb', line 361 def theme_rails_keynote # Colors @green = '#00ff00' @grey = '#333333' @orange = '#ff5d00' @red = '#f61100' @white = 'white' @light_grey = '#999999' @black = 'black' @colors = [@green, @grey, @orange, @red, @white, @light_grey, @black] self.theme = { :colors => @colors, :marker_color => 'white', :font_color => 'white', :background_colors => ['#0083a3', '#0083a3'] } end |
#to_blob(fileformat = 'PNG') ⇒ Object
Return the graph as a rendered binary blob.
490 491 492 493 494 495 |
# File 'lib/gruff/base.rb', line 490 def to_blob(fileformat='PNG') draw() return @base_image.to_blob do self.format = fileformat end end |
#write(filename = "graph.png") ⇒ Object
Writes the graph to a file. Defaults to ‘graph.png’
Example:
write('graphs/my_pretty_graph.png')
484 485 486 487 |
# File 'lib/gruff/base.rb', line 484 def write(filename="graph.png") draw() @base_image.write(filename) end |