🧪 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 tog/mol
. Available options areg/mol
(Grams per mole);kg/mol
(Kilograms per mole);Da
(Daltons);amu
(Atomic mass unit) oru
(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.
👨⚖️ License
chemymass by EEHoveckis is licensed under a Creative Commons Attribution 4.0 International License.
Permissions beyond the scope of this license may be available on request.