Skip to main content

Calculate chemical formula mass or atomic mass (g/mol), convert moles to grams and grams to moles, and calculate percentage mass for chemical or atom of interest

Project description

chemcalculator

Documentation Status codecov deploy

Overview

chemcalculator is a python package useful for chemistry for the purpose of calculating chemical formula mass in g/mol. The mole allows scientists to calculate the number of elementary entities (usually atoms or molecules) in a certain mass of a given substance. The mass of one mole of a substance is equal to that substance’s molecular weight; as for instance, the mean molecular weight of water is 18.015 atomic mass units (amu), and so one mole of water weighs 18.015 grams. This property simplifies many chemical computations. This python package will be helpful to easily calculate the chemical formula mass, convert moles to grams and vice versa, and lastly calculate the percentage mass for the atomic nature of the elements in chemistry.

This package of basic chemistry calculations is meant to supplement an existing package, ChemPy, which already handles complex calculations for primarily physical/inorganic/analytical chemistry consisting of, but not limited to, the following:

  • Solver for equilibria (including multiphase systems)
  • Numerical integration routines for chemical kinetics (ODE solver front-end)
  • Integrated rate expressions (and convenience fitting routines)
  • Relations in Physical chemistry
  • Debye-Hückel expressions
  • Arrhenius equation
  • Einstein-Smoluchowski equation
  • Properties, such as : water density as function of temperature, water permittivity as function of temperature and pressure, and water diffusivity as function of temperature

Functions

This package contains three functions. Each function will have it's own required and optional arguments.

  1. compute_mass: Calculate the mass of the atoms or chemical formula for the input chemical formula.
  2. moles_grams_converter: Convert moles to grams and convert grams to moles.
  3. percent_mass: Calculate percentage mass for the desired atom or molecule.

Installation

$ pip install chemcalculator

Usage

chemcalculator can be used as follows:

from chemcalculator.chemcalculator import compute_mass
compute_mass("H2O")
from chemcalculator.chemcalculator import moles_grams_converter
moles_grams_converter("H2O", 0.05555, "moles")
from chemcalculator.chemcalculator import percent_mass
percent_mass("H2O", "O")

Contributors

Development Lead

Contributor Name GitHub Username
Kingslin Lv Kingslin0810
Joyce Wang jo4356
Allyson Stoll datallurgy

We welcome and recognize all contributions. Please find the guide for contribution in Contributing Document.

License

chemcalculator was created by Joyce Wang, Kingslin Lv, Allyson Stoll. It is licensed under the terms of the MIT license.

Credits

This package was created with Cookiecutter and the UBC-MDS/cookiecutter-ubc-mds project template, modified from the pyOpenSci/cookiecutter-pyopensci project template and the audreyr/cookiecutter-pypackage.

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

chemcalculator-0.1.12.tar.gz (14.1 kB view details)

Uploaded Source

Built Distribution

chemcalculator-0.1.12-py3-none-any.whl (13.5 kB view details)

Uploaded Python 3

File details

Details for the file chemcalculator-0.1.12.tar.gz.

File metadata

  • Download URL: chemcalculator-0.1.12.tar.gz
  • Upload date:
  • Size: 14.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.10

File hashes

Hashes for chemcalculator-0.1.12.tar.gz
Algorithm Hash digest
SHA256 37931cb4d6ae1e1ecf2855853b749454698012ccb10842a4821d45b9bfbebb21
MD5 cd0606cd42b69acf2b4612ef27c03e70
BLAKE2b-256 7729430122743d6fb21cffe3f2d5dff8a2d72c14e816e3547a851703dc8d44b9

See more details on using hashes here.

File details

Details for the file chemcalculator-0.1.12-py3-none-any.whl.

File metadata

  • Download URL: chemcalculator-0.1.12-py3-none-any.whl
  • Upload date:
  • Size: 13.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.10

File hashes

Hashes for chemcalculator-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 ec3c90d36ba8a3647476513f9774d98a18533d742483f00110fad4b141bfaba7
MD5 8d0bdf93a1670bb61f07dd902a0fa4f7
BLAKE2b-256 f46e8921871c78983ad6a5572abe5143d8d3b2603d0560b40dc008adfe717550

See more details on using hashes here.

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