Skip to main content

Chemical formula parser

Project description

chemparse

Authors: Grayson Boyer and Victor Ignatenko

A lightweight package for parsing chemical formula strings into python dictionaries.

Features

  • Convert a chemical formula string into a python dictionary.
    • example: "CH4" returns {"C":1.0, "H":4.0}
  • Handles fractional stoichiometry.
    • example: "C1.5O3" returns {"C":1.5, "O":3.0}
    • example: "H2e-1O1e-1" returns {"H":0.2, "O":0.1}
  • Handles groups with parentheses.
    • example: "(CH3)2(CH2)4" returns {"C":6.0, "H":14.0}
  • New in 2024: Chemparse now handles nested paretheses!
    • example: "((CH3)2)3" returns {'C': 6, 'H': 18}
  • New in 2024: Chemparse now handles square brackets
    • example: "K4[Fe(SCN)6]" returns {'Fe': 1.0, 'K': 4.0, 'N': 6.0, 'S': 6.0, 'C': 6.0}

Installation

Install chemparse with pip:

$ pip install chemparse

Usage

Import chemparse in python and use the parse_formula function:

import chemparse

print(chemparse.parse_formula("C6H12O6"))

Contribute

Install python

Clone chemparse using git:
git clone https://github.com/gmboyer/chemparse.git

Go to the chemparse directory:
cd chemparse

Install requirements:
pip install -r requirements.txt

Now you are ready to contribute!

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

chemparse-0.3.2.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

chemparse-0.3.2-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file chemparse-0.3.2.tar.gz.

File metadata

  • Download URL: chemparse-0.3.2.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for chemparse-0.3.2.tar.gz
Algorithm Hash digest
SHA256 f46e24081f69c3bddd03447a1ab0370c286607c6b6c146b1647f6d57beb26c3d
MD5 d6779da48d88ad5674784b2996e652c3
BLAKE2b-256 1f8281118c32a309408fcbcd5fc561d8f0ba0ab6f977dc4c87fb6b62e25e1d64

See more details on using hashes here.

File details

Details for the file chemparse-0.3.2-py3-none-any.whl.

File metadata

  • Download URL: chemparse-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for chemparse-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 67169faa673f804a518fac32e3b2072ef8c0d8c9df557b2d4f385424a750d819
MD5 db0dd004b97c90e2e43f48f0d496137a
BLAKE2b-256 28ccf0a932c8a9cd00ebdadd177c4dd312dd11771ea1856b2b86f57995e6e249

See more details on using hashes here.

Supported by

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