@geometryzen/multivectors NPM

Geometric Algebra Multivectors For Numeric Computing

Overview

A collection of multivectors for numeric computation. A multivector is a generalization of vector and scalar quantities that is closed under multiplication.

The following geometric quantities are supported.

p is the number of space dimensions, q is the number of time dimensions.

All types have:

Cartesian coordinates
static zero (0) constant.
static one (1) constant.
static basis vector constants e.g. e1, e2, e3
Unit of measure or Dimensionless
static S.I. Unit constants e.g. kilogram, meter, second, ampere, ...
Lockable to support immutability or mutation.
Dunder methods for operator overloading (if supported by execution environment).

Documentation

https://geometryzen.github.io/multivectors

Quick Start

npm

https://www.npmjs.com/package/@geometryzen/multivectors

import {Geometric3} from '@geometryzen/multivectors'

const e1 = Geometric3.e1

Locking

The ability to lock a multivector provides both unsurprising behavior and efficiency. In general, mutability is efficient because it can be used to avoid the creation of temporary objects that must be garbage collected. On the other hand, immutability avoids surprising changes in variables, is useful for avoiding the need to explicitly clone mutable objects, and provides support for operator overloading.

Locked multivectors are not mutable; their methods create new instances which are also locked.
Unlocked multivector methods may modify the target.
All static constants are locked.
Multivectors may be cloned to create unlocked instances.
Locking returns a token that may be used to unlock later.
Dunder methods for operator overloading never change the target and create new locked instances.