GnuplotRB is a plot generator for Ruby based on Gnuplot.

This software has been developed as a product in Google Summer of Code 2015 (GSoC2015). Its progress may be saw in SciRuby mailing list or in project’s blog.

<img src=“https://badge.fury.io/rb/gnuplotrb.svg” alt=“Gem Version” />

<img src=“https://gemnasium.com/dilcom/gnuplotrb.svg” alt=“Dependency Status” />

<img src=“https://travis-ci.org/dilcom/gnuplotrb.svg?branch=master” alt=“Build Status” /> <img src=“https://codeclimate.com/github/dilcom/gnuplotrb/badges/gpa.svg” alt=“Code quality” /> <img src=“https://codeclimate.com/github/dilcom/gnuplotrb/badges/coverage.svg” alt=“Test coverage” />

• Installation

• Examples

  • Notebooks

  • Plain examples

• Contributing

• Ruby 2.0+

• It is required to install gnuplot 5.0 to use that gem.

gem install gnuplotrb 

• add

  gem 'gnuplotrb' 

  to your Gemfile

• run

  bundle install 

git clone https://github.com/dilcom/gnuplotrb.git cd gnuplotrb bundle install rake install

This notebooks are powered by Ruby kernel for IPython/Jupyter. I placed them here to show some GnuplotRB’s capabilities and ways of using it together with iRuby.

To use GnuplotRB gem with iRuby you need to install them both.

• iRuby installation is covered in its README. It also covers installation of iPython and other dependecies.

• GnuplotRB gem installation covered in README too.

Using GnuplotRB inside iRuby notebooks is covered in:

• Basic usage notebook.

GnuplotRB is capable to plot vast range of plots from histograms to 3D heatmaps. Gem’s repository contains examples of several plot types:

• Heatmaps

• Vector field (Thanks, Alexej)

• Math equations

• 3D visualizations

• Histogram

GnuplotRB may take data in Ruby container or in a file. Supported containers for now are Arrays, Daru::Vector and Daru::DataFrame. When data given in file, GnuplotRB pass filename to Gnuplot without reading the file into memory.

Examples of using different datasources:

• Data given in file or Ruby Array

• Data given in Daru containers

• Data given in Daru containers (with timeseries)

• Updating plots with new data

You can not only plot several datasets in single coordinate system but place several coordinate systems on a canvas.

• Multiplot example notebook.

It’s possible to use several plots (Plot, Splot or Multiplot objects) to create gif animation.

• Animation example notebook.

GnuplotRB also may be used to fit some data with given math formula.

• Fitting data

You may find several examples in examples directory.

1. Fork repository

2. Create your feature branch (‘git checkout -b my-new-feature`)

3. Commit your changes (‘git commit -am ’Add some feature’‘)

4. Push to the branch (‘git push origin my-new-feature`)

5. Create a new Pull Request