annotate .svn/pristine/08/08ad4f57c782749abd613605456ebd0acf953d61.svn-base @ 1295:622f24f53b42 redmine-2.3

Update to Redmine SVN revision 11972 on 2.3-stable branch
author Chris Cannam
date Fri, 14 Jun 2013 09:02:21 +0100
parents
children
rev   line source
Chris@1295 1 begin
Chris@1295 2 require 'zlib'
Chris@1295 3 @@__have_zlib = true
Chris@1295 4 rescue
Chris@1295 5 @@__have_zlib = false
Chris@1295 6 end
Chris@1295 7
Chris@1295 8 require 'rexml/document'
Chris@1295 9
Chris@1295 10 module SVG
Chris@1295 11 module Graph
Chris@1295 12 VERSION = '@ANT_VERSION@'
Chris@1295 13
Chris@1295 14 # === Base object for generating SVG Graphs
Chris@1295 15 #
Chris@1295 16 # == Synopsis
Chris@1295 17 #
Chris@1295 18 # This class is only used as a superclass of specialized charts. Do not
Chris@1295 19 # attempt to use this class directly, unless creating a new chart type.
Chris@1295 20 #
Chris@1295 21 # For examples of how to subclass this class, see the existing specific
Chris@1295 22 # subclasses, such as SVG::Graph::Pie.
Chris@1295 23 #
Chris@1295 24 # == Examples
Chris@1295 25 #
Chris@1295 26 # For examples of how to use this package, see either the test files, or
Chris@1295 27 # the documentation for the specific class you want to use.
Chris@1295 28 #
Chris@1295 29 # * file:test/plot.rb
Chris@1295 30 # * file:test/single.rb
Chris@1295 31 # * file:test/test.rb
Chris@1295 32 # * file:test/timeseries.rb
Chris@1295 33 #
Chris@1295 34 # == Description
Chris@1295 35 #
Chris@1295 36 # This package should be used as a base for creating SVG graphs.
Chris@1295 37 #
Chris@1295 38 # == Acknowledgements
Chris@1295 39 #
Chris@1295 40 # Leo Lapworth for creating the SVG::TT::Graph package which this Ruby
Chris@1295 41 # port is based on.
Chris@1295 42 #
Chris@1295 43 # Stephen Morgan for creating the TT template and SVG.
Chris@1295 44 #
Chris@1295 45 # == See
Chris@1295 46 #
Chris@1295 47 # * SVG::Graph::BarHorizontal
Chris@1295 48 # * SVG::Graph::Bar
Chris@1295 49 # * SVG::Graph::Line
Chris@1295 50 # * SVG::Graph::Pie
Chris@1295 51 # * SVG::Graph::Plot
Chris@1295 52 # * SVG::Graph::TimeSeries
Chris@1295 53 #
Chris@1295 54 # == Author
Chris@1295 55 #
Chris@1295 56 # Sean E. Russell <serATgermaneHYPHENsoftwareDOTcom>
Chris@1295 57 #
Chris@1295 58 # Copyright 2004 Sean E. Russell
Chris@1295 59 # This software is available under the Ruby license[LICENSE.txt]
Chris@1295 60 #
Chris@1295 61 class Graph
Chris@1295 62 include REXML
Chris@1295 63
Chris@1295 64 # Initialize the graph object with the graph settings. You won't
Chris@1295 65 # instantiate this class directly; see the subclass for options.
Chris@1295 66 # [width] 500
Chris@1295 67 # [height] 300
Chris@1295 68 # [show_x_guidelines] false
Chris@1295 69 # [show_y_guidelines] true
Chris@1295 70 # [show_data_values] true
Chris@1295 71 # [min_scale_value] 0
Chris@1295 72 # [show_x_labels] true
Chris@1295 73 # [stagger_x_labels] false
Chris@1295 74 # [rotate_x_labels] false
Chris@1295 75 # [step_x_labels] 1
Chris@1295 76 # [step_include_first_x_label] true
Chris@1295 77 # [show_y_labels] true
Chris@1295 78 # [rotate_y_labels] false
Chris@1295 79 # [scale_integers] false
Chris@1295 80 # [show_x_title] false
Chris@1295 81 # [x_title] 'X Field names'
Chris@1295 82 # [show_y_title] false
Chris@1295 83 # [y_title_text_direction] :bt
Chris@1295 84 # [y_title] 'Y Scale'
Chris@1295 85 # [show_graph_title] false
Chris@1295 86 # [graph_title] 'Graph Title'
Chris@1295 87 # [show_graph_subtitle] false
Chris@1295 88 # [graph_subtitle] 'Graph Sub Title'
Chris@1295 89 # [key] true,
Chris@1295 90 # [key_position] :right, # bottom or righ
Chris@1295 91 # [font_size] 12
Chris@1295 92 # [title_font_size] 16
Chris@1295 93 # [subtitle_font_size] 14
Chris@1295 94 # [x_label_font_size] 12
Chris@1295 95 # [x_title_font_size] 14
Chris@1295 96 # [y_label_font_size] 12
Chris@1295 97 # [y_title_font_size] 14
Chris@1295 98 # [key_font_size] 10
Chris@1295 99 # [no_css] false
Chris@1295 100 # [add_popups] false
Chris@1295 101 def initialize( config )
Chris@1295 102 @config = config
Chris@1295 103
Chris@1295 104 self.top_align = self.top_font = self.right_align = self.right_font = 0
Chris@1295 105
Chris@1295 106 init_with({
Chris@1295 107 :width => 500,
Chris@1295 108 :height => 300,
Chris@1295 109 :show_x_guidelines => false,
Chris@1295 110 :show_y_guidelines => true,
Chris@1295 111 :show_data_values => true,
Chris@1295 112
Chris@1295 113 # :min_scale_value => 0,
Chris@1295 114
Chris@1295 115 :show_x_labels => true,
Chris@1295 116 :stagger_x_labels => false,
Chris@1295 117 :rotate_x_labels => false,
Chris@1295 118 :step_x_labels => 1,
Chris@1295 119 :step_include_first_x_label => true,
Chris@1295 120
Chris@1295 121 :show_y_labels => true,
Chris@1295 122 :rotate_y_labels => false,
Chris@1295 123 :stagger_y_labels => false,
Chris@1295 124 :scale_integers => false,
Chris@1295 125
Chris@1295 126 :show_x_title => false,
Chris@1295 127 :x_title => 'X Field names',
Chris@1295 128
Chris@1295 129 :show_y_title => false,
Chris@1295 130 :y_title_text_direction => :bt,
Chris@1295 131 :y_title => 'Y Scale',
Chris@1295 132
Chris@1295 133 :show_graph_title => false,
Chris@1295 134 :graph_title => 'Graph Title',
Chris@1295 135 :show_graph_subtitle => false,
Chris@1295 136 :graph_subtitle => 'Graph Sub Title',
Chris@1295 137 :key => true,
Chris@1295 138 :key_position => :right, # bottom or right
Chris@1295 139
Chris@1295 140 :font_size =>12,
Chris@1295 141 :title_font_size =>16,
Chris@1295 142 :subtitle_font_size =>14,
Chris@1295 143 :x_label_font_size =>12,
Chris@1295 144 :x_title_font_size =>14,
Chris@1295 145 :y_label_font_size =>12,
Chris@1295 146 :y_title_font_size =>14,
Chris@1295 147 :key_font_size =>10,
Chris@1295 148
Chris@1295 149 :no_css =>false,
Chris@1295 150 :add_popups =>false,
Chris@1295 151 })
Chris@1295 152
Chris@1295 153 set_defaults if respond_to? :set_defaults
Chris@1295 154
Chris@1295 155 init_with config
Chris@1295 156 end
Chris@1295 157
Chris@1295 158
Chris@1295 159 # This method allows you do add data to the graph object.
Chris@1295 160 # It can be called several times to add more data sets in.
Chris@1295 161 #
Chris@1295 162 # data_sales_02 = [12, 45, 21];
Chris@1295 163 #
Chris@1295 164 # graph.add_data({
Chris@1295 165 # :data => data_sales_02,
Chris@1295 166 # :title => 'Sales 2002'
Chris@1295 167 # })
Chris@1295 168 def add_data conf
Chris@1295 169 @data = [] unless defined? @data
Chris@1295 170
Chris@1295 171 if conf[:data] and conf[:data].kind_of? Array
Chris@1295 172 @data << conf
Chris@1295 173 else
Chris@1295 174 raise "No data provided by #{conf.inspect}"
Chris@1295 175 end
Chris@1295 176 end
Chris@1295 177
Chris@1295 178
Chris@1295 179 # This method removes all data from the object so that you can
Chris@1295 180 # reuse it to create a new graph but with the same config options.
Chris@1295 181 #
Chris@1295 182 # graph.clear_data
Chris@1295 183 def clear_data
Chris@1295 184 @data = []
Chris@1295 185 end
Chris@1295 186
Chris@1295 187
Chris@1295 188 # This method processes the template with the data and
Chris@1295 189 # config which has been set and returns the resulting SVG.
Chris@1295 190 #
Chris@1295 191 # This method will croak unless at least one data set has
Chris@1295 192 # been added to the graph object.
Chris@1295 193 #
Chris@1295 194 # print graph.burn
Chris@1295 195 def burn
Chris@1295 196 raise "No data available" unless @data.size > 0
Chris@1295 197
Chris@1295 198 calculations if respond_to? :calculations
Chris@1295 199
Chris@1295 200 start_svg
Chris@1295 201 calculate_graph_dimensions
Chris@1295 202 @foreground = Element.new( "g" )
Chris@1295 203 draw_graph
Chris@1295 204 draw_titles
Chris@1295 205 draw_legend
Chris@1295 206 draw_data
Chris@1295 207 @graph.add_element( @foreground )
Chris@1295 208 style
Chris@1295 209
Chris@1295 210 data = ""
Chris@1295 211 @doc.write( data, 0 )
Chris@1295 212
Chris@1295 213 if @config[:compress]
Chris@1295 214 if @@__have_zlib
Chris@1295 215 inp, out = IO.pipe
Chris@1295 216 gz = Zlib::GzipWriter.new( out )
Chris@1295 217 gz.write data
Chris@1295 218 gz.close
Chris@1295 219 data = inp.read
Chris@1295 220 else
Chris@1295 221 data << "<!-- Ruby Zlib not available for SVGZ -->";
Chris@1295 222 end
Chris@1295 223 end
Chris@1295 224
Chris@1295 225 return data
Chris@1295 226 end
Chris@1295 227
Chris@1295 228
Chris@1295 229 # Set the height of the graph box, this is the total height
Chris@1295 230 # of the SVG box created - not the graph it self which auto
Chris@1295 231 # scales to fix the space.
Chris@1295 232 attr_accessor :height
Chris@1295 233 # Set the width of the graph box, this is the total width
Chris@1295 234 # of the SVG box created - not the graph it self which auto
Chris@1295 235 # scales to fix the space.
Chris@1295 236 attr_accessor :width
Chris@1295 237 # Set the path to an external stylesheet, set to '' if
Chris@1295 238 # you want to revert back to using the defaut internal version.
Chris@1295 239 #
Chris@1295 240 # To create an external stylesheet create a graph using the
Chris@1295 241 # default internal version and copy the stylesheet section to
Chris@1295 242 # an external file and edit from there.
Chris@1295 243 attr_accessor :style_sheet
Chris@1295 244 # (Bool) Show the value of each element of data on the graph
Chris@1295 245 attr_accessor :show_data_values
Chris@1295 246 # The point at which the Y axis starts, defaults to '0',
Chris@1295 247 # if set to nil it will default to the minimum data value.
Chris@1295 248 attr_accessor :min_scale_value
Chris@1295 249 # Whether to show labels on the X axis or not, defaults
Chris@1295 250 # to true, set to false if you want to turn them off.
Chris@1295 251 attr_accessor :show_x_labels
Chris@1295 252 # This puts the X labels at alternative levels so if they
Chris@1295 253 # are long field names they will not overlap so easily.
Chris@1295 254 # Default it false, to turn on set to true.
Chris@1295 255 attr_accessor :stagger_x_labels
Chris@1295 256 # This puts the Y labels at alternative levels so if they
Chris@1295 257 # are long field names they will not overlap so easily.
Chris@1295 258 # Default it false, to turn on set to true.
Chris@1295 259 attr_accessor :stagger_y_labels
Chris@1295 260 # This turns the X axis labels by 90 degrees.
Chris@1295 261 # Default it false, to turn on set to true.
Chris@1295 262 attr_accessor :rotate_x_labels
Chris@1295 263 # This turns the Y axis labels by 90 degrees.
Chris@1295 264 # Default it false, to turn on set to true.
Chris@1295 265 attr_accessor :rotate_y_labels
Chris@1295 266 # How many "steps" to use between displayed X axis labels,
Chris@1295 267 # a step of one means display every label, a step of two results
Chris@1295 268 # in every other label being displayed (label <gap> label <gap> label),
Chris@1295 269 # a step of three results in every third label being displayed
Chris@1295 270 # (label <gap> <gap> label <gap> <gap> label) and so on.
Chris@1295 271 attr_accessor :step_x_labels
Chris@1295 272 # Whether to (when taking "steps" between X axis labels) step from
Chris@1295 273 # the first label (i.e. always include the first label) or step from
Chris@1295 274 # the X axis origin (i.e. start with a gap if step_x_labels is greater
Chris@1295 275 # than one).
Chris@1295 276 attr_accessor :step_include_first_x_label
Chris@1295 277 # Whether to show labels on the Y axis or not, defaults
Chris@1295 278 # to true, set to false if you want to turn them off.
Chris@1295 279 attr_accessor :show_y_labels
Chris@1295 280 # Ensures only whole numbers are used as the scale divisions.
Chris@1295 281 # Default it false, to turn on set to true. This has no effect if
Chris@1295 282 # scale divisions are less than 1.
Chris@1295 283 attr_accessor :scale_integers
Chris@1295 284 # This defines the gap between markers on the Y axis,
Chris@1295 285 # default is a 10th of the max_value, e.g. you will have
Chris@1295 286 # 10 markers on the Y axis. NOTE: do not set this too
Chris@1295 287 # low - you are limited to 999 markers, after that the
Chris@1295 288 # graph won't generate.
Chris@1295 289 attr_accessor :scale_divisions
Chris@1295 290 # Whether to show the title under the X axis labels,
Chris@1295 291 # default is false, set to true to show.
Chris@1295 292 attr_accessor :show_x_title
Chris@1295 293 # What the title under X axis should be, e.g. 'Months'.
Chris@1295 294 attr_accessor :x_title
Chris@1295 295 # Whether to show the title under the Y axis labels,
Chris@1295 296 # default is false, set to true to show.
Chris@1295 297 attr_accessor :show_y_title
Chris@1295 298 # Aligns writing mode for Y axis label.
Chris@1295 299 # Defaults to :bt (Bottom to Top).
Chris@1295 300 # Change to :tb (Top to Bottom) to reverse.
Chris@1295 301 attr_accessor :y_title_text_direction
Chris@1295 302 # What the title under Y axis should be, e.g. 'Sales in thousands'.
Chris@1295 303 attr_accessor :y_title
Chris@1295 304 # Whether to show a title on the graph, defaults
Chris@1295 305 # to false, set to true to show.
Chris@1295 306 attr_accessor :show_graph_title
Chris@1295 307 # What the title on the graph should be.
Chris@1295 308 attr_accessor :graph_title
Chris@1295 309 # Whether to show a subtitle on the graph, defaults
Chris@1295 310 # to false, set to true to show.
Chris@1295 311 attr_accessor :show_graph_subtitle
Chris@1295 312 # What the subtitle on the graph should be.
Chris@1295 313 attr_accessor :graph_subtitle
Chris@1295 314 # Whether to show a key, defaults to false, set to
Chris@1295 315 # true if you want to show it.
Chris@1295 316 attr_accessor :key
Chris@1295 317 # Where the key should be positioned, defaults to
Chris@1295 318 # :right, set to :bottom if you want to move it.
Chris@1295 319 attr_accessor :key_position
Chris@1295 320 # Set the font size (in points) of the data point labels
Chris@1295 321 attr_accessor :font_size
Chris@1295 322 # Set the font size of the X axis labels
Chris@1295 323 attr_accessor :x_label_font_size
Chris@1295 324 # Set the font size of the X axis title
Chris@1295 325 attr_accessor :x_title_font_size
Chris@1295 326 # Set the font size of the Y axis labels
Chris@1295 327 attr_accessor :y_label_font_size
Chris@1295 328 # Set the font size of the Y axis title
Chris@1295 329 attr_accessor :y_title_font_size
Chris@1295 330 # Set the title font size
Chris@1295 331 attr_accessor :title_font_size
Chris@1295 332 # Set the subtitle font size
Chris@1295 333 attr_accessor :subtitle_font_size
Chris@1295 334 # Set the key font size
Chris@1295 335 attr_accessor :key_font_size
Chris@1295 336 # Show guidelines for the X axis
Chris@1295 337 attr_accessor :show_x_guidelines
Chris@1295 338 # Show guidelines for the Y axis
Chris@1295 339 attr_accessor :show_y_guidelines
Chris@1295 340 # Do not use CSS if set to true. Many SVG viewers do not support CSS, but
Chris@1295 341 # not using CSS can result in larger SVGs as well as making it impossible to
Chris@1295 342 # change colors after the chart is generated. Defaults to false.
Chris@1295 343 attr_accessor :no_css
Chris@1295 344 # Add popups for the data points on some graphs
Chris@1295 345 attr_accessor :add_popups
Chris@1295 346
Chris@1295 347
Chris@1295 348 protected
Chris@1295 349
Chris@1295 350 def sort( *arrys )
Chris@1295 351 sort_multiple( arrys )
Chris@1295 352 end
Chris@1295 353
Chris@1295 354 # Overwrite configuration options with supplied options. Used
Chris@1295 355 # by subclasses.
Chris@1295 356 def init_with config
Chris@1295 357 config.each { |key, value|
Chris@1295 358 self.send((key.to_s+"=").to_sym, value ) if respond_to? key.to_sym
Chris@1295 359 }
Chris@1295 360 end
Chris@1295 361
Chris@1295 362 attr_accessor :top_align, :top_font, :right_align, :right_font
Chris@1295 363
Chris@1295 364 KEY_BOX_SIZE = 12
Chris@1295 365
Chris@1295 366 # Override this (and call super) to change the margin to the left
Chris@1295 367 # of the plot area. Results in @border_left being set.
Chris@1295 368 def calculate_left_margin
Chris@1295 369 @border_left = 7
Chris@1295 370 # Check for Y labels
Chris@1295 371 max_y_label_height_px = rotate_y_labels ?
Chris@1295 372 y_label_font_size :
Chris@1295 373 get_y_labels.max{|a,b|
Chris@1295 374 a.to_s.length<=>b.to_s.length
Chris@1295 375 }.to_s.length * y_label_font_size * 0.6
Chris@1295 376 @border_left += max_y_label_height_px if show_y_labels
Chris@1295 377 @border_left += max_y_label_height_px + 10 if stagger_y_labels
Chris@1295 378 @border_left += y_title_font_size + 5 if show_y_title
Chris@1295 379 end
Chris@1295 380
Chris@1295 381
Chris@1295 382 # Calculates the width of the widest Y label. This will be the
Chris@1295 383 # character height if the Y labels are rotated
Chris@1295 384 def max_y_label_width_px
Chris@1295 385 return font_size if rotate_y_labels
Chris@1295 386 end
Chris@1295 387
Chris@1295 388
Chris@1295 389 # Override this (and call super) to change the margin to the right
Chris@1295 390 # of the plot area. Results in @border_right being set.
Chris@1295 391 def calculate_right_margin
Chris@1295 392 @border_right = 7
Chris@1295 393 if key and key_position == :right
Chris@1295 394 val = keys.max { |a,b| a.length <=> b.length }
Chris@1295 395 @border_right += val.length * key_font_size * 0.6
Chris@1295 396 @border_right += KEY_BOX_SIZE
Chris@1295 397 @border_right += 10 # Some padding around the box
Chris@1295 398 end
Chris@1295 399 end
Chris@1295 400
Chris@1295 401
Chris@1295 402 # Override this (and call super) to change the margin to the top
Chris@1295 403 # of the plot area. Results in @border_top being set.
Chris@1295 404 def calculate_top_margin
Chris@1295 405 @border_top = 5
Chris@1295 406 @border_top += title_font_size if show_graph_title
Chris@1295 407 @border_top += 5
Chris@1295 408 @border_top += subtitle_font_size if show_graph_subtitle
Chris@1295 409 end
Chris@1295 410
Chris@1295 411
Chris@1295 412 # Adds pop-up point information to a graph.
Chris@1295 413 def add_popup( x, y, label )
Chris@1295 414 txt_width = label.length * font_size * 0.6 + 10
Chris@1295 415 tx = (x+txt_width > width ? x-5 : x+5)
Chris@1295 416 t = @foreground.add_element( "text", {
Chris@1295 417 "x" => tx.to_s,
Chris@1295 418 "y" => (y - font_size).to_s,
Chris@1295 419 "visibility" => "hidden",
Chris@1295 420 })
Chris@1295 421 t.attributes["style"] = "fill: #000; "+
Chris@1295 422 (x+txt_width > width ? "text-anchor: end;" : "text-anchor: start;")
Chris@1295 423 t.text = label.to_s
Chris@1295 424 t.attributes["id"] = t.object_id.to_s
Chris@1295 425
Chris@1295 426 @foreground.add_element( "circle", {
Chris@1295 427 "cx" => x.to_s,
Chris@1295 428 "cy" => y.to_s,
Chris@1295 429 "r" => "10",
Chris@1295 430 "style" => "opacity: 0",
Chris@1295 431 "onmouseover" =>
Chris@1295 432 "document.getElementById(#{t.object_id}).setAttribute('visibility', 'visible' )",
Chris@1295 433 "onmouseout" =>
Chris@1295 434 "document.getElementById(#{t.object_id}).setAttribute('visibility', 'hidden' )",
Chris@1295 435 })
Chris@1295 436
Chris@1295 437 end
Chris@1295 438
Chris@1295 439
Chris@1295 440 # Override this (and call super) to change the margin to the bottom
Chris@1295 441 # of the plot area. Results in @border_bottom being set.
Chris@1295 442 def calculate_bottom_margin
Chris@1295 443 @border_bottom = 7
Chris@1295 444 if key and key_position == :bottom
Chris@1295 445 @border_bottom += @data.size * (font_size + 5)
Chris@1295 446 @border_bottom += 10
Chris@1295 447 end
Chris@1295 448 if show_x_labels
Chris@1295 449 max_x_label_height_px = (not rotate_x_labels) ?
Chris@1295 450 x_label_font_size :
Chris@1295 451 get_x_labels.max{|a,b|
Chris@1295 452 a.to_s.length<=>b.to_s.length
Chris@1295 453 }.to_s.length * x_label_font_size * 0.6
Chris@1295 454 @border_bottom += max_x_label_height_px
Chris@1295 455 @border_bottom += max_x_label_height_px + 10 if stagger_x_labels
Chris@1295 456 end
Chris@1295 457 @border_bottom += x_title_font_size + 5 if show_x_title
Chris@1295 458 end
Chris@1295 459
Chris@1295 460
Chris@1295 461 # Draws the background, axis, and labels.
Chris@1295 462 def draw_graph
Chris@1295 463 @graph = @root.add_element( "g", {
Chris@1295 464 "transform" => "translate( #@border_left #@border_top )"
Chris@1295 465 })
Chris@1295 466
Chris@1295 467 # Background
Chris@1295 468 @graph.add_element( "rect", {
Chris@1295 469 "x" => "0",
Chris@1295 470 "y" => "0",
Chris@1295 471 "width" => @graph_width.to_s,
Chris@1295 472 "height" => @graph_height.to_s,
Chris@1295 473 "class" => "graphBackground"
Chris@1295 474 })
Chris@1295 475
Chris@1295 476 # Axis
Chris@1295 477 @graph.add_element( "path", {
Chris@1295 478 "d" => "M 0 0 v#@graph_height",
Chris@1295 479 "class" => "axis",
Chris@1295 480 "id" => "xAxis"
Chris@1295 481 })
Chris@1295 482 @graph.add_element( "path", {
Chris@1295 483 "d" => "M 0 #@graph_height h#@graph_width",
Chris@1295 484 "class" => "axis",
Chris@1295 485 "id" => "yAxis"
Chris@1295 486 })
Chris@1295 487
Chris@1295 488 draw_x_labels
Chris@1295 489 draw_y_labels
Chris@1295 490 end
Chris@1295 491
Chris@1295 492
Chris@1295 493 # Where in the X area the label is drawn
Chris@1295 494 # Centered in the field, should be width/2. Start, 0.
Chris@1295 495 def x_label_offset( width )
Chris@1295 496 0
Chris@1295 497 end
Chris@1295 498
Chris@1295 499 def make_datapoint_text( x, y, value, style="" )
Chris@1295 500 if show_data_values
Chris@1295 501 @foreground.add_element( "text", {
Chris@1295 502 "x" => x.to_s,
Chris@1295 503 "y" => y.to_s,
Chris@1295 504 "class" => "dataPointLabel",
Chris@1295 505 "style" => "#{style} stroke: #fff; stroke-width: 2;"
Chris@1295 506 }).text = value.to_s
Chris@1295 507 text = @foreground.add_element( "text", {
Chris@1295 508 "x" => x.to_s,
Chris@1295 509 "y" => y.to_s,
Chris@1295 510 "class" => "dataPointLabel"
Chris@1295 511 })
Chris@1295 512 text.text = value.to_s
Chris@1295 513 text.attributes["style"] = style if style.length > 0
Chris@1295 514 end
Chris@1295 515 end
Chris@1295 516
Chris@1295 517
Chris@1295 518 # Draws the X axis labels
Chris@1295 519 def draw_x_labels
Chris@1295 520 stagger = x_label_font_size + 5
Chris@1295 521 if show_x_labels
Chris@1295 522 label_width = field_width
Chris@1295 523
Chris@1295 524 count = 0
Chris@1295 525 for label in get_x_labels
Chris@1295 526 if step_include_first_x_label == true then
Chris@1295 527 step = count % step_x_labels
Chris@1295 528 else
Chris@1295 529 step = (count + 1) % step_x_labels
Chris@1295 530 end
Chris@1295 531
Chris@1295 532 if step == 0 then
Chris@1295 533 text = @graph.add_element( "text" )
Chris@1295 534 text.attributes["class"] = "xAxisLabels"
Chris@1295 535 text.text = label.to_s
Chris@1295 536
Chris@1295 537 x = count * label_width + x_label_offset( label_width )
Chris@1295 538 y = @graph_height + x_label_font_size + 3
Chris@1295 539 t = 0 - (font_size / 2)
Chris@1295 540
Chris@1295 541 if stagger_x_labels and count % 2 == 1
Chris@1295 542 y += stagger
Chris@1295 543 @graph.add_element( "path", {
Chris@1295 544 "d" => "M#{x} #@graph_height v#{stagger}",
Chris@1295 545 "class" => "staggerGuideLine"
Chris@1295 546 })
Chris@1295 547 end
Chris@1295 548
Chris@1295 549 text.attributes["x"] = x.to_s
Chris@1295 550 text.attributes["y"] = y.to_s
Chris@1295 551 if rotate_x_labels
Chris@1295 552 text.attributes["transform"] =
Chris@1295 553 "rotate( 90 #{x} #{y-x_label_font_size} )"+
Chris@1295 554 " translate( 0 -#{x_label_font_size/4} )"
Chris@1295 555 text.attributes["style"] = "text-anchor: start"
Chris@1295 556 else
Chris@1295 557 text.attributes["style"] = "text-anchor: middle"
Chris@1295 558 end
Chris@1295 559 end
Chris@1295 560
Chris@1295 561 draw_x_guidelines( label_width, count ) if show_x_guidelines
Chris@1295 562 count += 1
Chris@1295 563 end
Chris@1295 564 end
Chris@1295 565 end
Chris@1295 566
Chris@1295 567
Chris@1295 568 # Where in the Y area the label is drawn
Chris@1295 569 # Centered in the field, should be width/2. Start, 0.
Chris@1295 570 def y_label_offset( height )
Chris@1295 571 0
Chris@1295 572 end
Chris@1295 573
Chris@1295 574
Chris@1295 575 def field_width
Chris@1295 576 (@graph_width.to_f - font_size*2*right_font) /
Chris@1295 577 (get_x_labels.length - right_align)
Chris@1295 578 end
Chris@1295 579
Chris@1295 580
Chris@1295 581 def field_height
Chris@1295 582 (@graph_height.to_f - font_size*2*top_font) /
Chris@1295 583 (get_y_labels.length - top_align)
Chris@1295 584 end
Chris@1295 585
Chris@1295 586
Chris@1295 587 # Draws the Y axis labels
Chris@1295 588 def draw_y_labels
Chris@1295 589 stagger = y_label_font_size + 5
Chris@1295 590 if show_y_labels
Chris@1295 591 label_height = field_height
Chris@1295 592
Chris@1295 593 count = 0
Chris@1295 594 y_offset = @graph_height + y_label_offset( label_height )
Chris@1295 595 y_offset += font_size/1.2 unless rotate_y_labels
Chris@1295 596 for label in get_y_labels
Chris@1295 597 y = y_offset - (label_height * count)
Chris@1295 598 x = rotate_y_labels ? 0 : -3
Chris@1295 599
Chris@1295 600 if stagger_y_labels and count % 2 == 1
Chris@1295 601 x -= stagger
Chris@1295 602 @graph.add_element( "path", {
Chris@1295 603 "d" => "M#{x} #{y} h#{stagger}",
Chris@1295 604 "class" => "staggerGuideLine"
Chris@1295 605 })
Chris@1295 606 end
Chris@1295 607
Chris@1295 608 text = @graph.add_element( "text", {
Chris@1295 609 "x" => x.to_s,
Chris@1295 610 "y" => y.to_s,
Chris@1295 611 "class" => "yAxisLabels"
Chris@1295 612 })
Chris@1295 613 text.text = label.to_s
Chris@1295 614 if rotate_y_labels
Chris@1295 615 text.attributes["transform"] = "translate( -#{font_size} 0 ) "+
Chris@1295 616 "rotate( 90 #{x} #{y} ) "
Chris@1295 617 text.attributes["style"] = "text-anchor: middle"
Chris@1295 618 else
Chris@1295 619 text.attributes["y"] = (y - (y_label_font_size/2)).to_s
Chris@1295 620 text.attributes["style"] = "text-anchor: end"
Chris@1295 621 end
Chris@1295 622 draw_y_guidelines( label_height, count ) if show_y_guidelines
Chris@1295 623 count += 1
Chris@1295 624 end
Chris@1295 625 end
Chris@1295 626 end
Chris@1295 627
Chris@1295 628
Chris@1295 629 # Draws the X axis guidelines
Chris@1295 630 def draw_x_guidelines( label_height, count )
Chris@1295 631 if count != 0
Chris@1295 632 @graph.add_element( "path", {
Chris@1295 633 "d" => "M#{label_height*count} 0 v#@graph_height",
Chris@1295 634 "class" => "guideLines"
Chris@1295 635 })
Chris@1295 636 end
Chris@1295 637 end
Chris@1295 638
Chris@1295 639
Chris@1295 640 # Draws the Y axis guidelines
Chris@1295 641 def draw_y_guidelines( label_height, count )
Chris@1295 642 if count != 0
Chris@1295 643 @graph.add_element( "path", {
Chris@1295 644 "d" => "M0 #{@graph_height-(label_height*count)} h#@graph_width",
Chris@1295 645 "class" => "guideLines"
Chris@1295 646 })
Chris@1295 647 end
Chris@1295 648 end
Chris@1295 649
Chris@1295 650
Chris@1295 651 # Draws the graph title and subtitle
Chris@1295 652 def draw_titles
Chris@1295 653 if show_graph_title
Chris@1295 654 @root.add_element( "text", {
Chris@1295 655 "x" => (width / 2).to_s,
Chris@1295 656 "y" => (title_font_size).to_s,
Chris@1295 657 "class" => "mainTitle"
Chris@1295 658 }).text = graph_title.to_s
Chris@1295 659 end
Chris@1295 660
Chris@1295 661 if show_graph_subtitle
Chris@1295 662 y_subtitle = show_graph_title ?
Chris@1295 663 title_font_size + 10 :
Chris@1295 664 subtitle_font_size
Chris@1295 665 @root.add_element("text", {
Chris@1295 666 "x" => (width / 2).to_s,
Chris@1295 667 "y" => (y_subtitle).to_s,
Chris@1295 668 "class" => "subTitle"
Chris@1295 669 }).text = graph_subtitle.to_s
Chris@1295 670 end
Chris@1295 671
Chris@1295 672 if show_x_title
Chris@1295 673 y = @graph_height + @border_top + x_title_font_size
Chris@1295 674 if show_x_labels
Chris@1295 675 y += x_label_font_size + 5 if stagger_x_labels
Chris@1295 676 y += x_label_font_size + 5
Chris@1295 677 end
Chris@1295 678 x = width / 2
Chris@1295 679
Chris@1295 680 @root.add_element("text", {
Chris@1295 681 "x" => x.to_s,
Chris@1295 682 "y" => y.to_s,
Chris@1295 683 "class" => "xAxisTitle",
Chris@1295 684 }).text = x_title.to_s
Chris@1295 685 end
Chris@1295 686
Chris@1295 687 if show_y_title
Chris@1295 688 x = y_title_font_size + (y_title_text_direction==:bt ? 3 : -3)
Chris@1295 689 y = height / 2
Chris@1295 690
Chris@1295 691 text = @root.add_element("text", {
Chris@1295 692 "x" => x.to_s,
Chris@1295 693 "y" => y.to_s,
Chris@1295 694 "class" => "yAxisTitle",
Chris@1295 695 })
Chris@1295 696 text.text = y_title.to_s
Chris@1295 697 if y_title_text_direction == :bt
Chris@1295 698 text.attributes["transform"] = "rotate( -90, #{x}, #{y} )"
Chris@1295 699 else
Chris@1295 700 text.attributes["transform"] = "rotate( 90, #{x}, #{y} )"
Chris@1295 701 end
Chris@1295 702 end
Chris@1295 703 end
Chris@1295 704
Chris@1295 705 def keys
Chris@1295 706 return @data.collect{ |d| d[:title] }
Chris@1295 707 end
Chris@1295 708
Chris@1295 709 # Draws the legend on the graph
Chris@1295 710 def draw_legend
Chris@1295 711 if key
Chris@1295 712 group = @root.add_element( "g" )
Chris@1295 713
Chris@1295 714 key_count = 0
Chris@1295 715 for key_name in keys
Chris@1295 716 y_offset = (KEY_BOX_SIZE * key_count) + (key_count * 5)
Chris@1295 717 group.add_element( "rect", {
Chris@1295 718 "x" => 0.to_s,
Chris@1295 719 "y" => y_offset.to_s,
Chris@1295 720 "width" => KEY_BOX_SIZE.to_s,
Chris@1295 721 "height" => KEY_BOX_SIZE.to_s,
Chris@1295 722 "class" => "key#{key_count+1}"
Chris@1295 723 })
Chris@1295 724 group.add_element( "text", {
Chris@1295 725 "x" => (KEY_BOX_SIZE + 5).to_s,
Chris@1295 726 "y" => (y_offset + KEY_BOX_SIZE).to_s,
Chris@1295 727 "class" => "keyText"
Chris@1295 728 }).text = key_name.to_s
Chris@1295 729 key_count += 1
Chris@1295 730 end
Chris@1295 731
Chris@1295 732 case key_position
Chris@1295 733 when :right
Chris@1295 734 x_offset = @graph_width + @border_left + 10
Chris@1295 735 y_offset = @border_top + 20
Chris@1295 736 when :bottom
Chris@1295 737 x_offset = @border_left + 20
Chris@1295 738 y_offset = @border_top + @graph_height + 5
Chris@1295 739 if show_x_labels
Chris@1295 740 max_x_label_height_px = (not rotate_x_labels) ?
Chris@1295 741 x_label_font_size :
Chris@1295 742 get_x_labels.max{|a,b|
Chris@1295 743 a.to_s.length<=>b.to_s.length
Chris@1295 744 }.to_s.length * x_label_font_size * 0.6
Chris@1295 745 x_label_font_size
Chris@1295 746 y_offset += max_x_label_height_px
Chris@1295 747 y_offset += max_x_label_height_px + 5 if stagger_x_labels
Chris@1295 748 end
Chris@1295 749 y_offset += x_title_font_size + 5 if show_x_title
Chris@1295 750 end
Chris@1295 751 group.attributes["transform"] = "translate(#{x_offset} #{y_offset})"
Chris@1295 752 end
Chris@1295 753 end
Chris@1295 754
Chris@1295 755
Chris@1295 756 private
Chris@1295 757
Chris@1295 758 def sort_multiple( arrys, lo=0, hi=arrys[0].length-1 )
Chris@1295 759 if lo < hi
Chris@1295 760 p = partition(arrys,lo,hi)
Chris@1295 761 sort_multiple(arrys, lo, p-1)
Chris@1295 762 sort_multiple(arrys, p+1, hi)
Chris@1295 763 end
Chris@1295 764 arrys
Chris@1295 765 end
Chris@1295 766
Chris@1295 767 def partition( arrys, lo, hi )
Chris@1295 768 p = arrys[0][lo]
Chris@1295 769 l = lo
Chris@1295 770 z = lo+1
Chris@1295 771 while z <= hi
Chris@1295 772 if arrys[0][z] < p
Chris@1295 773 l += 1
Chris@1295 774 arrys.each { |arry| arry[z], arry[l] = arry[l], arry[z] }
Chris@1295 775 end
Chris@1295 776 z += 1
Chris@1295 777 end
Chris@1295 778 arrys.each { |arry| arry[lo], arry[l] = arry[l], arry[lo] }
Chris@1295 779 l
Chris@1295 780 end
Chris@1295 781
Chris@1295 782 def style
Chris@1295 783 if no_css
Chris@1295 784 styles = parse_css
Chris@1295 785 @root.elements.each("//*[@class]") { |el|
Chris@1295 786 cl = el.attributes["class"]
Chris@1295 787 style = styles[cl]
Chris@1295 788 style += el.attributes["style"] if el.attributes["style"]
Chris@1295 789 el.attributes["style"] = style
Chris@1295 790 }
Chris@1295 791 end
Chris@1295 792 end
Chris@1295 793
Chris@1295 794 def parse_css
Chris@1295 795 css = get_style
Chris@1295 796 rv = {}
Chris@1295 797 while css =~ /^(\.(\w+)(?:\s*,\s*\.\w+)*)\s*\{/m
Chris@1295 798 names_orig = names = $1
Chris@1295 799 css = $'
Chris@1295 800 css =~ /([^}]+)\}/m
Chris@1295 801 content = $1
Chris@1295 802 css = $'
Chris@1295 803
Chris@1295 804 nms = []
Chris@1295 805 while names =~ /^\s*,?\s*\.(\w+)/
Chris@1295 806 nms << $1
Chris@1295 807 names = $'
Chris@1295 808 end
Chris@1295 809
Chris@1295 810 content = content.tr( "\n\t", " ")
Chris@1295 811 for name in nms
Chris@1295 812 current = rv[name]
Chris@1295 813 current = current ? current+"; "+content : content
Chris@1295 814 rv[name] = current.strip.squeeze(" ")
Chris@1295 815 end
Chris@1295 816 end
Chris@1295 817 return rv
Chris@1295 818 end
Chris@1295 819
Chris@1295 820
Chris@1295 821 # Override and place code to add defs here
Chris@1295 822 def add_defs defs
Chris@1295 823 end
Chris@1295 824
Chris@1295 825
Chris@1295 826 def start_svg
Chris@1295 827 # Base document
Chris@1295 828 @doc = Document.new
Chris@1295 829 @doc << XMLDecl.new
Chris@1295 830 @doc << DocType.new( %q{svg PUBLIC "-//W3C//DTD SVG 1.0//EN" } +
Chris@1295 831 %q{"http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"} )
Chris@1295 832 if style_sheet && style_sheet != ''
Chris@1295 833 @doc << Instruction.new( "xml-stylesheet",
Chris@1295 834 %Q{href="#{style_sheet}" type="text/css"} )
Chris@1295 835 end
Chris@1295 836 @root = @doc.add_element( "svg", {
Chris@1295 837 "width" => width.to_s,
Chris@1295 838 "height" => height.to_s,
Chris@1295 839 "viewBox" => "0 0 #{width} #{height}",
Chris@1295 840 "xmlns" => "http://www.w3.org/2000/svg",
Chris@1295 841 "xmlns:xlink" => "http://www.w3.org/1999/xlink",
Chris@1295 842 "xmlns:a3" => "http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/",
Chris@1295 843 "a3:scriptImplementation" => "Adobe"
Chris@1295 844 })
Chris@1295 845 @root << Comment.new( " "+"\\"*66 )
Chris@1295 846 @root << Comment.new( " Created with SVG::Graph " )
Chris@1295 847 @root << Comment.new( " SVG::Graph by Sean E. Russell " )
Chris@1295 848 @root << Comment.new( " Losely based on SVG::TT::Graph for Perl by"+
Chris@1295 849 " Leo Lapworth & Stephan Morgan " )
Chris@1295 850 @root << Comment.new( " "+"/"*66 )
Chris@1295 851
Chris@1295 852 defs = @root.add_element( "defs" )
Chris@1295 853 add_defs defs
Chris@1295 854 if not(style_sheet && style_sheet != '') and !no_css
Chris@1295 855 @root << Comment.new(" include default stylesheet if none specified ")
Chris@1295 856 style = defs.add_element( "style", {"type"=>"text/css"} )
Chris@1295 857 style << CData.new( get_style )
Chris@1295 858 end
Chris@1295 859
Chris@1295 860 @root << Comment.new( "SVG Background" )
Chris@1295 861 @root.add_element( "rect", {
Chris@1295 862 "width" => width.to_s,
Chris@1295 863 "height" => height.to_s,
Chris@1295 864 "x" => "0",
Chris@1295 865 "y" => "0",
Chris@1295 866 "class" => "svgBackground"
Chris@1295 867 })
Chris@1295 868 end
Chris@1295 869
Chris@1295 870
Chris@1295 871 def calculate_graph_dimensions
Chris@1295 872 calculate_left_margin
Chris@1295 873 calculate_right_margin
Chris@1295 874 calculate_bottom_margin
Chris@1295 875 calculate_top_margin
Chris@1295 876 @graph_width = width - @border_left - @border_right
Chris@1295 877 @graph_height = height - @border_top - @border_bottom
Chris@1295 878 end
Chris@1295 879
Chris@1295 880 def get_style
Chris@1295 881 return <<EOL
Chris@1295 882 /* Copy from here for external style sheet */
Chris@1295 883 .svgBackground{
Chris@1295 884 fill:#ffffff;
Chris@1295 885 }
Chris@1295 886 .graphBackground{
Chris@1295 887 fill:#f0f0f0;
Chris@1295 888 }
Chris@1295 889
Chris@1295 890 /* graphs titles */
Chris@1295 891 .mainTitle{
Chris@1295 892 text-anchor: middle;
Chris@1295 893 fill: #000000;
Chris@1295 894 font-size: #{title_font_size}px;
Chris@1295 895 font-family: "Arial", sans-serif;
Chris@1295 896 font-weight: normal;
Chris@1295 897 }
Chris@1295 898 .subTitle{
Chris@1295 899 text-anchor: middle;
Chris@1295 900 fill: #999999;
Chris@1295 901 font-size: #{subtitle_font_size}px;
Chris@1295 902 font-family: "Arial", sans-serif;
Chris@1295 903 font-weight: normal;
Chris@1295 904 }
Chris@1295 905
Chris@1295 906 .axis{
Chris@1295 907 stroke: #000000;
Chris@1295 908 stroke-width: 1px;
Chris@1295 909 }
Chris@1295 910
Chris@1295 911 .guideLines{
Chris@1295 912 stroke: #666666;
Chris@1295 913 stroke-width: 1px;
Chris@1295 914 stroke-dasharray: 5 5;
Chris@1295 915 }
Chris@1295 916
Chris@1295 917 .xAxisLabels{
Chris@1295 918 text-anchor: middle;
Chris@1295 919 fill: #000000;
Chris@1295 920 font-size: #{x_label_font_size}px;
Chris@1295 921 font-family: "Arial", sans-serif;
Chris@1295 922 font-weight: normal;
Chris@1295 923 }
Chris@1295 924
Chris@1295 925 .yAxisLabels{
Chris@1295 926 text-anchor: end;
Chris@1295 927 fill: #000000;
Chris@1295 928 font-size: #{y_label_font_size}px;
Chris@1295 929 font-family: "Arial", sans-serif;
Chris@1295 930 font-weight: normal;
Chris@1295 931 }
Chris@1295 932
Chris@1295 933 .xAxisTitle{
Chris@1295 934 text-anchor: middle;
Chris@1295 935 fill: #ff0000;
Chris@1295 936 font-size: #{x_title_font_size}px;
Chris@1295 937 font-family: "Arial", sans-serif;
Chris@1295 938 font-weight: normal;
Chris@1295 939 }
Chris@1295 940
Chris@1295 941 .yAxisTitle{
Chris@1295 942 fill: #ff0000;
Chris@1295 943 text-anchor: middle;
Chris@1295 944 font-size: #{y_title_font_size}px;
Chris@1295 945 font-family: "Arial", sans-serif;
Chris@1295 946 font-weight: normal;
Chris@1295 947 }
Chris@1295 948
Chris@1295 949 .dataPointLabel{
Chris@1295 950 fill: #000000;
Chris@1295 951 text-anchor:middle;
Chris@1295 952 font-size: 10px;
Chris@1295 953 font-family: "Arial", sans-serif;
Chris@1295 954 font-weight: normal;
Chris@1295 955 }
Chris@1295 956
Chris@1295 957 .staggerGuideLine{
Chris@1295 958 fill: none;
Chris@1295 959 stroke: #000000;
Chris@1295 960 stroke-width: 0.5px;
Chris@1295 961 }
Chris@1295 962
Chris@1295 963 #{get_css}
Chris@1295 964
Chris@1295 965 .keyText{
Chris@1295 966 fill: #000000;
Chris@1295 967 text-anchor:start;
Chris@1295 968 font-size: #{key_font_size}px;
Chris@1295 969 font-family: "Arial", sans-serif;
Chris@1295 970 font-weight: normal;
Chris@1295 971 }
Chris@1295 972 /* End copy for external style sheet */
Chris@1295 973 EOL
Chris@1295 974 end
Chris@1295 975
Chris@1295 976 end
Chris@1295 977 end
Chris@1295 978 end