Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/geometryzen/multivectors
Geometric Algebra Multi-Vectors For Numerical Computing
https://github.com/geometryzen/multivectors
Last synced: 9 days ago
JSON representation
Geometric Algebra Multi-Vectors For Numerical Computing
- Host: GitHub
- URL: https://github.com/geometryzen/multivectors
- Owner: geometryzen
- License: mit
- Created: 2022-09-19T20:50:47.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-03T10:44:53.000Z (8 months ago)
- Last Synced: 2024-04-11T05:12:21.480Z (7 months ago)
- Language: TypeScript
- Size: 1.8 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/@geometryzen/multivectors)
[](https://npm-stat.com/charts.html?package=@geometryzen/multivectors&from=2022-09-01)
[](./LICENSE)
[](./CONTRIBUTING.md)
# 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.
Class
p
q
Metric
Coordinates
Basis Vectors
Geometric1
1
0
Euclidean
a,x,x or b
e1
Geometric2
2
0
Euclidean
a,x,y,xy or b
e1,e2
Geometric3
3
0
Euclidean
a,x,y,z,xy,yz,zx,xyz or b
e1,e2,e3
Spacetime1
1
1
Minkowski
a,t,x,tx or b
e0,e1
Spacetime2
2
1
Minkowski
a,t,x,y,tx,ty,xy,txy or b
e0,e1,e2
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
```typescript
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.
## Distribution
### CommonJS
https://unpkg.com/@geometryzen/multivectors/dist/cjs/index.js
### ESM
https://unpkg.com/@geometryzen/multivectors/dist/esm/index.js
https://unpkg.com/@geometryzen/multivectors/dist/esm/index.min.js
### System
https://unpkg.com/@geometryzen/multivectors/dist/system/index.js
https://unpkg.com/@geometryzen/multivectors/dist/system/index.min.js
### UMD
https://unpkg.com/@geometryzen/multivectors/dist/umd/index.js
https://unpkg.com/@geometryzen/multivectors/dist/umd/index.min.js
### Type Definitions
https://unpkg.com/@geometryzen/multivectors/dist/index.d.ts
## Support
Please file issues at https://github.com/geometryzen/multivectors/issues
Copyright (c) 2022 David Geo Holmes.
This software is licensed under the MIT License.