An open API service indexing awesome lists of open source software.

https://github.com/athityakumar/ruby-chem-eqn

A tool that can read & balance chemical equations
https://github.com/athityakumar/ruby-chem-eqn

Last synced: 5 days ago
JSON representation

A tool that can read & balance chemical equations

Awesome Lists containing this project

README

          

CHEM-EQN [![forthebadge](http://forthebadge.com/images/badges/built-with-ruby.svg)](http://forthebadge.com)
--------
Chem-Eqn is a tool that will be able to read through & balance chemical equations.

TO-DO LIST
----------

- [x] Segregate reactants & products
- [x] Extract elements from reactants & products
- [x] Extract stotchiometric coefficient of each element from each reactant & product
- [x] Segregate same element in multiple products
- [x] Support for () , such as radicals like (OH)- as in Fe(OH)3.
- [x] Support for multiple () within a compound such as a hypothetical compound like Al(SO4(OH)2)3
- [ ] Support for [] , such as complexes like K4[Fe(CN)6]
- [ ] Support for + and - , such as H+ / OH-
- [ ] Support database of common names , such as Benzene => C6H6
- [ ] Balancing simple equations
- [ ] Balancing equations involving disproportion , complex compounds , ions
- [ ] Check if equation is valid, with database of elements, compounds & sample reactions

USING CHEM-EQN
-----------------
Type these commands on a terminal -

(1) `git clone git@github.com:athityakumar/ruby-chem-eqn.git`

(2) `cd ruby-chem-eqn`

(3) `ruby main.rb`

CONTRIBUTION
------------
The work flow is the same as that of any other repository.

(1) Fork / clone the repository.

(2) Create a new branch , say `my-changes` and make your changes in this branch.

(3) Commit your changes and send a Pull request (PR) to this repository.

Active contributors would be rewarded with the tag of "Collabrators"

Bug fixes , Issues , Issue solutions , Optimizations & Enhancements are always welcome.

LICENSE
-------
The MIT License - [Athitya Kumar](http://github.com/athityakumar) - All Rights Reserved.