Class: Gruff::Base
- Inherits:
-
Object
- Object
- Gruff::Base
- Defined in:
- lib/gruff/base.rb
Overview
A common base class inherited from class of drawing a graph.
Direct Known Subclasses
Area, Bar, Bezier, Bullet, Dot, Line, Net, Pie, Scatter, Scene, SideBar, Spider, StackedArea, StackedBar
Constant Summary collapse
- LEGEND_MARGIN =
Space around text elements. Mostly used for vertical spacing.
TITLE_MARGIN = 20.0
- LABEL_MARGIN =
15.0
- DEFAULT_MARGIN =
20.0
- DEFAULT_TARGET_WIDTH =
800.0
Instance Attribute Summary collapse
-
#bottom_margin ⇒ Object
writeonly
Blank space below the graph.
-
#center_labels_over_point ⇒ Object
writeonly
Used internally for spacing.
-
#colors ⇒ Object
Get or set the list of colors that will be used to draw the bars or lines.
-
#has_left_labels ⇒ Object
writeonly
Used internally for horizontal graph types.
-
#hide_legend ⇒ Object
writeonly
Prevent drawing of the legend.
-
#hide_line_markers ⇒ Object
writeonly
Prevent drawing of line markers.
-
#hide_line_numbers ⇒ Object
writeonly
Prevent drawing of line numbers.
-
#hide_title ⇒ Object
writeonly
Prevent drawing of the title.
-
#label_max_size ⇒ Object
writeonly
Truncates labels if longer than max specified.
-
#label_stagger_height ⇒ Object
writeonly
Height of staggering between labels (Bar graph only).
-
#label_truncation_style ⇒ Object
writeonly
How truncated labels visually appear if they exceed #label_max_size=.
-
#labels ⇒ Object
writeonly
A hash of names for the individual columns, where the key is the array index for the column this label represents.
-
#left_margin ⇒ Object
writeonly
Blank space to the left of the graph.
-
#legend_at_bottom ⇒ Object
writeonly
Display the legend under the graph.
-
#legend_box_size ⇒ Object
writeonly
Optionally set the size of the colored box by each item in the legend.
-
#legend_margin ⇒ Object
writeonly
Blank space below the legend.
-
#marker_color ⇒ Object
writeonly
Set the color of the auxiliary lines.
-
#marker_count ⇒ Object
writeonly
Set the number of horizontal lines shown for reference.
-
#marker_shadow_color ⇒ Object
writeonly
Set the shadow color of the auxiliary lines.
-
#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
writeonly
Set a message shown when there is no data.
-
#right_margin ⇒ Object
writeonly
Blank space to the right of the graph.
-
#sort ⇒ Object
writeonly
Set to
true
if you want the data sets sorted with largest avg values drawn first. -
#sorted_drawing ⇒ Object
writeonly
Set to
true
if you want the data sets drawn with largest avg values drawn first. -
#title ⇒ Object
writeonly
Set the large title of the graph displayed at the top.
-
#title_margin ⇒ Object
writeonly
Blank space below the title.
-
#top_margin ⇒ Object
writeonly
Blank space above the graph.
-
#x_axis_increment ⇒ Object
writeonly
Set increment of the vertical marking lines.
-
#x_axis_label ⇒ Object
writeonly
Set a label for the bottom of the graph.
-
#x_axis_label_format ⇒ Object
writeonly
Allow passing lambdas to format labels for x axis.
-
#y_axis_increment ⇒ Object
writeonly
Set increment of the horizontal marking lines.
-
#y_axis_label ⇒ Object
writeonly
Set a label for the left side of the graph.
-
#y_axis_label_format ⇒ Object
writeonly
Allow passing lambdas to format labels for y axis.
Instance Method Summary collapse
-
#add_color(colorname) ⇒ Object
Add a color to the list of available colors for lines.
-
#bold_title=(value) ⇒ Object
Specifies whether to draw the title bolded or not.
-
#data(name, data_points = [], color = nil) ⇒ Object
Input the data in the graph.
-
#draw ⇒ Object
Draw a graph.
-
#font=(font_path) ⇒ Object
Sets the font for graph text to the font at
font_path
. -
#font_color=(value) ⇒ Object
Specifies the text color.
-
#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.). -
#legend_font_size=(value) ⇒ Object
Optionally set the size of the font.
-
#margins=(margin) ⇒ Object
Sets the top, bottom, left and right margins to
margin
. -
#marker_font_size=(value) ⇒ Object
The font size of the labels around the graph.
-
#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
Apply 37signals theme.
-
#theme_greyscale ⇒ Object
Apply greyscale theme.
-
#theme_keynote ⇒ Object
Apply Apple’s keynote theme.
-
#theme_odeo ⇒ Object
Apply Odeo theme.
-
#theme_pastel ⇒ Object
Apply pastel theme.
-
#theme_rails_keynote ⇒ Object
Apply Rails theme.
-
#title_font=(font_path) ⇒ Object
Same as #font= but for the title.
-
#title_font_size=(value) ⇒ Object
Set the font size of the large title at the top of the graph.
-
#to_blob(image_format = 'PNG') ⇒ Object
deprecated
Deprecated.
Please use
to_image.to_blob
instead. -
#to_image ⇒ Magick::Image
Return a rendered graph image.
-
#write(file_name = 'graph.png') ⇒ Object
Writes the graph to a file.
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’).
152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 |
# File 'lib/gruff/base.rb', line 152 def initialize(target_width = DEFAULT_TARGET_WIDTH) if target_width.is_a?(String) @columns, @rows = target_width.split('x').map(&:to_f) else @columns = target_width.to_f @rows = target_width.to_f * 0.75 end @columns.freeze @rows.freeze initialize_graph_scale initialize_attributes initialize_store self.theme = Themes::KEYNOTE end |
Instance Attribute Details
#bottom_margin=(value) ⇒ Object (writeonly)
Blank space below the graph. Default is 20
.
34 35 36 |
# File 'lib/gruff/base.rb', line 34 def bottom_margin=(value) @bottom_margin = value end |
#center_labels_over_point=(value) ⇒ Object (writeonly)
Used internally for spacing.
By default, labels are centered over the point they represent.
60 61 62 |
# File 'lib/gruff/base.rb', line 60 def center_labels_over_point=(value) @center_labels_over_point = value 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 |
#has_left_labels=(value) ⇒ Object (writeonly)
Used internally for horizontal graph types. Default is false
.
63 64 65 |
# File 'lib/gruff/base.rb', line 63 def has_left_labels=(value) @has_left_labels = value end |
#hide_legend=(value) ⇒ Object (writeonly)
Prevent drawing of the legend. Default is false
.
100 101 102 |
# File 'lib/gruff/base.rb', line 100 def hide_legend=(value) @hide_legend = value end |
#hide_line_markers=(value) ⇒ Object (writeonly)
Prevent drawing of line markers. Default is false
.
97 98 99 |
# File 'lib/gruff/base.rb', line 97 def hide_line_markers=(value) @hide_line_markers = value end |
#hide_line_numbers=(value) ⇒ Object (writeonly)
Prevent drawing of line numbers. Default is false
.
106 107 108 |
# File 'lib/gruff/base.rb', line 106 def hide_line_numbers=(value) @hide_line_numbers = value end |
#hide_title=(value) ⇒ Object (writeonly)
Prevent drawing of the title. Default is false
.
103 104 105 |
# File 'lib/gruff/base.rb', line 103 def hide_title=(value) @hide_title = value end |
#label_max_size=(value) ⇒ Object (writeonly)
Truncates labels if longer than max specified.
81 82 83 |
# File 'lib/gruff/base.rb', line 81 def label_max_size=(value) @label_max_size = value end |
#label_stagger_height=(value) ⇒ Object (writeonly)
Height of staggering between labels (Bar graph only).
78 79 80 |
# File 'lib/gruff/base.rb', line 78 def label_stagger_height=(value) @label_stagger_height = value end |
#label_truncation_style=(value) ⇒ Object (writeonly)
How truncated labels visually appear if they exceed #label_max_size=.
-
:absolute
- does not show trailing dots to indicate truncation. This is the default. -
:trailing_dots
- shows trailing dots to indicate truncation (note that #label_max_size= must be greater than 3).
88 89 90 |
# File 'lib/gruff/base.rb', line 88 def label_truncation_style=(value) @label_truncation_style = value end |
#labels=(value) ⇒ Object (writeonly)
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.
55 56 57 |
# File 'lib/gruff/base.rb', line 55 def labels=(value) @labels = value end |
#left_margin=(value) ⇒ Object (writeonly)
Blank space to the left of the graph. Default is 20
.
40 41 42 |
# File 'lib/gruff/base.rb', line 40 def left_margin=(value) @left_margin = value end |
#legend_at_bottom=(value) ⇒ Object (writeonly)
Display the legend under the graph. Default is false
.
113 114 115 |
# File 'lib/gruff/base.rb', line 113 def legend_at_bottom=(value) @legend_at_bottom = value end |
#legend_box_size=(value) ⇒ Object (writeonly)
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.
136 137 138 |
# File 'lib/gruff/base.rb', line 136 def legend_box_size=(value) @legend_box_size = value end |
#legend_margin=(value) ⇒ Object (writeonly)
Blank space below the legend. Default is 20
.
46 47 48 |
# File 'lib/gruff/base.rb', line 46 def legend_margin=(value) @legend_margin = value end |
#marker_color=(value) ⇒ Object (writeonly)
Set the color of the auxiliary lines.
116 117 118 |
# File 'lib/gruff/base.rb', line 116 def marker_color=(value) @marker_color = value end |
#marker_count=(value) ⇒ Object
Set the number of horizontal lines shown for reference.
122 123 124 |
# File 'lib/gruff/base.rb', line 122 def marker_count=(value) @marker_count = value end |
#marker_shadow_color=(value) ⇒ Object (writeonly)
Set the shadow color of the auxiliary lines.
119 120 121 |
# File 'lib/gruff/base.rb', line 119 def marker_shadow_color=(value) @marker_shadow_color = value 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.
441 442 443 |
# File 'lib/gruff/base.rb', line 441 def maximum_value @maximum_value || store.max 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.
431 432 433 |
# File 'lib/gruff/base.rb', line 431 def minimum_value @minimum_value || store.min end |
#no_data_message=(value) ⇒ Object (writeonly)
Set a message shown when there is no data. Fits up to 20 characters. Defaults to “No Data.”.
110 111 112 |
# File 'lib/gruff/base.rb', line 110 def (value) @no_data_message = value end |
#right_margin=(value) ⇒ Object (writeonly)
Blank space to the right of the graph. Default is 20
.
37 38 39 |
# File 'lib/gruff/base.rb', line 37 def right_margin=(value) @right_margin = value end |
#sort=(value) ⇒ Object (writeonly)
Set to true
if you want the data sets sorted with largest avg values drawn first. Default is false
.
126 127 128 |
# File 'lib/gruff/base.rb', line 126 def sort=(value) @sort = value end |
#sorted_drawing=(value) ⇒ Object (writeonly)
Set to true
if you want the data sets drawn with largest avg values drawn first. This does not affect the legend. Default is false
.
130 131 132 |
# File 'lib/gruff/base.rb', line 130 def sorted_drawing=(value) @sorted_drawing = value end |
#title=(value) ⇒ Object (writeonly)
Set the large title of the graph displayed at the top.
94 95 96 |
# File 'lib/gruff/base.rb', line 94 def title=(value) @title = value end |
#title_margin=(value) ⇒ Object (writeonly)
Blank space below the title. Default is 20
.
43 44 45 |
# File 'lib/gruff/base.rb', line 43 def title_margin=(value) @title_margin = value end |
#top_margin=(value) ⇒ Object (writeonly)
Blank space above the graph. Default is 20
.
31 32 33 |
# File 'lib/gruff/base.rb', line 31 def top_margin=(value) @top_margin = value end |
#x_axis_increment=(value) ⇒ Object (writeonly)
Set increment of the vertical marking lines.
72 73 74 |
# File 'lib/gruff/base.rb', line 72 def x_axis_increment=(value) @x_axis_increment = value end |
#x_axis_label=(value) ⇒ Object
Set a label for the bottom of the graph.
66 67 68 |
# File 'lib/gruff/base.rb', line 66 def x_axis_label=(value) @x_axis_label = value end |
#x_axis_label_format=(value) ⇒ Object (writeonly)
Allow passing lambdas to format labels for x axis.
139 140 141 |
# File 'lib/gruff/base.rb', line 139 def x_axis_label_format=(value) @x_axis_label_format = value end |
#y_axis_increment=(value) ⇒ Object (writeonly)
Set increment of the horizontal marking lines.
75 76 77 |
# File 'lib/gruff/base.rb', line 75 def y_axis_increment=(value) @y_axis_increment = value end |
#y_axis_label=(value) ⇒ Object
Set a label for the left side of the graph.
69 70 71 |
# File 'lib/gruff/base.rb', line 69 def y_axis_label=(value) @y_axis_label = value end |
#y_axis_label_format=(value) ⇒ Object (writeonly)
Allow passing lambdas to format labels for y axis.
142 143 144 |
# File 'lib/gruff/base.rb', line 142 def y_axis_label_format=(value) @y_axis_label_format = value end |
Instance Method Details
#add_color(colorname) ⇒ Object
Add a color to the list of available colors for lines.
304 305 306 |
# File 'lib/gruff/base.rb', line 304 def add_color(colorname) @colors << colorname end |
#bold_title=(value) ⇒ Object
Specifies whether to draw the title bolded or not. Default is true
.
284 285 286 |
# File 'lib/gruff/base.rb', line 284 def bold_title=(value) @title_font.bold = value end |
#data(name, data_points = [], color = nil) ⇒ Object
If you want to use a preset theme, you must set it before calling #data.
Input the data in the graph.
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.
423 424 425 |
# File 'lib/gruff/base.rb', line 423 def data(name, data_points = [], color = nil) store.add(name, data_points, color) end |
#draw ⇒ Object
Draw a graph.
490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 |
# File 'lib/gruff/base.rb', line 490 def draw setup_data # Maybe should be done in one of the following functions for more granularity. unless data_given? draw_no_data return end setup_drawing draw_legend draw_line_markers draw_axis_labels draw_title draw_graph end |
#font=(font_path) ⇒ Object
Sets the font for graph text to the font at font_path
.
239 240 241 242 243 |
# File 'lib/gruff/base.rb', line 239 def font=(font_path) @title_font.path = font_path unless @title_font.path @marker_font.path = font_path @legend_font.path = font_path end |
#font_color=(value) ⇒ Object
Specifies the text color.
292 293 294 295 296 |
# File 'lib/gruff/base.rb', line 292 def font_color=(value) @title_font.color = value @marker_font.color = value @legend_font.color = value end |
#legend_font_size=(value) ⇒ Object
Optionally set the size of the font. Based on an 800x600px graph. Default is 20
.
Will be scaled down if the graph is smaller than 800px wide.
276 277 278 |
# File 'lib/gruff/base.rb', line 276 def legend_font_size=(value) @legend_font.size = value end |
#margins=(margin) ⇒ Object
Sets the top, bottom, left and right margins to margin
.
231 232 233 |
# File 'lib/gruff/base.rb', line 231 def margins=(margin) @top_margin = @left_margin = @right_margin = @bottom_margin = margin end |
#marker_font_size=(value) ⇒ Object
The font size of the labels around the graph. Default is 21
.
265 266 267 |
# File 'lib/gruff/base.rb', line 265 def marker_font_size=(value) @marker_font.size = value 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, it 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.
323 324 325 |
# File 'lib/gruff/base.rb', line 323 def replace_colors(color_list = []) @colors = color_list 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: ['black', 'grey'],
background_direction: :top_bottom
}
background_image: ‘squirrel.png’ is also possible.
background_direction
accepts one of following parameters.
-
:top_bottom
-
:bottom_top
-
:left_right
-
:right_left
-
:topleft_bottomright
-
:topright_bottomleft
(Or hopefully something better looking than that.)
351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 |
# File 'lib/gruff/base.rb', line 351 def theme=() reset_themes defaults = { colors: %w[black white], marker_color: 'white', marker_shadow_color: nil, font_color: 'black', background_colors: nil, background_image: nil } @theme_options = defaults.merge self.marker_color = @theme_options[:marker_color] self.font_color = @theme_options[:font_color] || @marker_color @colors = @theme_options[:colors] @marker_shadow_color = @theme_options[:marker_shadow_color] @renderer = Gruff::Renderer.new(@columns, @rows, @scale, @theme_options) end |
#theme_37signals ⇒ Object
Apply 37signals theme.
379 380 381 |
# File 'lib/gruff/base.rb', line 379 def theme_37signals self.theme = Themes::THIRTYSEVEN_SIGNALS end |
#theme_greyscale ⇒ Object
Apply greyscale theme.
399 400 401 |
# File 'lib/gruff/base.rb', line 399 def theme_greyscale self.theme = Themes::GREYSCALE end |
#theme_keynote ⇒ Object
Apply Apple’s keynote theme.
374 375 376 |
# File 'lib/gruff/base.rb', line 374 def theme_keynote self.theme = Themes::KEYNOTE end |
#theme_odeo ⇒ Object
Apply Odeo theme.
389 390 391 |
# File 'lib/gruff/base.rb', line 389 def theme_odeo self.theme = Themes::ODEO end |
#theme_pastel ⇒ Object
Apply pastel theme.
394 395 396 |
# File 'lib/gruff/base.rb', line 394 def theme_pastel self.theme = Themes::PASTEL end |
#theme_rails_keynote ⇒ Object
Apply Rails theme.
384 385 386 |
# File 'lib/gruff/base.rb', line 384 def theme_rails_keynote self.theme = Themes::RAILS_KEYNOTE end |
#title_font=(font_path) ⇒ Object
Same as #font= but for the title.
249 250 251 |
# File 'lib/gruff/base.rb', line 249 def title_font=(font_path) @title_font.path = font_path end |
#title_font_size=(value) ⇒ Object
Set the font size of the large title at the top of the graph. Default is 36
.
257 258 259 |
# File 'lib/gruff/base.rb', line 257 def title_font_size=(value) @title_font.size = value end |
#to_blob(image_format = 'PNG') ⇒ Object
Please use to_image.to_blob
instead.
Return the graph as a rendered binary blob.
482 483 484 485 486 487 |
# File 'lib/gruff/base.rb', line 482 def to_blob(image_format = 'PNG') warn '#to_blob is deprecated. Please use `to_image.to_blob` instead' to_image.to_blob do self.format = image_format end end |
#to_image ⇒ Magick::Image
Return a rendered graph image. This can use RMagick’s methods to adjust the image before saving.
469 470 471 472 473 474 475 |
# File 'lib/gruff/base.rb', line 469 def to_image @to_image ||= begin draw renderer.finish renderer.image end end |
#write(file_name = 'graph.png') ⇒ Object
Writes the graph to a file. Defaults to ‘graph.png’
452 453 454 |
# File 'lib/gruff/base.rb', line 452 def write(file_name = 'graph.png') to_image.write(file_name) end |