Skip to main content

A low-level chemistry library for solving and practicing chemistry problems.

Project description

Chemsolve

PyPI version Downloads License: MIT Travis (.com) Latest Commit

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 uses the chempy and periodictable libraries.

Using Chemsolve

Chemsolve relies heavily on class framework with classes representing chemical objects: elements, compounds, reactions.

Classes

Examples

Examples for all of the 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 avaliable under the MIT License.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chemsolve-1.3.0.tar.gz (12.0 kB view hashes)

Uploaded Source

Built Distribution

chemsolve-1.3.0-py3-none-any.whl (13.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page