gnuplotr 0.1

data/README.markdown

@@ -0,0 +1,34 @@
+GNUPlotr: an easy interface between Ruby and GNUPlot
+====================================================
+
+Introduction
+------------
+
+Here's a quick example:
+	
+	require "gnuplotr"
+	
+	# Instantiate
+	gp = GNUPlotr.new
+
+	# add an empty data series
+	gp.new_series :parabola
+
+	# fill the series with pairs. This creates the parabola.dat file
+	gp.fill_series(:parabola) do |series|
+	  (0..99).each do |i|
+	    series << [i, i**2]
+	  end
+	end
+
+	# enable command history recording
+	gp.record = true
+
+	# issue plotting commands, either with named data series
+	gp.plot :parabola, "using 1:2 with points"
+
+	# or with formulas. Options are collected in a string passed as second optional argument
+	gp.replot "x**2", "with lines"
+
+	# command history can be dumper and possibly saved on file to be edited or loaded again later on.
+	puts gp.dump_input

data/lib/gnuplotr.rb

@@ -0,0 +1,115 @@
+#!/usr/bin/env ruby
+# gnuplotr.rb
+
+# Created by Paolo Bosetti on 2011-02-23.
+# Copyright (c) 2011 University of Trento. All rights reserved.
+
+require "open3"
+
+class DataSeries
+  def initialize(name)
+    raise ArgumentError, "name must be a Symbol" unless name.kind_of? Symbol
+    @name = name
+    @width = nil
+    @length = 0
+    @handle = File.open("#{@name.to_s}.dat", "w")
+    @handle.puts "\# #{@name} datafile generated on #{Time.now} by GNUPlotr"
+  end
+  
+  def <<(ary)
+    @width = ary.size unless @width
+    raise ArgumentError, "record size mismatch (not #{@width})" unless ary.size == @width
+    @handle.puts(ary * "\t")
+    @length += 1
+  end
+  
+  def close
+    @handle.close
+  end
+  
+end
+
+class GNUPlotr
+  attr_accessor :gnuplot_path, :series, :record
+  def initialize(path=nil)
+    @gnuplot_path = (path || '/opt/local/bin/gnuplot')
+    raise RuntimeError, "Could not find #{@gnuplot_path}" unless File.exist? @gnuplot_path
+    @gnuplot, @stdout, @stderr = Open3.popen3(@gnuplot_path)
+    Thread.new { capture(@stdout) {|line| puts "> " + line } } 
+    Thread.new { capture(@stderr) {|line| warn ">>" + line } } 
+    @series = {}
+    @record = false
+    @record_list = []
+  end
+  
+  def new_series(name)
+    raise ArgumentError, "name must be a Symbol" unless name.kind_of? Symbol
+    @series[name] = DataSeries.new(name)
+  end
+  
+  def fill_series(name)
+    raise "Need a block" unless block_given?
+    yield @series[name]
+    @series[name].close
+  end
+    
+  def raw(message)
+    @record_list << message if @record
+    @gnuplot.puts message
+  end
+
+  def plot(arg, opts=nil)
+    _plot("plot", arg, opts)
+  end
+  
+  def replot(arg, opts=nil)
+    _plot("replot", arg, opts)  
+  end
+  
+  def dump_input
+    header = "\# Gnuplot inputfile generated on #{Time.now} by GNUPlotr\n"
+    header + @record_list * "\n"
+  end
+  
+  def reset
+    @record_list = []
+  end
+  
+  private
+  def _plot(cmd, arg, opts=nil)
+    case arg
+    when String
+      raw "#{cmd} #{arg} #{opts}"
+    when Symbol
+      raw "#{cmd} '#{arg.to_s}.dat' #{opts}"
+    else
+      raise ArgumentError
+    end
+  end
+  
+  def capture(handle, &block)
+    loop do
+      line = handle.gets.chomp
+      yield line if line =~ /^\s*\w+/ 
+    end
+  end
+end
+
+
+
+if $0 == __FILE__
+  gp = GNUPlotr.new
+  gp.new_series :parabola
+  gp.fill_series(:parabola) do |s|
+    (0..99).each do |i|
+      s << [i, i**2]
+    end
+  end
+  gp.record = true
+  gp.plot :parabola, "using 1:2"
+  gp.replot "x**2", "with linespoints"
+  gp.raw "show term"
+  gp.raw "quit()"
+  sleep 0.1 
+  puts gp.dump_input
+end

data/test.rb

@@ -0,0 +1,32 @@
+##!/usr/bin/env ruby
+# test.rb
+
+# Created by Paolo Bosetti on 2011-02-22.
+# Copyright (c) 2011 University of Trento. All rights reserved.
+
+require './lib/gnuplotr'
+
+# Instantiate
+gp = GNUPlotr.new
+
+# add an empty data series
+gp.new_series :parabola
+
+# fill the series with pairs. This creates the parabola.dat file
+gp.fill_series(:parabola) do |series|
+  (0..99).each do |i|
+    series << [i, i**2]
+  end
+end
+
+# enable command history recording
+gp.record = true
+
+# issue plotting commands, either with named data series
+gp.plot :parabola, "using 1:2 with points"
+
+# or with formulas. Options are collected in a string passed as second optional argument
+gp.replot "x**2", "with lines"
+
+# command history can be dumper and possibly saved on file to be edited or loaded again later on.
+puts gp.dump_input

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+name: gnuplotr
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: "0.1"
+platform: ruby
+authors: 
+- Paolo Bosetti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-23 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Interface between Ruby and GNUPlot
+email: paolo.bosetti@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.markdown
+- lib/gnuplotr.rb
+- test.rb
+has_rdoc: true
+homepage: http://github.com/pbosetti/gnuplotr
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: gnuplotr
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Interface between Ruby and GNUPlot, aimed at being as easy to use and as light as possible
+test_files: []
+