Wave-func NPM | npm.io

Ψ Func

A TypeScript based relation to the fundimental building blocks of our reality.

I found it difficult to learn the different and difference between the fundimental particles. So I've built a strictly typed package of all of them and how they relate to each other. This is mainly because of the similarly named particles and the same suffix used for all the different types.

Install

$ yarn add wave-func

Fundimental Particles

Properties

Property	Purpose	Example value
particle.name	The name of the particle	`electron`
particle.group	The group of the particle	`fermion`
particle.type	The type (subtype) of the particle	`lepton`
particle.appliedForces	An array of forces the particle interacts with	`[ForceType.ELECTROMAGNETISM]`
particle.charge	An object of the particles charge with positive/negative values	`{value: 0.333333, state: 'negative'}`
particle.chargeForHumans	The charge value for humans	`+2/3` `-1/3`
particle.scalar	A boolean as to whether the particle is scalar	`false`
particle.antiMatter	A boolean as to whether the particle is considered antimatter	`false`
particle.mass	The overall mass of the particle in gmev	`.511`
particle.theoretical	A boolean whether the particle is proven or theoretical	`false`
particle.symbol	The particle's symbol	`e`
particle.spin	The particles spin	`"1/2"`

Below is a list of all different types of fundimental particles and some brief info.

Fermions

All particles with mass.

Quarks

name	charge	spin	anti matter
UpQuark	+2/3	1/2	false
DownQuark	-1/3	1/2	false
TopQuark	+2/3	1/2	false
BottomQuark	-1/3	1/2	false
StrangeQuark	-1/3	1/2	false
CharmQuark	+2/3	1/2	false
CharmQuark	+2/3	1/2	false
AntiUpQuark	-2/3	1/2	true
AntiDownQuark	+1/3	1/2	true
AntiTopQuark	-2/3	1/2	true
AntiBottomQuark	+1/3	1/2	true
AntiStrangeQuark	+1/3	1/2	true
AntiCharmQuark	-2/3	1/2	true
AntiCharmQuark	-2/3	1/2	true

Leptons

name	charge	spin	anti matter
Electron	-1	1/2	false
Positron	+1	1/2	true
ElectronNeutrino	0	1/2	false
ElectronAntiNeutrino	0	1/2	true
Muon	-1	1/2	false
AntiMuon	+1	1/2	true
Tau	-1	1/2	false
AntiTau	+1	1/2	true
TauNeutrino	-1	1/2	false
AntiTauNeutrino	0	1/2	true
MuonNeutrino	0	1/2	false
AntiMuonNeutrino	0	1/2	true

Bosons

'Communication' or 'transfer' particles that interact with applied forced or fermions

name	Forces	Scalar	Spin	Charge
Photon	Electromagnetic	false	1	0
Gluon	Strong force	false	1	0
ZBoson	Weak force	false	1	0
PositiveWBoson	Weak force	false	1	1
NegativeWBoson	Weak force	false	1	-1
Higgs Boson		true	0	0

import { Photon, UpQuark } from 'wave-func';

const photon = new Photo();

const up = new UpQuark();

const bosons = getBosons(up); // [Gluon, PositiveWBoson, NegativeWBoson, ZBoson]

Forces

Electromagnetic
Weak force
Strong force (chromodynamic)

Spin

The spin of a particle

Elements

The atoms of our reality

import { Oxygen } from 'wave-func';

const oxygen = new Oxygen();

console.log(oxygen.symbol, oxygen.hardons, oxygen.electrons, oxygen.electronShells, oxygen.meltingPoint, oxygen.boilingPoint)

Properties

Property	Purpose	Example value
element.electrons	The amount of electrons charged to atom. In shells	`[2, 8, 8, 2]`
element.electronShells	The number of electron shells on an atm	`4`
element.name	The name of the element from `ElementName` enum	`Calcium`
element.number	The atomic number of the element (number of protons considered neutral)	`20`
element.atomicSymbol	The symbol given to the atomic structure	`Ca`
element.symbol	The atomic symbol and the sub of the element's proton count if required	`21Ca`
element.group	The atomic group of the element	`Alkalin metals`
element.meltingPoint	The melting point of the element in kelvin	`1115`
element.boilingPoint	The boiling point of the element in kelvin	`1757`
element.hardons	An array of hardon particles in the nucleus	`[[Function Proton], [Function Neutron]]` (not a helpful example)
element.charge	The overall charge of the element (sum of proton charge, neutron charge and electron charge)	`0` `1`
element.overallChargeStatus	The overall charge of the element: positive or negative	`negative`
element.stable	A boolean of the overall atom's charge	`true`

Functions

addHardon

Adds a hardon particle to the nucleus which will change the overall atom's charge, stability and symbol output.

const element = new Oxygen();

console.log(element.symbol); // O
console.log(element.charge); // 0
console.log(element.stable); // true

element.addHardon(new Proton());

console.log(element.symbol); // 9O
console.log(element.charge); // 1
console.log(element.stable); // false

Eventually I want to be able to change the element's atomic name and prototype based on the overall protons/neutrons in the hardon array (nucleus)

Charge

import { Proton, Neutron, Carbon } from 'wave-func';

const proton = new Proton();
const neutron = new Neutron();

console.log(proton.charge); // 1
console.log(neutron.charge); // 0

const carbon = new Carbon();

console.log(carbon.charge); // 0

carbon.addHardon(new Proton());
console.log(carbon.charge); // 1

Anti matter

import { Proton, Electron, oppositeMatter } from 'wave-func';

const antiMatter = oppositeMatter(new Proton()); // AntiProton
const antiMatter = oppositeMatter(new Electron()); // Positron

Idea

import { Oxygen, Neutron, Proton } from 'wave-func';

const element = new Oxygen();

console.log(element.constructor); // [Function Oxygen]
element.addHardon(new Neutron());

console.log(element.contructor, element.symbol); // [Function Oxygen] 9O

element.addHardon(new Proton());
console.log(element.constructor, element.symbol); // [Function Fluorine] F