https://github.com/andrejewski/periodic-table
Periodic elements data
https://github.com/andrejewski/periodic-table
chemistry element javascript periodic-elements science
Last synced: 6 months ago
JSON representation
Periodic elements data
- Host: GitHub
- URL: https://github.com/andrejewski/periodic-table
- Owner: andrejewski
- License: isc
- Created: 2015-03-15T21:26:25.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-12-11T12:06:13.000Z (almost 4 years ago)
- Last Synced: 2025-03-30T05:08:16.546Z (6 months ago)
- Topics: chemistry, element, javascript, periodic-elements, science
- Language: JavaScript
- Homepage:
- Size: 76.2 KB
- Stars: 151
- Watchers: 14
- Forks: 96
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Periodic Table
===
This package is a wrapper for a dataset of periodic elements. These elements were taken from a modified [Penn State CS class](http://php.scripts.psu.edu/djh300/cmpsc221/p3s11-pt-data.htm) CSV file, transformed into JSON, and then wrapped in some pretty JavaScript accessors.
```bash
npm install periodic-table
```
## Usage
```js
var pt = require('periodic-table');
// entire dataset
var allElements = pt.all();
// single elements by name
var he = pt.elements.Helium;
// single elements by symbol
var he = pt.symbols.He;
// single elements by atomic number
var he = pt.numbers[2];
var util = require('periodic-table/util');
// atomic mass of molecule
// atomicMass("[Element][Number] [Element][Number] ...")
// parenthesis around elements not supported..yet
var waterMass = util.atomicMass("H2 O");
var organicMass = util.atomicMass("C12 H22 O11");
```
## Sample data
```js
{ atomicNumber: 1,
symbol: 'H',
name: 'Hydrogen',
atomicMass: '1.00794(4)',
cpkHexColor: 'FFFFFF',
electronicConfiguration: '1s1',
electronegativity: 2.2,
atomicRadius: 37,
ionRadius: '',
vanDelWaalsRadius: 120,
ionizationEnergy: 1312,
electronAffinity: -73,
oxidationStates: '-1, 1',
standardState: 'gas',
bondingType: 'diatomic',
meltingPoint: 14,
boilingPoint: 20,
density: 0.0899,
groupBlock: 'nonmetal',
yearDiscovered: 1766
}
```
## Contributing
Is any table information wrong? Does some field need to be added or better formatted? Is there a more reliable source of information to work with? Open an issue or be even cooler and open a pull-request.
```bash
# running tests
npm run test
```
Follow me on [Twitter](https://twitter.com/compooter) for updates or just for the lolz and please check out my other [repositories](https://github.com/andrejewski) if I have earned it. I thank you for reading.