Skip to content

Suraporn/chembox

 
 

Repository files navigation

chembox

example workflow codecovDocumentation Status

Introduction

chembox is a package for molecular information calculator based on empirical formulas of chemicals in raw text. It is designed to intelligently process text input containing the chemical formula and provide associated information on the inquired molecule. It is able to provide the molar mass, check a formula's validity, and provide a balanced combustion equation if the input is combustible. This tool can be utilized for various educational and research purposes for simple and fast information retrieval.

We are using a dataset that contains established element data properties from this site.

Installation

chembox is developed and tested on Python 3.10. You can install it from PyPi via pip:

$ pip install chembox

Usage

The package includes 4 functions for solving chemistry problems:

  • get_elementsa parser that takes a chemical formula in string format and returns a dictionary that contains the elements and their respective count.

  • is_valid: a checker that returns a boolean indicating whether a given input is chemically reasonable.

  • get_molec_props: a method that takes a chemical formula in string format and returns a dataframe with various useful properties of each element in the formula.

  • get_combustion_equation: a method that takes a text chemical formula that only contains carbon (C) and hydrogen (H) and outputs a balanced equation resulting from combustion.

A detailed example of usage can be found here.

Dataset

In order to be able to perform some of the functions above, a dataset will need to be used that contains various atomic properties of the elements in the periodic table. The data can be found in the Chembox repo here which was sourced from here. Please note that we do not take credit for the dataset, it is merely for use with our functions.

Fitting into the Python ecosystem

A similar package chemsolve is available online that employs a similar string-parsing design and molar mass calculation.

What we do differently:

  • We include a dataframe of the molecule properties to give the user enhanced functionality and insights.

  • chemsolve accepts user-defined reactions. In our package, we include methods for automated combustion equation generation and balancing.

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

chembox is licensed under the terms of the MIT license.

Contributors

The contributors of this project are Wilfred Hass, Vikram Grewal, Luke Yang, and Nate Puangpanbut.

Credits

chembox was created with cookiecutter and the py-pkgs-cookiecutter template.

About

MDS Project : A package to analyze chemical formulas

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%