/sciruby

Tools for scientific computation in Ruby/Rails

Primary LanguageRubyOtherNOASSERTION

SciRuby

Tools for Scientific Computing in Ruby

Description

Ruby has for some time had no equivalent to the beautifully constructed numpy, scipy, and matplotlib libraries for Python. We believe that the time for a Ruby science and visualization package has come and gone. Sometimes when a solution of sugar and water becomes super-saturated, from it precipitates a pure, delicious, and diabetes-inducing crystal of sweetness, induced by no more than the tap of a finger. So it is, we believe, with the need for numeric and visualization libraries in Ruby.

We are not the first with this idea, but we are trying to bring it to life.

A note about repositories

Most of the work right now is happening in NMatrix. If you want to help out, you should check out either mohawkjohn’s or chriswailes’ fork of NMatrix, not this one.

Updates only happen in the main repository when a feature becomes stable. The project activity log may be misleading.

Features

SYNOPSIS:

From the command line,

sciruby-plotter my_plot.rb

Or, inside a Ruby shell,

$ require 'sciruby'

Installation

For a more complete tutorial, with fixes for the most common errors, read the installation page on our wiki.

There are some libraries and gems you’ll need to install before using SciRuby, e.g. green_shoes. If you’re in Ubuntu:

sudo apt-get install libgtk2.0-dev libgtksourceview2.0-dev librsvg2-dev libcairo2-dev

Then, you just install sciruby as a gem:

gem install sciruby

You can also optionally get rb-gsl, statistics2, and other useful architecture-specific packages using

gem install statsample-optimization

Note that as of this writing, rb-gsl is incompatible with the 1.15 version of the GSL headers. You should make sure you’re using the 1.14 headers.

At the moment, *there’s a problem* with this setup: NMatrix is incompatible with the rb-gsl gem, which it makes impossible to use SciRuby as a whole, but you’re able to use the subprojects independently. We’re working on a fix for it in this repository.

Developers

Read the instructions in CONTRIBUTING.md if you want to help.

Warning

Please be aware that SciRuby is in ALPHA status. If you’re thinking of using SciRuby to write mission critical code, such as for driving a car or flying a space shuttle, you may wish to choose other software (for now).

License

Copyright © 2010 - 2013, The Ruby Science Foundation.

All rights reserved.

SciRuby is licensed under the BSD 2-clause license. See LICENSE.txt for details.

Donations

Support a SciRuby Fellow:

<img src=http://pledgie.com/campaigns/15783.png?skin_name=chrome>