# algebra

Vectors, Matrices, Tensors

``npm install algebra``

# algebra

Vectors, Matrices, Tensors for Node.js

# Installation

``````npm install algebra
``````

# Description

I'm implementing matrices and vectors on few algebra fields (Reals, Complexes etc.) following Micheal Artin's "Algebra", which was my book at Universita' Degli Studi di Genova.

My goal is to provide users with the feature of creating their own algebra field and building vector spaces, matrices and tensors on it.

Suppose for example the set of strings with the concatenation operator, it could be extended to a group and maybe to a field and build "matrices of strings" or probably in the future ... "strings of matrices" (I had an intuition about a composition law for UTF-8 chars).

## Features

• Algebra over Real and Complex fields
• Vectors and vector spaces
• Invertible Matrices and the General Linear Group
• Tensors
• Algebra over custom fields

## Quick start

This is a 60 seconds tutorial to get your hands dirty with `algebra`.

## Complex numbers

``````var algebra = require('algebra');

var Complex = algebra.ComplexElement;

// Create two complex numbers
// z1 = 1 + 2i
// z2 = 3 + 4i
var z1 = new Complex(1, 2);
var z2 = new Complex(3, 4);

// Multiply z1 by z2.
z1.mul(z2); // (1 + 2i) * (3 + 4i) = -5 + 10i

console.log(z1.data); // [-5, 10]

// Many chainable operators are available.
z1.conj().mul([2, 0]);

console.log(z1.data); // [-10, 20]
``````

## Vectors

``````var algebra = require('algebra');

// Rn is a class representing a real vector space of dimension = n
var Rn = algebra.RealVectorSpace;

// Create a real vector space with dimension = 2, a.k.a. the cartesian plane
var R2 = new Rn(2);

// Create two vectors
// v1 = (1, 1)
// v2 = (2, 4)
var v1 = new R2.Vector(1, 1);
var v2 = new R2.Vector(2, 4);

v1.add(v2); // (1, 1) + (2, 4) = (3, 5)

console.log(v1.data); // [3, 5]
``````

## Matrices

``````var algebra = require('algebra');

// GLnR is the Real General Linear Group of invertible matrices of order n
var GLnR = algebra.RealGeneralLinearGroup;

// Create the group of 2x2 invertible matrices
var GL2R = new GLnR(2);

// Create two invertible matrices:
//
//       | 1 2 |         | -1 0 |
//       | 3 4 |   and   |  0 1 |
//
var m1 = new GL2R.Matrix(1, 2,
3, 4);

var m2 = new GL2R.Matrix(-1, 0,
0, 1);

// Multiply m1 by m2 at right side
//       | 1 2 | * | -1 0 | = | -1 2 |
//       | 3 4 |   |  0 1 |   | -3 4 |
m1.mul(m2);

console.log(m1.data); // [1, 2, 3, 4]

// Check out m1 determinant, should be 2 = (1 * 4 - 3 * 2) * (-1 * 1 - 0 * 0)
console.log(m1.determinant.data); // 2
``````
npm loves you