Neoclassical Programming Multitude

# npm

## chemymass

1.0.12 • Public • Published

# 🧪 chemymass

Simple Molar Mass Calculator

## 📝 Description

chemymass - Simple molar mass calculator. Calculates molar mass for any valid formula.

## 🔧 Setup

chemymass is easy to setup, just do:

``````npm i chemymass
``````

## 📕 Usage

To require chemymass in your program do:

`const chemymass = require("chemymass");`

Ways to call chemymass from your program:

```// Standard Long Mode - Get molar mass and element percentages.
const formula = "H₂SO₄";
const precision = 3;
const units = "g/mol";
console.log(chemymass(formula, precision, units));

/* Output:
H₂SO₄:
2 H · 1.007825 = 2.016 (2.055% of mass)
1 S · 32.066 = 32.066 (32.694% of mass)
4 O · 15.9994 = 63.998 (65.251% of mass)
Total: 98.079 g/mol
*/```
```// Standard Short Mode - Get only molar mass.
const formula = "CuSO₄·5H₂O";
const precision = 7;
const units = "amu";
console.log(chemymass.short(formula, precision, units));

/* Output:
249.6848500 amu
*/```
```// Standard Verbal Mode - Get molar mass and element percentages from query.
const query = "Sugar";
const precision = 7;
const units = "Da";
chemymass.verbal(query, precision, units)
.then(output => console.log(output));

/* Output:
Sugar - C₁₂H₂₂O₁₁:
12 C · 12.011 = 144.1320000 (42.1072251% of mass)
22 H · 1.007825 = 22.1721500 (6.4774492% of mass)
11 O · 15.9994 = 175.9934000 (51.4153256% of mass)
Total: 342.2975500 Da
*/```
```// Short Verbal Mode - Get only molar mass from query.
const query = "58-08-2";
const precision = 7;
const units = "u";
chemymass.verbalShort(query, precision, units)
.then(output => console.log(output));

/* Output:
194.1918500 u
*/```

## 📰 Notes

• (^1.0.10) Crystal Hydrates work without any modifications. Formulas can be with signs `·`, `×` or `*`.

• (^1.0.11) Verbal mode supported query types: `Plain Text Name`, `CAS number`, `SMILES`, `IUPAC`, `FICTS identifier`, `Cactvs HASHISY`, `uuuuu identifier`.

• (^1.0.12) `units` is optional parameter which defaults to `g/mol`. Available options are `g/mol` (Grams per mole); `kg/mol` (Kilograms per mole); `Da` (Daltons); `amu` (Atomic mass unit) or `u` (Same as amu). Parameter must be passed as string.

• `precision` is optional parameter which defaults to 3 if not passed to function.

• This module understands both normal numbers and subscripts. You don't have to specifically convert them.

• Verbal mode is made possible by NIH NCI/CADD Group! Without their API, verbal mode probably wouldn't be a thing.

Permissions beyond the scope of this license may be available on request. ### Install

`npm i chemymass`

### Repository

github.com/EEHoveckis/chemymass

49

1.0.12