a-stickan / chemical-equation-autobalancer

Automatically balances chemical equations using C++ and linear algebra

Chemical Equation Autobalancer

• Greatly simplifies the process of balancing chemical formulas through the use of C++ and linear algebra
• A console GUI provided on the latest release, making running the program simple and easy for beginners
• For more advanced users, the single header library ("Balancer.h") has a great variety of functions in the "linear" namespace that can be used to easily enhance any chemistry-based project or repo

How it works (GUI)

• Enter your chemical equation like in the example below

B2S3 + H2O ---> H3BO3 + H2S

• In a few seconds, your balanced equation will be output to the screen

1.000000B2S3 + 2.000000H2O ---> 6.000000H3BO3 + 3.000000H2S

Basic Documentation

• std::vector<std::vector> rref(std::vector<std::vector> matrix)

Converts any inputted 2D square vector matrix into its reduced row echelon form which is then returned (the result technically isn't in true RREF, moving the pivot rows into the correct diagonal formation would cause some issues with the later calculations).

• std::vector doubleToInt(std::vector<std::vector> matrix)

Gets the long double solution values in a RREF matrix to integer values (or at least fairly close). Returns the solution set of of the RREF matrix with the integer approximations.

• std::vector<std::vector> matrixInitializer(std::string input)

Creates and returns a 2D square vector matrix that fits the inputted chemical reaction in question. Each compound occupies a column, each unique element occupies a row.

• std::string stoichSolver(std::string manual_input = "")

Pieces together many of the functions to give the user their solved chemical equation as a string. If avoiding using the GUI, a chemical equation can be entered as a parameter.