Chemsolve

Chemsolve is a library for solving and practicing chemistry problems. It's made to have easy usability while still retaining a powerful engine with functionality allowing it to tackle more complicated problems. It was designed as a tool for lower-level chemistry and problem solving as opposed to a materials science or higher-level chemistry library.

Installation

Chemsolve currently runs on Python 3.6 or higher. You can install it from PyPi via pip:

pip install chemsolve

if you want to install it directly from this repository:

git clone https://github.com/amogh7joshi/chemsolve.git
cd chemsolve
python setup.py install

Then execute:

# Install system requirements.
python3 -m pip install -r requirements.txt 

# Try it out
cd tests
python3 elementtest.py

Chemsolve makes use of the chempy library for backend stoichiometry calculations.

Using Chemsolve

Chemsolve relies heavily on an object-based framework with classes representing important objects in chemistry: elements, compounds, reactions. The structure of Chemsolve is similar to the following:

In addition, Chemsolve includes numerous features to ease chemistry calculations, available in the associated modules within Chemsolve, such as molarity and molality calculations in chemsolve.solutions and the ideal gas formula within chemsolve.gases.

Examples

Examples for all of the primary implemented structures can be found in /examples:

1. The Element Class and usage.
2. The Compound Class and usage.
3. The Reaction Class and usage.

In this example, we will use the Reaction class.

Import the required module(s):

from chemsolve import Compound, Reaction

Create the Necessary Object and its Object parameters:

# Compounds which will be reacted.
r1 = Compound("NH3", grams = 5.00)
r2 = Compound("O2", grams = 3.46)
p1 = Compound("NO2")
p2 = Compound("H2O")
reaction = Reaction(r1, r2, "-->", p1, p2)

From here, you can access the object's attributes.

print(reaction.balanced_reaction)
print(reaction.limiting_reactant)

For further reference, please visit /examples.

License

All code in this library is available under the MIT License. You are welcome to download the repository on your own and work with it, however.

Issues

If you notice an issues or bugs with the library, please feel free to create an issue. Make sure to follow the issue guidelines.

Contributions

Contributions are always welcome, and feel free to contribute to the library. Please make sure to follow the pull request guidelines.