bplot 0.0.1

data/LICENSE

@@ -0,0 +1,210 @@
+Copyright (C) 2012, Daniel Carrera <dcarrera@gmail.com>
+
+BPlot is free software; you can redistribute it and/or modify it under
+the terms of the Artistic License 2.0 (reproduced below) as published
+by The Perl Foundation.
+
+http://www.perlfoundation.org/attachment/legal/artistic-2_0.txt
+
+
+		       The Artistic License 2.0
+
+	    Copyright (c) 2000-2006, The Perl Foundation.
+
+     Everyone is permitted to copy and distribute verbatim copies
+      of this license document, but changing it is not allowed.
+
+Preamble
+
+This license establishes the terms under which a given free software
+Package may be copied, modified, distributed, and/or redistributed.
+The intent is that the Copyright Holder maintains some artistic
+control over the development of that Package while still keeping the
+Package available as open source and free software.
+
+You are always permitted to make arrangements wholly outside of this
+license directly with the Copyright Holder of a given Package.  If the
+terms of this license do not permit the full use that you propose to
+make of the Package, you should contact the Copyright Holder and seek
+a different licensing arrangement. 
+
+Definitions
+
+    "Copyright Holder" means the individual(s) or organization(s)
+    named in the copyright notice for the entire Package.
+
+    "Contributor" means any party that has contributed code or other
+    material to the Package, in accordance with the Copyright Holder's
+    procedures.
+
+    "You" and "your" means any person who would like to copy,
+    distribute, or modify the Package.
+
+    "Package" means the collection of files distributed by the
+    Copyright Holder, and derivatives of that collection and/or of
+    those files. A given Package may consist of either the Standard
+    Version, or a Modified Version.
+
+    "Distribute" means providing a copy of the Package or making it
+    accessible to anyone else, or in the case of a company or
+    organization, to others outside of your company or organization.
+
+    "Distributor Fee" means any fee that you charge for Distributing
+    this Package or providing support for this Package to another
+    party.  It does not mean licensing fees.
+
+    "Standard Version" refers to the Package if it has not been
+    modified, or has been modified only in ways explicitly requested
+    by the Copyright Holder.
+
+    "Modified Version" means the Package, if it has been changed, and
+    such changes were not explicitly requested by the Copyright
+    Holder. 
+
+    "Original License" means this Artistic License as Distributed with
+    the Standard Version of the Package, in its current version or as
+    it may be modified by The Perl Foundation in the future.
+
+    "Source" form means the source code, documentation source, and
+    configuration files for the Package.
+
+    "Compiled" form means the compiled bytecode, object code, binary,
+    or any other form resulting from mechanical transformation or
+    translation of the Source form.
+
+
+Permission for Use and Modification Without Distribution
+
+(1)  You are permitted to use the Standard Version and create and use
+Modified Versions for any purpose without restriction, provided that
+you do not Distribute the Modified Version.
+
+
+Permissions for Redistribution of the Standard Version
+
+(2)  You may Distribute verbatim copies of the Source form of the
+Standard Version of this Package in any medium without restriction,
+either gratis or for a Distributor Fee, provided that you duplicate
+all of the original copyright notices and associated disclaimers.  At
+your discretion, such verbatim copies may or may not include a
+Compiled form of the Package.
+
+(3)  You may apply any bug fixes, portability changes, and other
+modifications made available from the Copyright Holder.  The resulting
+Package will still be considered the Standard Version, and as such
+will be subject to the Original License.
+
+
+Distribution of Modified Versions of the Package as Source 
+
+(4)  You may Distribute your Modified Version as Source (either gratis
+or for a Distributor Fee, and with or without a Compiled form of the
+Modified Version) provided that you clearly document how it differs
+from the Standard Version, including, but not limited to, documenting
+any non-standard features, executables, or modules, and provided that
+you do at least ONE of the following:
+
+    (a)  make the Modified Version available to the Copyright Holder
+    of the Standard Version, under the Original License, so that the
+    Copyright Holder may include your modifications in the Standard
+    Version.
+
+    (b)  ensure that installation of your Modified Version does not
+    prevent the user installing or running the Standard Version. In
+    addition, the Modified Version must bear a name that is different
+    from the name of the Standard Version.
+
+    (c)  allow anyone who receives a copy of the Modified Version to
+    make the Source form of the Modified Version available to others
+    under
+		
+	(i)  the Original License or
+
+	(ii)  a license that permits the licensee to freely copy,
+	modify and redistribute the Modified Version using the same
+	licensing terms that apply to the copy that the licensee
+	received, and requires that the Source form of the Modified
+	Version, and of any works derived from it, be made freely
+	available in that license fees are prohibited but Distributor
+	Fees are allowed.
+
+
+Distribution of Compiled Forms of the Standard Version 
+or Modified Versions without the Source
+
+(5)  You may Distribute Compiled forms of the Standard Version without
+the Source, provided that you include complete instructions on how to
+get the Source of the Standard Version.  Such instructions must be
+valid at the time of your distribution.  If these instructions, at any
+time while you are carrying out such distribution, become invalid, you
+must provide new instructions on demand or cease further distribution.
+If you provide valid instructions or cease distribution within thirty
+days after you become aware that the instructions are invalid, then
+you do not forfeit any of your rights under this license.
+
+(6)  You may Distribute a Modified Version in Compiled form without
+the Source, provided that you comply with Section 4 with respect to
+the Source of the Modified Version.
+
+
+Aggregating or Linking the Package 
+
+(7)  You may aggregate the Package (either the Standard Version or
+Modified Version) with other packages and Distribute the resulting
+aggregation provided that you do not charge a licensing fee for the
+Package.  Distributor Fees are permitted, and licensing fees for other
+components in the aggregation are permitted. The terms of this license
+apply to the use and Distribution of the Standard or Modified Versions
+as included in the aggregation.
+
+(8) You are permitted to link Modified and Standard Versions with
+other works, to embed the Package in a larger work of your own, or to
+build stand-alone binary or bytecode versions of applications that
+include the Package, and Distribute the result without restriction,
+provided the result does not expose a direct interface to the Package.
+
+
+Items That are Not Considered Part of a Modified Version 
+
+(9) Works (including, but not limited to, modules and scripts) that
+merely extend or make use of the Package, do not, by themselves, cause
+the Package to be a Modified Version.  In addition, such works are not
+considered parts of the Package itself, and are not subject to the
+terms of this license.
+
+
+General Provisions
+
+(10)  Any use, modification, and distribution of the Standard or
+Modified Versions is governed by this Artistic License. By using,
+modifying or distributing the Package, you accept this license. Do not
+use, modify, or distribute the Package, if you do not accept this
+license.
+
+(11)  If your Modified Version has been derived from a Modified
+Version made by someone other than you, you are nevertheless required
+to ensure that your Modified Version complies with the requirements of
+this license.
+
+(12)  This license does not grant you the right to use any trademark,
+service mark, tradename, or logo of the Copyright Holder.
+
+(13)  This license includes the non-exclusive, worldwide,
+free-of-charge patent license to make, have made, use, offer to sell,
+sell, import and otherwise transfer the Package with respect to any
+patent claims licensable by the Copyright Holder that are necessarily
+infringed by the Package. If you institute patent litigation
+(including a cross-claim or counterclaim) against any party alleging
+that the Package constitutes direct or contributory patent
+infringement, then this Artistic License to you shall terminate on the
+date that such litigation is filed.
+
+(14)  Disclaimer of Warranty:
+THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS
+IS' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
+NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL
+LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README

@@ -0,0 +1,102 @@
+BPlot -- A ploting module for SciRuby. It provides an API
+         familiar to Gnuplot users and to a lesser extent
+         Matlab users.
+
+                 \     /
+             \    o ^ o    /
+               \ (     ) /
+    ____________(%%%%%%%)____________
+   (     /   /  )%%%%%%%(  \   \     )
+   (___/___/__/           \__\___\___)
+      (     /  /(%%%%%%%)\  \     )
+       (__/___/ (%%%%%%%) \___\__)      A hard-working bee.
+               /(       )\
+             /   (%%%%%)   \
+                  (%%%)
+                    !
+
+SUMMARY / STATUS
+----------------
+BPlot is in ALPHA status. Two dimmensional plots seem to work
+well but they really need more testing. Surface plots and some
+other features are not implemented yet.
+
+BPlot uses Gnuplot as the plotting engine, so you need to have
+Gnuplot installed and in your PATH. BPlot lets you use straight
+Gnuplot commands, but it also borrows some useful style syntax
+from Matlab to make plotting even better.
+
+To install, I think 'gem install bplot' should do it. There are
+no pre-requisites, as BPLot can work with either NMatrix objects
+or with plain ruby arrays. That said, plotting is much easier
+with NMatrix objects.
+
+Try some of the commands below to get a feel of how it works.
+
+
+EXAMPLES: 2D PLOTS
+-------------------
+
+require 'bplot'
+
+x = [1,2,3,4,5]
+y = [1,4,9,16,25]
+z = [25,20,15,10,5]
+
+b = BPlot.new
+
+#
+# Send a raw command into Gnuplot.
+#
+b.cmd('plot sin(x) title "Plot without Ruby."')
+
+
+#
+# Gnuplot 'set' command.
+#
+b.set('xrange [0:6]')
+b.set('yrange [0:30]')
+b.set('title "Heading for the entire plot"')
+
+
+#
+# Gnuplot 'replot' command.
+#
+b.replot
+
+
+#
+# Basic plots.
+#
+b.plot(x, y)
+b.plot(x, y, 'ps 2', 'rh')
+b.plot(x, y, 'ps 2', 'rh..-', 'y = x^2')
+
+#
+# The 'with' command on the gnuplot string takes precedence.
+#
+b.plot(x, y, 'ps 2 w lp', 'rh')
+b.plot(x, y, 'ps 2 with steps', 'rh')
+
+
+#
+# Named parameters.
+#
+b.plot(x, y, :title => 'Density', :gnuplot => 'lc 3 ps 1.5 lt 4 pt 5 w lp')
+b.plot(x, y, :title => 'Density', :gnuplot => 'ps 1.5', :matlab => 'rh-')
+b.plot(x, y, :t => 'Mass', :g => 'ps 2.5', :m => 'bh--')
+
+
+#
+# Multiple data sets (need not be the same length).
+#
+b.plot(x, y, 'ps 2', 'rh-', x, z, 'ps 1.5', 'bs--')
+b.plot(x, y, 'ps 2', 'rh-', 'Quadratic', x, z, 'ps 1.5', 'bs--', 'Linear')
+
+
+# Observe that named parameters must be at the end. Hence, they only apply to the last plot.
+
+b.plot(x, y, 'ps 2', 'rh-',       'Quadratic', x, z, 'ps 1.5', 'bs--', :t => 'Linear') # OK.
+b.plot(x, y, 'ps 2', 'rh-', :t => 'Quadratic', x, z, 'ps 1.5', 'bs--',       'Linear') # ERROR.
+
+

data/lib/bplot.rb

@@ -0,0 +1,360 @@
+=begin
+BPlot -- A ploting module for SciRuby. It provides an API
+         familiar to Gnuplot users and to a lesser extent
+         Matlab users.
+
+                 \     /
+             \    o ^ o    /
+               \ (     ) /
+    ____________(%%%%%%%)____________
+   (     /   /  )%%%%%%%(  \   \     )
+   (___/___/__/           \__\___\___)
+      (     /  /(%%%%%%%)\  \     )
+       (__/___/ (%%%%%%%) \___\__)      A hard-working bee.
+               /(       )\
+             /   (%%%%%)   \
+                  (%%%)
+                    !
+
+EXAMPLES: 2D PLOTS
+-------------------
+
+require 'bplot'
+
+x = [1,2,3,4,5]
+y = [1,4,9,16,25]
+z = [25,20,15,10,5]
+
+b = BPlot.new
+
+#
+# Send a raw command into Gnuplot.
+#
+b.cmd('plot sin(x) title "Plot without Ruby."')
+
+
+#
+# Gnuplot 'set' command.
+#
+b.set('xrange [0:6]')
+b.set('yrange [0:30]')
+b.set('title "Heading for the entire plot"')
+
+
+#
+# Gnuplot 'replot' command.
+#
+b.replot
+
+
+#
+# Basic plots.
+#
+b.plot(x, y)
+b.plot(x, y, 'ps 2', 'rh')
+b.plot(x, y, 'ps 2', 'rh--', 'y = x^2')
+
+#
+# The 'with' command on the gnuplot string takes precedence.
+#
+b.plot(x, y, 'ps 2 w lp', 'rh')
+b.plot(x, y, 'ps 2 with steps', 'rh')
+
+
+#
+# Named parameters.
+#
+b.plot(x, y, :title => 'Density', :gnuplot => 'lc 3 ps 1.5 lt 4 pt 5 w lp')
+b.plot(x, y, :title => 'Density', :gnuplot => 'ps 1.5', :matlab => 'rh-')
+b.plot(x, y, :t => 'Mass', :g => 'ps 2.5', :m => 'bh--')
+
+
+#
+# Multiple data sets (need not be the same length).
+#
+b.plot(x, y, 'ps 2', 'rh-', x, z, 'ps 1.5', 'bs--')
+b.plot(x, y, 'ps 2', 'rh-', 'Quadratic', x, z, 'ps 1.5', 'bs--', 'Linear')
+
+
+# Observe that named parameters must be at the end. Hence, they only apply to the last plot.
+
+b.plot(x, y, 'ps 2', 'rh-',       'Quadratic', x, z, 'ps 1.5', 'bs--', :t => 'Linear') # OK.
+b.plot(x, y, 'ps 2', 'rh-', :t => 'Quadratic', x, z, 'ps 1.5', 'bs--',       'Linear') # ERROR.
+
+
+
+========================================
+TODO: SURFACE PLOTS
+-------------------
+
+x = N[1,2,3,4,5]
+y = x
+
+x,y = meshgrid(x,y)
+
+z = x*x + y*y
+
+b.splot(x,y,z)
+
+=end
+
+#
+# I'll document this function when I implement surface plots.
+#
+def meshgrid(x,y)
+	warn "Input to meshgrid() must be 1 dimensional" if x.dim > 1
+	warn "Input to meshgrid() must be 1 dimensional" if y.dim > 1
+	
+	xn = x.shape[0]
+	yn = y.shape[0]
+	
+	xx = NMatrix.new( [xn,xn], (0..xn-1).map { |i| x[i] } )
+	yy = NMatrix.new( [yn,yn], (0..yn-1).map { |i| y[i] } )
+	
+	return xx, yy.transpose
+end
+
+class BPlot
+	def initialize()
+		#
+		# Every instance of BPlot has its own gnuplot process.
+		#
+		@pipe = IO.popen("gnuplot","w")
+		
+		#
+		# Configure Gnuplot.
+		#
+		@pipe.puts "set terminal wxt"			# Nice GUI for plots.
+		@pipe.puts "set termoption dashed"		# Needed for 'r--', 'r.-', 'r:'
+		@pipe.puts "set termoption enhanced"	# Support superscripts + subscripts.
+	end
+	
+	#
+	# Command -- Send a raw command into Gnuplot.
+	#            Gives the user more control over Gnuplot.
+	#
+	def cmd(str)
+		@pipe.puts str
+	end
+	
+	#
+	# Settings -- Wrapper for 'set' command in Gnuplot.
+	#
+	def set(str)
+		@pipe.puts "set #{str}"
+	end
+	
+	#
+	# Replot -- Wrapper for the 'replot' command in Gnuplot.
+	#
+	def replot
+		@pipe.puts "replot"
+	end
+	
+	#
+	# 2D plotting -- Mostly like Gnuplot, but adding colours and line/point styles from Matlab.
+	#
+	def plot(*args)
+		
+		data = []
+		all_plots = ''
+		while args.length > 0
+			#
+			# NEXT PLOT
+			#
+			# First two values are the (x,y) points.
+			data << args.shift
+			data << args.shift
+			
+			# - Get the settings for this plot.
+			# - If 'args' is not empty, there is another plot.
+			this_plot, args = styles(args)
+			all_plots << this_plot
+			all_plots << ', ' if args.length > 0
+		end
+		
+		# TODO:
+		#   -   Check for both Array and NMatrix.
+		#   -   But make sure the program works without NMatrix loaded.
+		#
+		
+		#
+		# Each plot needs a separate stream of data separated by 'e' ("end").
+		#
+		nstreams = data.length / 2
+		
+		stream = (1..nstreams).map { |s|
+			x = data.shift
+			y = data.shift
+			n = x.is_a?(Array) ? x.length - 1 : x.shape[0] - 1
+			
+			(0..n).map { |i| "#{x[i]}	#{y[i]}\n" }.join + "e\n"
+		}.join
+		
+		@pipe.puts "plot #{all_plots} \n#{stream}"
+	end
+	
+	###############################
+	#
+	#  PRIVATE METHODS
+	#
+	###############################
+	
+	private
+	
+	#
+	# TODO: Can I avoid using strings here?
+	#
+	def finished(args)
+		args.length == 0 or
+					args[0].class.to_s == 'Array' or
+					args[0].class.to_s == 'NMatrix'
+	end
+	
+	#
+	# - Get all the stye information for the next plot from 'args'.
+	# - Return the styles as a string, and the remainder of 'args'.
+	#
+	def styles(args)
+		
+		g_with = ''
+		m_with = ''
+		str_index = 0
+		this_plot = " '-' "
+		while !finished(args)
+			if args[0].is_a?(String)
+				
+				g_with << gnu_with(args[0]) 		if str_index == 0
+				m_with << mat_with(args[0]) 		if str_index == 1
+				
+				this_plot << gnu_style(args.shift)	if str_index == 0
+				this_plot << mat_style(args.shift)	if str_index == 1
+				this_plot << tit_style(args.shift)	if str_index == 2
+				
+				str_index += 1
+				
+			elsif args[0].is_a?(Hash)
+				opts = args.shift
+				
+				# Gnuplot style.
+				g_with << gnu_with(opts[:g])			if opts[:g]
+				g_with << gnu_with(opts[:gn])			if opts[:gn]
+				g_with << gnu_with(opts[:gnu])			if opts[:gnu]
+				g_with << gnu_with(opts[:gnup])			if opts[:gnup]
+				g_with << gnu_with(opts[:gnupl])		if opts[:gnupl]
+				g_with << gnu_with(opts[:gnuplo])		if opts[:gnuplo]
+				g_with << gnu_with(opts[:gnuplot])		if opts[:gnuplot]
+				
+				this_plot << gnu_style(opts[:g])		if opts[:g]
+				this_plot << gnu_style(opts[:gn])		if opts[:gn]
+				this_plot << gnu_style(opts[:gnu])		if opts[:gnu]
+				this_plot << gnu_style(opts[:gnup])		if opts[:gnup]
+				this_plot << gnu_style(opts[:gnupl])	if opts[:gnupl]
+				this_plot << gnu_style(opts[:gnuplo])	if opts[:gnuplo]
+				this_plot << gnu_style(opts[:gnuplot])	if opts[:gnuplot]
+				
+				
+				# Matlab style.
+				m_with << mat_with(opts[:m])			if opts[:m]
+				m_with << mat_with(opts[:ma])			if opts[:ma]
+				m_with << mat_with(opts[:mat])			if opts[:mat]
+				m_with << mat_with(opts[:matl])			if opts[:matl]
+				m_with << mat_with(opts[:matla])		if opts[:matla]
+				m_with << mat_with(opts[:matlab])		if opts[:matlab]
+				
+				this_plot << mat_style(opts[:m])		if opts[:m]
+				this_plot << mat_style(opts[:ma])		if opts[:ma]
+				this_plot << mat_style(opts[:mat])		if opts[:mat]
+				this_plot << mat_style(opts[:matl])		if opts[:matl]
+				this_plot << mat_style(opts[:matla])	if opts[:matla]
+				this_plot << mat_style(opts[:matlab])	if opts[:matlab]
+				
+				# Title.
+				this_plot << tit_style(opts[:t])		if opts[:t]
+				this_plot << tit_style(opts[:ti])		if opts[:ti]
+				this_plot << tit_style(opts[:tit])		if opts[:tit]
+				this_plot << tit_style(opts[:titl])		if opts[:titl]
+				this_plot << tit_style(opts[:title])	if opts[:title]
+			end
+			
+		end
+		
+		
+		# - The user may insert a 'with' in the gnuplot string which conflicts with matlab.
+		# - In this case, the gnuplot string takes precdence.
+		# - If you insert the word "with" in a title inside the gnuplot string... it's your
+		#   own fault. I told you to put the title in the :title parameter.
+		
+		this_plot << g_with
+		this_plot << m_with if g_with == ''
+		
+		#
+		# If there is no title, add a blank one.
+		#
+		this_plot << " title '' " if this_plot !~ /tit/
+		
+		#
+		# Return 'this_plot' and what is left of 'args'.
+		#
+		return this_plot, args
+	end
+	
+	
+	def gnu_with(s)
+		s =~ /w/ ? s.scan(/([wW][iI]?[tT]?[hH]? +\w+)/).last.first : ''
+	end
+	def mat_with(s)
+		wp = s =~ /[xsovdph<>+*^]/ ? true : false
+		wl = s =~ /[-:.]/ ? true : false
+		
+		return " with linespoints " if wp and wl
+		return " with points "		if wp
+		return " with lines "       if wl
+	end
+	
+	def tit_style(str)
+		" title \"#{str}\" "
+	end
+	def gnu_style(str)
+		str.gsub(/([wW][iI]?[tT]?[hH]? +\w+)/, '')
+	end
+	def mat_style(mat)
+		style = '';
+		
+		# Colour:
+		style << " lc 1 " if mat =~ /r/
+		style << " lc 2 " if mat =~ /g/
+		style << " lc 3 " if mat =~ /b/
+		style << " lc 4 " if mat =~ /m/
+		style << " lc 5 " if mat =~ /c/
+		style << " lc 6 " if mat =~ /y/
+		style << " lc 7 " if mat =~ /k/
+		
+		# Line styles:
+		style << " pt 1  " if mat =~ /\+/
+		style << " pt 2  " if mat =~ /x/
+		style << " pt 3  " if mat =~ /\*/
+		style << " pt 5  " if mat =~ /s/
+		style << " pt 6  " if mat =~ /o/
+		style << " pt 9  " if mat =~ /\^/
+		style << " pt 11 " if mat =~ /v/
+		style << " pt 13 " if mat =~ /d/
+		
+		# Styles I cannot duplicate properly:
+		style << " pt 8  " if mat =~ /</
+		style << " pt 10 " if mat =~ />/
+		style << " pt 4  " if mat =~ /p/
+		style << " pt 7  " if mat =~ /h/
+		
+		# Line styles
+		style << " lt 1 " if mat =~ /-/ and mat !~ /--/ and mat !~ /\.-/ and mat !~ /\.\.-/
+		style << " lt 4 " if mat =~ /\.-/ and mat !~ /\.\.-/
+		style << " lt 5 " if mat =~ /\.\.-/
+		style << " lt 2 " if mat =~ /--/
+		style << " lt 3 " if mat =~ /:/
+		
+		return style
+	end
+end
+
+

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: bplot
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Daniel Carrera
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-07 00:00:00.000000000 Z
+dependencies: []
+description: A 2D and 3D plotting module for SciRuby that uses syntax from Gnuplot
+  and to a lesser degree Matlab.
+email: dcarrera@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README
+- LICENSE
+- lib/bplot.rb
+homepage: http://rubygems.org/gems/bplot
+licenses: []
+post_install_message: ! "***********************************************************\nWelcome
+  to BPlot: A plotting module for SciRuby!\n\n                 \\     /\n             \\
+  \   o ^ o    /\n               \\ (     ) /\n    ____________(%%%%%%%)____________\n
+  \  (     /   /  )%%%%%%%(  \\   \\     )\n   (___/___/__/           \\__\\___\\___)\n
+  \     (     /  /(%%%%%%%)\\  \\     )\n       (__/___/ (%%%%%%%) \\___\\__)     This
+  is a bee.\n               /(       )\\             I like bees.\n             /
+  \  (%%%%%)   \\\n                  (%%%)\n                    !\n\n              ***
+  WARNING ***\n\nBPlot is in ALPHA status. Two dimmensional plots seem to work\nwell
+  but they really need more testing. Surface plots and some\nother features are not
+  implemented yet.\n\nBPlot uses Gnuplot as the plotting engine, so you need to have\nGnuplot
+  installed and in your PATH. BPlot lets you use straight\nGnuplot commands, but it
+  also borrows some useful style syntax\nfrom Matlab to make plotting even better.\n\nBPlot
+  can work with either NMatrix objects or with plain Ruby\narrays. Try some of the
+  commands below to get a feel of how\nit works:\n\nrequire 'bplot'\n\nx = [1,2,3,4,5]\ny
+  = [1,4,9,16,25]\nz = [25,20,15,10,5]\n\nb = BPlot.new\n\n# Send a raw command into
+  Gnuplot.\nb.cmd('plot sin(x) title \"Plot without Ruby.\"')\n\n# Gnuplot 'set' command.\nb.set('xrange
+  [0:6]')\nb.set('yrange [0:30]')\nb.set('title \"Heading for the entire plot\"')\n\n#
+  Gnuplot 'replot' command.\nb.replot\n\n# Basic plots.\nb.plot(x, y)\nb.plot(x, y,
+  'ps 2', 'rh')\nb.plot(x, y, 'ps 2', 'rh--', 'y = x^2')\n\n# The 'with' command on
+  the gnuplot string takes precedence.\nb.plot(x, y, 'ps 2 w lp', 'rh')\nb.plot(x,
+  y, 'ps 2 with steps', 'rh')\n\n# Named parameters.\nb.plot(x, y, :title => 'Mass',
+  :gnuplot => 'ps 1.5', :matlab => 'rh-')\nb.plot(x, y, :t => 'Mass', :g => 'ps 2.5',
+  :m => 'rh-')\n\n# Multiple data sets (need not be the same length).\nb.plot(x, y,
+  'ps 2', 'rh-', x, z, 'ps 1.5', 'bs--')\nb.plot(x, y, 'ps 2', 'rh-', 'Quadratic',
+  x, z, 'ps 1.5', 'bs--', 'Linear')\n\n# Named parameters only allowed for the last
+  data set.\nb.plot(x, y, 'ps 2', 'rh-',       'Quadratic', x, z, 'ps 1.5', 'bs--',
+  :t => 'Linear') # OK.\nb.plot(x, y, 'ps 2', 'rh-', :t => 'Quadratic', x, z, 'ps
+  1.5', 'bs--',       'Linear') # ERROR.\n\n***********************************************************\n"
+rdoc_options: []
+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: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: A ploting module for SciRuby with a Gnuplot backend.
+test_files: []