rchart 1.0.0

data/lib/rdata.rb

@@ -0,0 +1,239 @@
+class Rdata
+# This function create a new Rdata object.
+# This object will be used during all the steps of the data population.
+# Data will be extracted from this object using get_data and get_data_description 
+	def initialize
+		@data                          = []
+		@data_description              = {}
+		@data_description["position"]  = "name"
+		@data_description["format"]    = {"x"=>"number","y" => "number"}
+		@data_description["unit"]      = {"x" => "","y"=>""}
+		@data_description["symbol"] = {}
+	end
+
+	# This function can be used to add one or multiple points to a data serie.
+	# By default points are added to Serie1.
+	# This will the value 25 as the last point of Serie1
+	# * chart_data.add_point(25)
+	# This will the value 2,4,9,5,1,0 as the last point of Serie1
+	# * chart_data.add_point([2,4,9,5,1,0])
+	# This will the value 12 as the last point of Serie2
+	# * chart_data.add_point(12,"Serie2")
+	# add the desciption "March" to the Serie2
+	# * chart_data.add_point(12,"Serie2","March")
+	def add_point(value,serie="Serie1",description="")
+		if ((value.is_a?(Array)) && value.count == 1)
+			value = value[0]
+		end
+		id = 0
+		@data.each_with_index do |v,index|
+			id = index+1  unless @data[index][serie].nil?
+		end
+		if value.is_a?(Numeric)
+			if @data[id].nil?
+				@data[id]={serie => value}
+			else
+				@data[id]= @data[id].merge(serie => value)
+			end
+			if description != ""
+				@data[id]["name"] = description;
+			elsif @data[id]["name"].nil?
+				@data[id]["name"] = id
+			end
+		else
+
+			value.each do |k|
+				if @data[id].nil?
+					@data[id] = {serie=>k}#TODO check k
+				else
+					@data[id] = @data[id].merge({serie=>k})
+				end
+
+				@data[id]["name"] = id  if @data[id]["name"].nil?
+				id = id+1
+			end
+
+		end
+
+	end
+	# This function can be used to add a new data serie to the data_description.
+	# All the series declared in this object will be graphed when calling a chart function of the Rchart class.
+	# There is no change on Data, only the "Graphable" attribute is modified.
+	# Generate some data...
+	# * chart_data.add_point([2,4,9,5,1,0]),"Serie1")
+	# * chart_data.add_point([1,1,2,2,3,3]),"Serie2")
+	# * chart_data.add_point([4,2,4,2,4,2]),"Serie3")
+	# This will mark both Serie1 & Serie2 as "graphable" but not Serie3
+	# * chart_data.add_serie("Serie1")
+	# * chart_data.add_serie("Serie2")
+	def add_serie(serie_name="Serie1")
+
+		if (@data_description["values"].nil?)
+			@data_description["values"]  = [serie_name]
+		else
+			found = false
+			@data_description["values"].each do |k|
+				found = true if ( k == serie_name )  #TODO check
+			end
+			@data_description["values"] << serie_name if (!found )
+		end
+
+	end
+	# This function can be used to set all data series as graphable.
+	# They'll all be graphed when calling a chart function of the Rchart class.
+	# There is no change on Data, only the "Graphable" attribute is modified
+	# Generate some data...
+	# * chart_data.add_point([2,4,9,5,1,0],"Serie1")
+	# * chart_data.add_point([(1,1,2,2,3,3],"Serie2")
+	# This will mark both Serie1 & Serie2 as "graphable"  
+	# * chart_data.add_all_series
+	
+	def add_all_series
+		@data_description["values"] = []
+		if(!@data[0].nil?)
+			@data[0].each do |k,v|
+				if (k != "name" )
+					@data_description["values"].push(k)
+				end
+			end
+		end
+	end
+	# This function can be used to remove a data series from the graphable ones.
+	# They'll all be graphed when calling a chart function of the Rchart class.
+	# There is no change on Data, only the "Graphable" attribute is modified.
+	# Generate some data...
+	# * chart_data.add_point([2,4,9,5,1,0],"Serie1")
+	# * chart_data.add_point([1,1,2,2,3,3],"Serie2")
+	# This will mark both Serie1 & Serie2 as "graphable"
+	# * chart_data.add_all_series
+	# This will remove the "graphable" status of Serie2
+	# * chart_data.remove_serie("Serie2")
+	
+	def remove_serie(serie_name="Serie1")
+		if (!@data_description["values"].nil?)
+			found = false;
+			@data_description["values"].each do |v|
+				@data_description["values"].delete(v)  if (v == serie_name )
+			end
+		end
+	end
+	# his function can be used to set which serie is used (if any) as abcisse value
+	# Generate some data...
+	# * chart_data.add_point(["Jan","Feb","Mar"),"Serie1")
+	# * chart_data.add_point([2,4,9),"Serie2")
+	# * chart_data.add_point([1,1,2),"Serie3")
+	# This will mark both Serie1 & Serie2 as "graphable"
+	# * chart_data.add_serie("Serie2")
+	# * chart_data.add_serie("Serie3")
+	# Set Serie as abcisse label
+	# * chart_data.set_abscise_label_serie("Serie1")  
+	def set_abscise_label_serie(serie_name = "name")
+		@data_description["position"] = serie_name
+	end
+ # This function can be used to set the description of a serie.
+ # This description will be written on the graph when calling the draw_legend function
+ # Generate some data...
+ # * chart_data.add_point([2,4,9),"Serie1")
+ # * chart_data.add_point([1,1,2),"Serie2")
+ # This will set the name of Serie1 to "January"
+ # * chart_data.set_serie_name("January")
+ # This will set the name of Serie2 to "February"
+ # * chart_data.set_serie_name("February","Serie2")
+	
+	def set_serie_name(name,serie_name="Serie1")
+		if @data_description["description"].nil?
+			@data_description["description"]={serie_name => name}
+		else
+			@data_description["description"] = @data_description["description"].merge(serie_name => name)
+		end
+	end
+
+	# This will give a name to the X axis, writting it horizontally behind the chart
+	# * chart_data.set_x_axis_name("Samples")
+	def set_x_axis_name(name="X Axis")
+		if @data_description["axis"].nil?
+			@data_description["axis"]={"x" => name}
+		else
+			@data_description["axis"]=@data_description["axis"].merge("x" => name)
+		end
+	end
+	# This will give a name to the Y axis, writting it horizontally behind the chart
+	# * chart_data.set_y_axis_name("Temperature") 
+	def set_y_axis_name(name="Y Axis")
+		if @data_description["axis"].nil?
+			@data_description["axis"]= {"y" => name}
+		else
+			@data_description["axis"]=@data_description["axis"].merge("y" => name)
+		end
+	end
+
+# With this function you can set the format of the X axis values. Todays formats are the following :
+# * number used by defaults
+# * metric number that will be displayed with k/m/g units
+
+	def set_x_axis_format(format="number")
+		@data_description["format"]["x"] = format
+	end
+# With this function you can set the format of the Y axis values. Todays formats are the following :
+# * number used by defaults
+# * metric number that will be displayed with k/m/g units
+
+	def set_y_axis_format(format="number")
+		@data_description["format"]["y"] = format
+	end
+# Set the axis unit. This will be appended to the axis value
+# Give the "km" unit to the X axis
+# * chart_data.set_x_axis_unit("km")
+	def set_x_axis_unit(unit="")
+		@data_description["unit"]["x"] = unit
+	end
+	
+# Set the axis unit. This will be appended to the axis value
+# Give the "m/s" unit to the Y axis
+# * chart_data.set_x_axis_unit("m/s")
+	
+	def set_y_axis_unit(unit="")
+		@data_description["unit"]["y"] = unit
+	end
+
+	def set_serie_symbol(name,symbol)
+		@data_description["symbol"][name] = symbol
+	end
+	# This function can be used to remove the description of a serie.
+	# This description will be written on the graph when calling the drawLegend function.
+	# Removing it's name using this function can be usefull to hide previously used series
+	# Generate some data...
+	# * chart_data.add_point([2,4,9],"Serie1")
+	# * chart_data.add_point([1,1,2],"Serie2")
+	# This will set the name of Serie1 to "January"
+	# * chart_data.set_serie_name("January")
+	# This will set the name of Serie2 to "February"
+	# * chart_data.set_serie_name("February","Serie2")
+	# Ths will remove name of Serie1
+	# * chart_data.remove_serie_name("Serie1")
+	def remove_serie_name(serie_name)
+		if(!@data_description["description"][serie_name].nil?)
+			@data_description["description"].delete(serie_name)
+		end
+	end
+	# This function can be used to remove the description of a serie.
+	# This description will be written on the graph when calling the drawLegend function.
+	# Removing it's name using this function can be usefull to hide previously used series
+	
+	def remove_all_series
+		@data_description["values"].each do |v|
+			@data_description["values"] = []
+		end
+	end
+
+	# This function is used everytime you want to retrieve the Data stored in the Rdata structure
+	def get_data
+		@data
+	end
+	# This function is used everytime you want to retrieve the Data description stored in the Rdata structure 
+	def get_data_description
+		@data_description
+	end
+
+end
+

data/lib/version.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'ruby-debug'
+class Version
+	MAJOR = 1
+	MINOR = 0
+	RELEASE = 0
+	def self.current
+		"#{MAJOR}.#{MINOR}.#{RELEASE}"
+	end
+	def self.font_path
+		Gem.path.each do |gem_path|
+			path= gem_path+"/gems/rchart-#{MAJOR}.#{MINOR}.#{RELEASE}/fonts"
+			if File.exists?(path+"/tahoma.ttf")
+				return  path
+				break
+			end
+		end
+	end
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rchart'
+
+class Test::Unit::TestCase
+end

data/test/test_rchart.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestRchart < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification 
+name: rchart
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- amardaxini
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-26 00:00:00 +05:30
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-gd
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.0
+    version: 
+description: Ruby port of the slick pChart charting library
+email: amardaxini@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- examples/Point_Asterisk.png
+- examples/Point_Cd.png
+- examples/example1.rb
+- examples/example10.rb
+- examples/example11.rb
+- examples/example12.rb
+- examples/example13.rb
+- examples/example14.rb
+- examples/example15.rb
+- examples/example16.rb
+- examples/example17.rb
+- examples/example18.rb
+- examples/example19.rb
+- examples/example2.rb
+- examples/example20.rb
+- examples/example21.rb
+- examples/example3.rb
+- examples/example4.rb
+- examples/example5.rb
+- examples/example6.rb
+- examples/example7.rb
+- examples/example8.rb
+- examples/example9.rb
+- examples/logo.png
+- examples/softtones.txt
+- fonts/GeosansLight.ttf
+- fonts/MankSans.ttf
+- fonts/Silkscreen.ttf
+- fonts/pf_arma_five.ttf
+- fonts/tahoma.ttf
+- lib/rchart.rb
+- lib/rdata.rb
+- lib/version.rb
+- test/helper.rb
+- test/test_rchart.rb
+has_rdoc: true
+homepage: http://github.com/amardaxini/rchart
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: 
+- libgd-ruby, libpng-dev, libgd-dev package are required
+rubyforge_project: rchart
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Ruby port of the slick pChart charting library
+test_files: 
+- test/test_rchart.rb
+- test/helper.rb
+- examples/example20.rb
+- examples/example4.rb
+- examples/example17.rb
+- examples/example18.rb
+- examples/example9.rb
+- examples/example3.rb
+- examples/example2.rb
+- examples/example8.rb
+- examples/example6.rb
+- examples/example15.rb
+- examples/example7.rb
+- examples/example19.rb
+- examples/example12.rb
+- examples/example21.rb
+- examples/example11.rb
+- examples/example10.rb
+- examples/example1.rb
+- examples/example5.rb
+- examples/example16.rb
+- examples/example14.rb
+- examples/example13.rb