diff options
author | Jean-Philippe Lang <jp_lang@yahoo.fr> | 2009-03-30 19:58:17 +0000 |
---|---|---|
committer | Jean-Philippe Lang <jp_lang@yahoo.fr> | 2009-03-30 19:58:17 +0000 |
commit | c9c269abf7e9c193d29222ea198f34409bbaa6f9 (patch) | |
tree | b2a75c73d31911c4b7eec79ef4e34f17afa84a6d /lib/SVG/Graph/TimeSeries.rb | |
parent | 8d6d9a80d2c327c3f91eb243ba297a2169bd6153 (diff) | |
download | redmine-c9c269abf7e9c193d29222ea198f34409bbaa6f9.tar.gz redmine-c9c269abf7e9c193d29222ea198f34409bbaa6f9.zip |
Update SVG library to latest stable (0.6.1) (#3056).
git-svn-id: svn+ssh://rubyforge.org/var/svn/redmine/trunk@2642 e93f8b46-1217-0410-a6f0-8f06a7374b81
Diffstat (limited to 'lib/SVG/Graph/TimeSeries.rb')
-rw-r--r-- | lib/SVG/Graph/TimeSeries.rb | 482 |
1 files changed, 241 insertions, 241 deletions
diff --git a/lib/SVG/Graph/TimeSeries.rb b/lib/SVG/Graph/TimeSeries.rb index 7ab3e7476..ee47359aa 100644 --- a/lib/SVG/Graph/TimeSeries.rb +++ b/lib/SVG/Graph/TimeSeries.rb @@ -1,241 +1,241 @@ -require 'SVG/Graph/Plot' -require 'parsedate' - -module SVG - module Graph - # === For creating SVG plots of scalar temporal data - # - # = Synopsis - # - # require 'SVG/Graph/TimeSeriess' - # - # # Data sets are x,y pairs - # data1 = ["6/17/72", 11, "1/11/72", 7, "4/13/04 17:31", 11, - # "9/11/01", 9, "9/1/85", 2, "9/1/88", 1, "1/15/95", 13] - # data2 = ["8/1/73", 18, "3/1/77", 15, "10/1/98", 4, - # "5/1/02", 14, "3/1/95", 6, "8/1/91", 12, "12/1/87", 6, - # "5/1/84", 17, "10/1/80", 12] - # - # graph = SVG::Graph::TimeSeries.new( { - # :width => 640, - # :height => 480, - # :graph_title => title, - # :show_graph_title => true, - # :no_css => true, - # :key => true, - # :scale_x_integers => true, - # :scale_y_integers => true, - # :min_x_value => 0, - # :min_y_value => 0, - # :show_data_labels => true, - # :show_x_guidelines => true, - # :show_x_title => true, - # :x_title => "Time", - # :show_y_title => true, - # :y_title => "Ice Cream Cones", - # :y_title_text_direction => :bt, - # :stagger_x_labels => true, - # :x_label_format => "%m/%d/%y", - # }) - # - # graph.add_data({ - # :data => projection - # :title => 'Projected', - # }) - # - # graph.add_data({ - # :data => actual, - # :title => 'Actual', - # }) - # - # print graph.burn() - # - # = Description - # - # Produces a graph of temporal scalar data. - # - # = Examples - # - # http://www.germane-software/repositories/public/SVG/test/timeseries.rb - # - # = Notes - # - # The default stylesheet handles upto 10 data sets, if you - # use more you must create your own stylesheet and add the - # additional settings for the extra data sets. You will know - # if you go over 10 data sets as they will have no style and - # be in black. - # - # Unlike the other types of charts, data sets must contain x,y pairs: - # - # [ "12:30", 2 ] # A data set with 1 point: ("12:30",2) - # [ "01:00",2, "14:20",6] # A data set with 2 points: ("01:00",2) and - # # ("14:20",6) - # - # Note that multiple data sets within the same chart can differ in length, - # and that the data in the datasets needn't be in order; they will be ordered - # by the plot along the X-axis. - # - # The dates must be parseable by ParseDate, but otherwise can be - # any order of magnitude (seconds within the hour, or years) - # - # = See also - # - # * SVG::Graph::Graph - # * SVG::Graph::BarHorizontal - # * SVG::Graph::Bar - # * SVG::Graph::Line - # * SVG::Graph::Pie - # * SVG::Graph::Plot - # - # == Author - # - # Sean E. Russell <serATgermaneHYPHENsoftwareDOTcom> - # - # Copyright 2004 Sean E. Russell - # This software is available under the Ruby license[LICENSE.txt] - # - class TimeSeries < Plot - # In addition to the defaults set by Graph::initialize and - # Plot::set_defaults, sets: - # [x_label_format] '%Y-%m-%d %H:%M:%S' - # [popup_format] '%Y-%m-%d %H:%M:%S' - def set_defaults - super - init_with( - #:max_time_span => '', - :x_label_format => '%Y-%m-%d %H:%M:%S', - :popup_format => '%Y-%m-%d %H:%M:%S' - ) - end - - # The format string use do format the X axis labels. - # See Time::strformat - attr_accessor :x_label_format - # Use this to set the spacing between dates on the axis. The value - # must be of the form - # "\d+ ?(days|weeks|months|years|hours|minutes|seconds)?" - # - # EG: - # - # graph.timescale_divisions = "2 weeks" - # - # will cause the chart to try to divide the X axis up into segments of - # two week periods. - attr_accessor :timescale_divisions - # The formatting used for the popups. See x_label_format - attr_accessor :popup_format - - # Add data to the plot. - # - # d1 = [ "12:30", 2 ] # A data set with 1 point: ("12:30",2) - # d2 = [ "01:00",2, "14:20",6] # A data set with 2 points: ("01:00",2) and - # # ("14:20",6) - # graph.add_data( - # :data => d1, - # :title => 'One' - # ) - # graph.add_data( - # :data => d2, - # :title => 'Two' - # ) - # - # Note that the data must be in time,value pairs, and that the date format - # may be any date that is parseable by ParseDate. - def add_data data - @data = [] unless @data - - raise "No data provided by #{conf.inspect}" unless data[:data] and - data[:data].kind_of? Array - raise "Data supplied must be x,y pairs! "+ - "The data provided contained an odd set of "+ - "data points" unless data[:data].length % 2 == 0 - return if data[:data].length == 0 - - - x = [] - y = [] - data[:data].each_index {|i| - if i%2 == 0 - arr = ParseDate.parsedate( data[:data][i] ) - t = Time.local( *arr[0,6].compact ) - x << t.to_i - else - y << data[:data][i] - end - } - sort( x, y ) - data[:data] = [x,y] - @data << data - end - - - protected - - def min_x_value=(value) - arr = ParseDate.parsedate( value ) - @min_x_value = Time.local( *arr[0,6].compact ).to_i - end - - - def format x, y - Time.at( x ).strftime( popup_format ) - end - - def get_x_labels - get_x_values.collect { |v| Time.at(v).strftime( x_label_format ) } - end - - private - def get_x_values - rv = [] - min, max, scale_division = x_range - if timescale_divisions - timescale_divisions =~ /(\d+) ?(days|weeks|months|years|hours|minutes|seconds)?/ - division_units = $2 ? $2 : "days" - amount = $1.to_i - if amount - step = nil - case division_units - when "months" - cur = min - while cur < max - rv << cur - arr = Time.at( cur ).to_a - arr[4] += amount - if arr[4] > 12 - arr[5] += (arr[4] / 12).to_i - arr[4] = (arr[4] % 12) - end - cur = Time.local(*arr).to_i - end - when "years" - cur = min - while cur < max - rv << cur - arr = Time.at( cur ).to_a - arr[5] += amount - cur = Time.local(*arr).to_i - end - when "weeks" - step = 7 * 24 * 60 * 60 * amount - when "days" - step = 24 * 60 * 60 * amount - when "hours" - step = 60 * 60 * amount - when "minutes" - step = 60 * amount - when "seconds" - step = amount - end - min.step( max, step ) {|v| rv << v} if step - - return rv - end - end - min.step( max, scale_division ) {|v| rv << v} - return rv - end - end - end -end +require 'SVG/Graph/Plot'
+require 'parsedate'
+
+module SVG
+ module Graph
+ # === For creating SVG plots of scalar temporal data
+ #
+ # = Synopsis
+ #
+ # require 'SVG/Graph/TimeSeriess'
+ #
+ # # Data sets are x,y pairs
+ # data1 = ["6/17/72", 11, "1/11/72", 7, "4/13/04 17:31", 11,
+ # "9/11/01", 9, "9/1/85", 2, "9/1/88", 1, "1/15/95", 13]
+ # data2 = ["8/1/73", 18, "3/1/77", 15, "10/1/98", 4,
+ # "5/1/02", 14, "3/1/95", 6, "8/1/91", 12, "12/1/87", 6,
+ # "5/1/84", 17, "10/1/80", 12]
+ #
+ # graph = SVG::Graph::TimeSeries.new( {
+ # :width => 640,
+ # :height => 480,
+ # :graph_title => title,
+ # :show_graph_title => true,
+ # :no_css => true,
+ # :key => true,
+ # :scale_x_integers => true,
+ # :scale_y_integers => true,
+ # :min_x_value => 0,
+ # :min_y_value => 0,
+ # :show_data_labels => true,
+ # :show_x_guidelines => true,
+ # :show_x_title => true,
+ # :x_title => "Time",
+ # :show_y_title => true,
+ # :y_title => "Ice Cream Cones",
+ # :y_title_text_direction => :bt,
+ # :stagger_x_labels => true,
+ # :x_label_format => "%m/%d/%y",
+ # })
+ #
+ # graph.add_data({
+ # :data => projection
+ # :title => 'Projected',
+ # })
+ #
+ # graph.add_data({
+ # :data => actual,
+ # :title => 'Actual',
+ # })
+ #
+ # print graph.burn()
+ #
+ # = Description
+ #
+ # Produces a graph of temporal scalar data.
+ #
+ # = Examples
+ #
+ # http://www.germane-software/repositories/public/SVG/test/timeseries.rb
+ #
+ # = Notes
+ #
+ # The default stylesheet handles upto 10 data sets, if you
+ # use more you must create your own stylesheet and add the
+ # additional settings for the extra data sets. You will know
+ # if you go over 10 data sets as they will have no style and
+ # be in black.
+ #
+ # Unlike the other types of charts, data sets must contain x,y pairs:
+ #
+ # [ "12:30", 2 ] # A data set with 1 point: ("12:30",2)
+ # [ "01:00",2, "14:20",6] # A data set with 2 points: ("01:00",2) and
+ # # ("14:20",6)
+ #
+ # Note that multiple data sets within the same chart can differ in length,
+ # and that the data in the datasets needn't be in order; they will be ordered
+ # by the plot along the X-axis.
+ #
+ # The dates must be parseable by ParseDate, but otherwise can be
+ # any order of magnitude (seconds within the hour, or years)
+ #
+ # = See also
+ #
+ # * SVG::Graph::Graph
+ # * SVG::Graph::BarHorizontal
+ # * SVG::Graph::Bar
+ # * SVG::Graph::Line
+ # * SVG::Graph::Pie
+ # * SVG::Graph::Plot
+ #
+ # == Author
+ #
+ # Sean E. Russell <serATgermaneHYPHENsoftwareDOTcom>
+ #
+ # Copyright 2004 Sean E. Russell
+ # This software is available under the Ruby license[LICENSE.txt]
+ #
+ class TimeSeries < Plot
+ # In addition to the defaults set by Graph::initialize and
+ # Plot::set_defaults, sets:
+ # [x_label_format] '%Y-%m-%d %H:%M:%S'
+ # [popup_format] '%Y-%m-%d %H:%M:%S'
+ def set_defaults
+ super
+ init_with(
+ #:max_time_span => '',
+ :x_label_format => '%Y-%m-%d %H:%M:%S',
+ :popup_format => '%Y-%m-%d %H:%M:%S'
+ )
+ end
+
+ # The format string use do format the X axis labels.
+ # See Time::strformat
+ attr_accessor :x_label_format
+ # Use this to set the spacing between dates on the axis. The value
+ # must be of the form
+ # "\d+ ?(days|weeks|months|years|hours|minutes|seconds)?"
+ #
+ # EG:
+ #
+ # graph.timescale_divisions = "2 weeks"
+ #
+ # will cause the chart to try to divide the X axis up into segments of
+ # two week periods.
+ attr_accessor :timescale_divisions
+ # The formatting used for the popups. See x_label_format
+ attr_accessor :popup_format
+
+ # Add data to the plot.
+ #
+ # d1 = [ "12:30", 2 ] # A data set with 1 point: ("12:30",2)
+ # d2 = [ "01:00",2, "14:20",6] # A data set with 2 points: ("01:00",2) and
+ # # ("14:20",6)
+ # graph.add_data(
+ # :data => d1,
+ # :title => 'One'
+ # )
+ # graph.add_data(
+ # :data => d2,
+ # :title => 'Two'
+ # )
+ #
+ # Note that the data must be in time,value pairs, and that the date format
+ # may be any date that is parseable by ParseDate.
+ def add_data data
+ @data = [] unless @data
+
+ raise "No data provided by #{@data.inspect}" unless data[:data] and
+ data[:data].kind_of? Array
+ raise "Data supplied must be x,y pairs! "+
+ "The data provided contained an odd set of "+
+ "data points" unless data[:data].length % 2 == 0
+ return if data[:data].length == 0
+
+
+ x = []
+ y = []
+ data[:data].each_index {|i|
+ if i%2 == 0
+ arr = ParseDate.parsedate( data[:data][i] )
+ t = Time.local( *arr[0,6].compact )
+ x << t.to_i
+ else
+ y << data[:data][i]
+ end
+ }
+ sort( x, y )
+ data[:data] = [x,y]
+ @data << data
+ end
+
+
+ protected
+
+ def min_x_value=(value)
+ arr = ParseDate.parsedate( value )
+ @min_x_value = Time.local( *arr[0,6].compact ).to_i
+ end
+
+
+ def format x, y
+ Time.at( x ).strftime( popup_format )
+ end
+
+ def get_x_labels
+ get_x_values.collect { |v| Time.at(v).strftime( x_label_format ) }
+ end
+
+ private
+ def get_x_values
+ rv = []
+ min, max, scale_division = x_range
+ if timescale_divisions
+ timescale_divisions =~ /(\d+) ?(day|week|month|year|hour|minute|second)?/
+ division_units = $2 ? $2 : "day"
+ amount = $1.to_i
+ if amount
+ step = nil
+ case division_units
+ when "month"
+ cur = min
+ while cur < max
+ rv << cur
+ arr = Time.at( cur ).to_a
+ arr[4] += amount
+ if arr[4] > 12
+ arr[5] += (arr[4] / 12).to_i
+ arr[4] = (arr[4] % 12)
+ end
+ cur = Time.local(*arr).to_i
+ end
+ when "year"
+ cur = min
+ while cur < max
+ rv << cur
+ arr = Time.at( cur ).to_a
+ arr[5] += amount
+ cur = Time.local(*arr).to_i
+ end
+ when "week"
+ step = 7 * 24 * 60 * 60 * amount
+ when "day"
+ step = 24 * 60 * 60 * amount
+ when "hour"
+ step = 60 * 60 * amount
+ when "minute"
+ step = 60 * amount
+ when "second"
+ step = amount
+ end
+ min.step( max, step ) {|v| rv << v} if step
+
+ return rv
+ end
+ end
+ min.step( max, scale_division ) {|v| rv << v}
+ return rv
+ end
+ end
+ end
+end
|