Contents

[![Gem Version](https://badge.fury.io/rb/equation_system.svg)](http://badge.fury.io/rb/equation_system)
[![Build Status](https://travis-ci.org/R167/equation_system.svg)](https://travis-ci.org/R167/equation_system)

# EquationSystem

This gem will generate a system of equations up to an arbitrary size.

## Installation

Add this line to your application's Gemfile:

    gem 'equation_system'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install equation_system

## Usage

For ruby usage:
``` ruby
var_count = 3 # number of variables for the system of equations (required)

equation_system = EquationSystem.new(var_count, range: -10..10, allow_zero: false, failsafe: 10)
# => #<EquationSystem::System:0x007faa498...>

# Get the equations
equation_system.equations
# => ["5x + 2y + 2z = -24", "-5x - 7y - 5z = -8", "-7x - 5y - 2z = 28"]

# Get the answers
equation_system.answers
# => {:x=>-8, :y=>4, :z=>4}

# Use to get any one variable value
equation_system.solution_for_x
# => -8
```

This gem also adds the commandline tool `equation_system`.
It can return the output in the json format.
``` json
{"equations":["7x - 8y - 5z = -21","-9x - 10y - 10z = -202","6x - 8y + 4z = 52"],"variables":{"x":8,"y":4,"z":9}}
```

Call with `-h` or `--help` for the help menu
```
Usage: equation_system.rb [options]
    -v, --variables COUNT            Number of variables for the system of equations (required)
    -r, --range RANGE                Range of function given a whole number
    -j, --json                       Output in JSON
    -h, --help                       Shows this help message
```

## Contributing

1. Fork it ( https://github.com/R167/equation_system/fork )
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

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
equation_system-1.1.0	README.md