mathjs/test/function/construction/matrix.test.js

// test matrix construction
var assert = require('assert'),
    math = require('../../../index'),
    matrix = math.matrix;

describe('matrix', function() {

  it('should create an empty matrix with one dimension if called without argument', function() {
    var a = matrix();
    assert.ok(a instanceof math.type.Matrix);
    assert.deepEqual(math.size(a), matrix([0])); // TODO: wouldn't it be nicer if an empty matrix has zero dimensions?
  });

  it('should create empty matrix, dense format', function() {
    var a = matrix('dense');
    assert.ok(a instanceof math.type.Matrix);
    assert.deepEqual(math.size(a), matrix([0]));
  });
  
  it('should create empty matrix, dense format, number datatype', function() {
    var a = matrix('dense', 'number');
    assert.ok(a instanceof math.type.Matrix);
    assert.deepEqual(math.size(a), matrix([0]));
    assert(a.datatype(), 'number');
  });
  
  it('should create empty matrix, sparse', function() {
    var a = matrix('sparse');
    assert.ok(a instanceof math.type.Matrix);
  });
  
  it('should create a matrix from an array', function() {
    var b = matrix([[1,2],[3,4]]);
    assert.ok(b instanceof math.type.Matrix);
    assert.deepEqual(b, matrix([[1,2],[3,4]]));
    assert.deepEqual(math.size(b), matrix([2,2]));
  });

  it('should be the identity if called with a matrix, dense format', function() {
    var b = matrix([[1,2],[3,4]], 'dense');
    var c = matrix(b, 'dense');
    assert.ok(c._data != b._data); // data should be cloned
    assert.deepEqual(c, matrix([[1,2],[3,4]], 'dense'));
    assert.deepEqual(math.size(c), matrix([2,2], 'dense'));
  });
  
  it('should be the identity if called with a matrix, dense format, number datatype', function() {
    var b = matrix([[1,2],[3,4]], 'dense', 'number');
    var c = matrix(b, 'dense');
    assert.ok(c._data != b._data); // data should be cloned
    assert.ok(c._size != b._size);
    assert.deepEqual(c._data, b._data);
    assert.deepEqual(c._size, b._size);
    assert.ok(c.datatype() === 'number');
  });
  
  it('should be the identity if called with a matrix, sparse', function() {
    var b = matrix([[1,2],[3,4]], 'sparse');
    var c = matrix(b, 'sparse');
    assert.ok(c._values != b._values); // data should be cloned
    assert.deepEqual(c, matrix([[1,2],[3,4]], 'sparse'));
  });
  
  it('should be the identity if called with a matrix, sparse, number datatype', function() {
    var b = matrix([[1,2],[3,4]], 'sparse', 'number');
    var c = matrix(b, 'sparse');
    assert.ok(c._values != b._values); // data should be cloned
    assert.deepEqual(c.valueOf(), b.valueOf());
    assert.ok(c.datatype() === 'number');
  });

  it('should create a matrix from a range correctly', function() {
    var d = matrix(math.range(1,6));
    assert.ok(d instanceof math.type.Matrix);
    assert.deepEqual(d, matrix([1,2,3,4,5]));
    assert.deepEqual(math.size(d), matrix([5]));
  });

  it('should throw an error if called with an invalid argument', function() {
    assert.throws(function () { matrix(new Date()); }, TypeError);
  });

  it('should throw an error if called with a unit', function() {
    assert.throws(function () { matrix(math.unit('5cm')); }, TypeError);
  });

  it('should throw an error if called with too many arguments', function() {
    assert.throws(function () {matrix([], 3, 3, 7);}, /TypeError: Too many arguments/);
  });

  it('should throw an error when called with an invalid storage format', function () {
    assert.throws(function () { math.matrix([], 1); }, /Unsupported matrix storage format: 1/);
  });
  
  it('should throw an error when called with an unknown storage format', function () {
    assert.throws(function () { math.matrix([], '123'); }, /Unsupported matrix storage format: 123/);
  });

  it('should LaTeX matrix', function () {
    var expr1 = math.parse('matrix()');
    var expr2 = math.parse('matrix([1])');

    assert.equal(expr1.toTex(), '\\begin{bmatrix}\\end{bmatrix}');
    assert.equal(expr2.toTex(), '\\left(\\begin{bmatrix}1\\\\\\end{bmatrix}\\right)');
  });
});