mathjs 10.5.2 → 10.5.3

package/examples/complex_numbers.js

@@ -1,67 +0,0 @@
-// complex numbers
-
-// load js (using node.js)
-const { complex, add, multiply, sin, sqrt, pi, equal, sort, format } = require('..')
-
-// create a complex number with a numeric real and complex part
-console.log('create and manipulate complex numbers')
-const a = complex(2, 3)
-print(a) // 2 + 3i
-
-// read the real and complex parts of the complex number
-print(a.re) // 2
-print(a.im) // 3
-
-// clone a complex value
-const clone = a.clone()
-print(clone) // 2 + 3i
-
-// adjust the complex value
-a.re = 5
-print(a) // 5 + 3i
-
-// create a complex number by providing a string with real and complex parts
-const b = complex('3-7i')
-print(b) // 3 - 7i
-console.log()
-
-// perform operations with complex numbers
-console.log('perform operations')
-print(add(a, b)) // 8 - 4i
-print(multiply(a, b)) // 36 - 26i
-print(sin(a)) // -9.6541254768548 + 2.8416922956064i
-
-// some operations will return a complex number depending on the arguments
-print(sqrt(4)) // 2
-print(sqrt(-4)) // 2i
-console.log()
-
-// create a complex number from polar coordinates
-console.log('create complex numbers with polar coordinates')
-const c = complex({ r: sqrt(2), phi: pi / 4 })
-print(c) // 1 + i
-
-// get polar coordinates of a complex number
-const d = complex(3, 4)
-console.log(d.abs(), d.arg()) // radius = 5, phi = 0.9272952180016122
-console.log()
-
-// comparision operations
-// note that there is no mathematical ordering defined for complex numbers
-// we can only check equality. To sort a list with complex numbers,
-// the natural sorting can be used
-console.log('\ncomparision and sorting operations')
-console.log('equal', equal(a, b)) // returns false
-const values = [a, b, c]
-console.log('values:', format(values, 14)) // [5 + 3i, 3 - 7i, 1 + i]
-sort(values, 'natural')
-console.log('sorted:', format(values, 14)) // [1 + i, 3 - 7i, 5 + 3i]
-
-/**
- * Helper function to output a value in the console. Value will be formatted.
- * @param {*} value
- */
-function print (value) {
-  const precision = 14
-  console.log(format(value, precision))
-}

package/examples/expressions.js

@@ -1,188 +0,0 @@
-/**
- * Expressions can be evaluated in various ways:
- *
- * 1. using the function math.evaluate
- * 2. using the function math.parse
- * 3. using a parser. A parser contains functions evaluate and parse,
- *    and keeps a scope with assigned variables in memory
- */
-
-// load math.js (using node.js)
-const math = require('..')
-
-// 1. using the function math.evaluate
-//
-// Function `evaluate` accepts a single expression or an array with
-// expressions as first argument, and has an optional second argument
-// containing a scope with variables and functions. The scope is a regular
-// JavaScript Object. The scope will be used to resolve symbols, and to write
-// assigned variables or function.
-console.log('1. USING FUNCTION MATH.EVAL')
-
-// evaluate expressions
-console.log('\nevaluate expressions')
-print(math.evaluate('sqrt(3^2 + 4^2)')) // 5
-print(math.evaluate('sqrt(-4)')) // 2i
-print(math.evaluate('2 inch to cm')) // 5.08 cm
-print(math.evaluate('cos(45 deg)')) // 0.70711
-
-// evaluate multiple expressions at once
-console.log('\nevaluate multiple expressions at once')
-print(math.evaluate([
-  'f = 3',
-  'g = 4',
-  'f * g'
-])) // [3, 4, 12]
-
-// provide a scope (just a regular JavaScript Object)
-console.log('\nevaluate expressions providing a scope with variables and functions')
-const scope = {
-  a: 3,
-  b: 4
-}
-
-// variables can be read from the scope
-print(math.evaluate('a * b', scope)) // 12
-
-// variable assignments are written to the scope
-print(math.evaluate('c = 2.3 + 4.5', scope)) // 6.8
-print(scope.c) // 6.8
-
-// scope can contain both variables and functions
-scope.hello = function (name) {
-  return 'hello, ' + name + '!'
-}
-print(math.evaluate('hello("hero")', scope)) // "hello, hero!"
-
-// define a function as an expression
-const f = math.evaluate('f(x) = x ^ a', scope)
-print(f(2)) // 8
-print(scope.f(2)) // 8
-
-// 2. using function math.parse
-//
-// Function `math.parse` parses expressions into a node tree. The syntax is
-// similar to function `math.evaluate`.
-// Function `parse` accepts a single expression or an array with
-// expressions as first argument. The function returns a node tree, which
-// then can be compiled against math, and then evaluated against an (optional
-// scope. This scope is a regular JavaScript Object. The scope will be used
-// to resolve symbols, and to write assigned variables or function.
-console.log('\n2. USING FUNCTION MATH.PARSE')
-
-// parse an expression
-console.log('\nparse an expression into a node tree')
-const node1 = math.parse('sqrt(3^2 + 4^2)')
-print(node1.toString()) // "sqrt((3 ^ 2) + (4 ^ 2))"
-
-// compile and evaluate the compiled code
-// you could also do this in two steps: node1.compile().evaluate()
-print(node1.evaluate()) // 5
-
-// provide a scope
-console.log('\nprovide a scope')
-const node2 = math.parse('x^a')
-const code2 = node2.compile()
-print(node2.toString()) // "x ^ a"
-const scope2 = {
-  x: 3,
-  a: 2
-}
-print(code2.evaluate(scope2)) // 9
-
-// change a value in the scope and re-evaluate the node
-scope2.a = 3
-print(code2.evaluate(scope2)) // 27
-
-// 3. using function math.compile
-//
-// Function `math.compile` compiles expressions into a node tree. The syntax is
-// similar to function `math.evaluate`.
-// Function `compile` accepts a single expression or an array with
-// expressions as first argument, and returns an object with a function evaluate
-// to evaluate the compiled expression. On evaluation, an optional scope can
-// be provided. This scope will be used to resolve symbols, and to write
-// assigned variables or function.
-console.log('\n3. USING FUNCTION MATH.COMPILE')
-
-// parse an expression
-console.log('\ncompile an expression')
-const code3 = math.compile('sqrt(3^2 + 4^2)')
-
-// evaluate the compiled code
-print(code3.evaluate()) // 5
-
-// provide a scope for the variable assignment
-console.log('\nprovide a scope')
-const code4 = math.compile('a = a + 3')
-const scope3 = {
-  a: 7
-}
-code4.evaluate(scope3)
-print(scope3.a) // 10
-
-// 4. using a parser
-//
-// In addition to the static functions `math.evaluate` and `math.parse`, math.js
-// contains a parser with functions `evaluate` and `parse`, which automatically
-// keeps a scope with assigned variables in memory. The parser also contains
-// some convenience methods to get, set, and remove variables from memory.
-console.log('\n4. USING A PARSER')
-const parser = math.parser()
-
-// evaluate with parser
-console.log('\nevaluate expressions')
-print(parser.evaluate('sqrt(3^2 + 4^2)')) // 5
-print(parser.evaluate('sqrt(-4)')) // 2i
-print(parser.evaluate('2 inch to cm')) // 5.08 cm
-print(parser.evaluate('cos(45 deg)')) // 0.70710678118655
-
-// define variables and functions
-console.log('\ndefine variables and functions')
-print(parser.evaluate('x = 7 / 2')) // 3.5
-print(parser.evaluate('x + 3')) // 6.5
-print(parser.evaluate('f2(x, y) = x^y')) // f2(x, y)
-print(parser.evaluate('f2(2, 3)')) // 8
-
-// manipulate matrices
-// Note that matrix indexes in the expression parser are one-based with the
-// upper-bound included. On a JavaScript level however, math.js uses zero-based
-// indexes with an excluded upper-bound.
-console.log('\nmanipulate matrices')
-print(parser.evaluate('k = [1, 2; 3, 4]')) // [[1, 2], [3, 4]]
-print(parser.evaluate('l = zeros(2, 2)')) // [[0, 0], [0, 0]]
-print(parser.evaluate('l[1, 1:2] = [5, 6]')) // [5, 6]
-print(parser.evaluate('l')) // [[5, 6], [0, 0]]
-print(parser.evaluate('l[2, :] = [7, 8]')) // [7, 8]
-print(parser.evaluate('l')) // [[5, 6], [7, 8]]
-print(parser.evaluate('m = k * l')) // [[19, 22], [43, 50]]
-print(parser.evaluate('n = m[2, 1]')) // 43
-print(parser.evaluate('n = m[:, 1]')) // [[19], [43]]
-
-// get and set variables and functions
-console.log('\nget and set variables and function in the scope of the parser')
-const x = parser.get('x')
-console.log('x =', x) // x = 3.5
-const f2 = parser.get('f2')
-console.log('f2 =', math.format(f2)) // f2 = f2(x, y)
-const h = f2(3, 3)
-console.log('h =', h) // h = 27
-
-parser.set('i', 500)
-print(parser.evaluate('i / 2')) // 250
-parser.set('hello', function (name) {
-  return 'hello, ' + name + '!'
-})
-print(parser.evaluate('hello("hero")')) // "hello, hero!"
-
-// clear defined functions and variables
-parser.clear()
-
-/**
- * Helper function to output a value in the console. Value will be formatted.
- * @param {*} value
- */
-function print (value) {
-  const precision = 14
-  console.log(math.format(value, precision))
-}

package/examples/fractions.js

@@ -1,74 +0,0 @@
-// Fractions
-
-// load math.js (using node.js)
-const { create, all } = require('..')
-
-// configure the default type of numbers as Fractions
-const config = {
-  // Default type of number
-  // Available options: 'number' (default), 'BigNumber', or 'Fraction'
-  number: 'Fraction'
-}
-
-// create a mathjs instance with everything included
-const math = create(all, config)
-
-console.log('basic usage')
-printRatio(math.fraction(0.125)) // Fraction, 1/8
-printRatio(math.fraction(0.32)) // Fraction, 8/25
-printRatio(math.fraction('1/3')) // Fraction, 1/3
-printRatio(math.fraction('0.(3)')) // Fraction, 1/3
-printRatio(math.fraction(2, 3)) // Fraction, 2/3
-printRatio(math.fraction('0.(285714)')) // Fraction, 2/7
-console.log()
-
-console.log('round-off errors with numbers')
-print(math.add(0.1, 0.2)) // number, 0.30000000000000004
-print(math.divide(0.3, 0.2)) // number, 1.4999999999999998
-console.log()
-
-console.log('no round-off errors with fractions :)')
-print(math.add(math.fraction(0.1), math.fraction(0.2))) // Fraction, 0.3
-print(math.divide(math.fraction(0.3), math.fraction(0.2))) // Fraction, 1.5
-console.log()
-
-console.log('represent an infinite number of repeating digits')
-print(math.fraction('1/3')) // Fraction, 0.(3)
-print(math.fraction('2/7')) // Fraction, 0.(285714)
-print(math.fraction('23/11')) // Fraction, 2.(09)
-console.log()
-
-// one can work conveniently with fractions using the expression parser.
-// note though that Fractions are only supported by basic arithmetic functions
-console.log('use fractions in the expression parser')
-printRatio(math.evaluate('0.1 + 0.2')) // Fraction,  3/10
-printRatio(math.evaluate('0.3 / 0.2')) // Fraction,  3/2
-printRatio(math.evaluate('23 / 11')) // Fraction, 23/11
-console.log()
-
-// output formatting
-console.log('output formatting of fractions')
-const a = math.fraction('2/3')
-console.log(math.format(a)) // Fraction,  2/3
-console.log(math.format(a, { fraction: 'ratio' })) // Fraction,  2/3
-console.log(math.format(a, { fraction: 'decimal' })) // Fraction,  0.(6)
-console.log(a.toString()) // Fraction,  0.(6)
-console.log()
-
-/**
- * Helper function to output a value in the console.
- * Fractions will be formatted as ratio, like '1/3'.
- * @param {*} value
- */
-function printRatio (value) {
-  console.log(math.format(value, { fraction: 'ratio' }))
-}
-
-/**
- * Helper function to output a value in the console.
- * Fractions will be formatted as decimal, like '0.(3)'.
- * @param {*} value
- */
-function print (value) {
-  console.log(math.format(value, { fraction: 'decimal' }))
-}

package/examples/import.js

@@ -1,95 +0,0 @@
-/**
- * Math.js can easily be extended with functions and variables using the
- * `import` function. The function `import` accepts a module name or an object
- * containing functions and variables.
- */
-
-// load math.js (using node.js)
-const { create, all } = require('..')
-const math = create(all)
-
-/**
- * Define new functions and variables
- */
-math.import({
-  myConstant: 42,
-  hello: function (name) {
-    return 'hello, ' + name + '!'
-  }
-})
-
-// defined methods can be used in both JavaScript as well as the parser
-print(math.myConstant * 2) // 84
-print(math.hello('user')) // 'hello, user!'
-
-print(math.evaluate('myConstant + 10')) // 52
-print(math.evaluate('hello("user")')) // 'hello, user!'
-
-/**
- * Import the math library numbers.js, https://github.com/sjkaliski/numbers.js
- * The library must be installed first using npm:
- *     npm install numbers
- */
-try {
-  // load the numbers.js library
-  const numbers = require('numbers')
-
-  // import the numbers.js library into math.js
-  math.import(numbers, { wrap: true, silent: true })
-
-  if (math.fibonacci) {
-    // calculate fibonacci
-    print(math.fibonacci(7)) // 13
-    print(math.evaluate('fibonacci(7)')) // 13
-  }
-} catch (err) {
-  console.log('Warning: To use numbers.js, the library must ' +
-      'be installed first via `npm install numbers`.')
-}
-
-/**
- * Import the math library numeric.js, https://github.com/sloisel/numeric
- * The library must be installed first using npm:
- *     npm install numeric
- */
-try {
-  // load the numeric.js library
-  const numeric = require('numeric')
-
-  // import the numeric.js library into math.js
-  math.import(numeric, { wrap: true, silent: true })
-
-  if (math.eig) {
-    // calculate eigenvalues of a matrix
-    print(math.evaluate('eig([1, 2; 4, 3])').lambda.x) // [5, -1]
-
-    // solve AX = b
-    const A = math.evaluate('[1, 2, 3; 2, -1, 1; 3, 0, -1]')
-    const b = [9, 8, 3]
-    print(math.solve(A, b)) // [2, -1, 3]
-  }
-} catch (err) {
-  console.log('Warning: To use numeric.js, the library must ' +
-      'be installed first via `npm install numeric`.')
-}
-
-/**
- * By default, the function import does not allow overriding existing functions.
- * Existing functions can be overridden by specifying option `override: true`
- */
-math.import({
-  pi: 3.14
-}, {
-  override: true
-})
-
-print(math.pi) // returns 3.14 instead of 3.141592653589793
-
-/**
- * Helper function to output a value in the console. Value will be formatted.
- * @param {*} value
- */
-function print (value) {
-  const precision = 14
-  console.log(math.format(value, precision))
-}

package/examples/matrices.js

@@ -1,101 +0,0 @@
-// matrices
-
-// load math.js (using node.js)
-const math = require('..')
-
-// create matrices and arrays. a matrix is just a wrapper around an Array,
-// providing some handy utilities.
-console.log('create a matrix')
-const a = math.matrix([1, 4, 9, 16, 25])
-print(a) // [1, 4, 9, 16, 25]
-const b = math.matrix(math.ones([2, 3]))
-print(b) // [[1, 1, 1], [1, 1, 1]]
-print(b.size()) // [2, 3]
-
-// the Array data of a Matrix can be retrieved using valueOf()
-const array = a.valueOf()
-print(array) // [1, 4, 9, 16, 25]
-
-// Matrices can be cloned
-const clone = a.clone()
-print(clone) // [1, 4, 9, 16, 25]
-console.log()
-
-// perform operations with matrices
-console.log('perform operations')
-print(math.sqrt(a)) // [1, 2, 3, 4, 5]
-const c = [1, 2, 3, 4, 5]
-print(math.factorial(c)) // [1, 2, 6, 24, 120]
-console.log()
-
-// create and manipulate matrices. Arrays and Matrices can be used mixed.
-console.log('manipulate matrices')
-const d = [[1, 2], [3, 4]]
-print(d) // [[1, 2], [3, 4]]
-const e = math.matrix([[5, 6], [1, 1]])
-print(e) // [[5, 6], [1, 1]]
-
-// set a submatrix.
-// Matrix indexes are zero-based.
-e.subset(math.index(1, [0, 1]), [[7, 8]])
-print(e) // [[5, 6], [7, 8]]
-const f = math.multiply(d, e)
-print(f) // [[19, 22], [43, 50]]
-const g = f.subset(math.index(1, 0))
-print(g) // 43
-console.log()
-
-// get a sub matrix
-// Matrix indexes are zero-based.
-console.log('get a sub matrix')
-const h = math.diag(math.range(1, 4))
-print(h) // [[1, 0, 0], [0, 2, 0], [0, 0, 3]]
-print(h.subset(math.index([1, 2], [1, 2]))) // [[2, 0], [0, 3]]
-const i = math.range(1, 6)
-print(i) // [1, 2, 3, 4, 5]
-print(i.subset(math.index(math.range(1, 4)))) // [2, 3, 4]
-console.log()
-
-// resize a multi dimensional matrix
-console.log('resizing a matrix')
-const j = math.matrix()
-let defaultValue = 0
-j.resize([2, 2, 2], defaultValue)
-print(j) // [[[0, 0], [0, 0]], [[0, 0], [0, 0]]]
-print(j.size()) // [2, 2, 2]
-j.resize([2, 2])
-print(j) // [[0, 0], [0, 0]]
-print(j.size()) // [2, 2]
-console.log()
-
-// setting a value outside the matrices range will resize the matrix.
-// new elements will be initialized with zero.
-console.log('set a value outside a matrices range')
-const k = math.matrix()
-k.subset(math.index(2), 6)
-print(k) // [0, 0, 6]
-console.log()
-
-console.log('set a value outside a matrices range, setting other new entries to null')
-const m = math.matrix()
-defaultValue = null
-m.subset(math.index(2), 6, defaultValue)
-print(m) // [null, null, 6]
-console.log()
-
-// create ranges
-console.log('create ranges')
-print(math.range(1, 6)) // [1, 2, 3, 4, 5]
-print(math.range(0, 18, 3)) // [0, 3, 6, 9, 12, 15]
-print(math.range('2:-1:-3')) // [2, 1, 0, -1, -2]
-print(math.factorial(math.range('1:6'))) // [1, 2, 6, 24, 120]
-console.log()
-
-/**
- * Helper function to output a value in the console. Value will be formatted.
- * @param {*} value
- */
-function print (value) {
-  const precision = 14
-  console.log(math.format(value, precision))
-}

package/examples/objects.js

@@ -1,35 +0,0 @@
-// objects
-
-// load math.js (using node.js)
-const { evaluate, format } = require('..')
-
-// create an object. Keys can be symbols or strings
-print(evaluate('{x: 2 + 1, y: 4}')) // {"x": 3, "y": 4}
-print(evaluate('{"name": "John"}')) // {"name": "John"}
-
-// create an object containing an object
-print(evaluate('{a: 2, b: {c: 3, d: 4}}')) // {"a": 2, "b": {"c": 3, "d": 4}}
-
-const scope = {
-  obj: {
-    prop: 42
-  }
-}
-
-// retrieve properties using dot notation or bracket notation
-print(evaluate('obj.prop', scope)) // 42
-print(evaluate('obj["prop"]', scope)) // 42
-
-// set properties (returns the whole object, not the property value!)
-print(evaluate('obj.prop = 43', scope)) // 43
-print(evaluate('obj["prop"] = 43', scope)) // 43
-print(scope.obj) // {"prop": 43}
-
-/**
- * Helper function to output a value in the console. Value will be formatted.
- * @param {*} value
- */
-function print (value) {
-  const precision = 14
-  console.log(format(value, precision))
-}

package/examples/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}

package/examples/serialization.js

@@ -1,16 +0,0 @@
-// load math.js (using node.js)
-const { complex, replacer, reviver, typeOf } = require('..')
-
-// serialize a math.js data type into a JSON string
-// the replacer function is needed to correctly stringify a value like Infinity
-const x = complex('2+3i')
-const str1 = JSON.stringify(x, replacer)
-console.log(str1)
-// outputs {"mathjs":"Complex","re":2,"im":3}
-
-// deserialize a JSON string into a math.js data type
-// note that the reviver of math.js is needed for this:
-const str2 = '{"mathjs":"Unit","value":5,"unit":"cm"}'
-const y = JSON.parse(str2, reviver)
-console.log(typeOf(y)) // 'Unit'
-console.log(y.toString()) // 5 cm

package/examples/sparse_matrices.js

@@ -1,19 +0,0 @@
-// load math.js (using node.js)
-const { identity, multiply, transpose, complex } = require('..')
-
-// create a sparse matrix
-console.log('creating a 1000x1000 sparse matrix...')
-const a = identity(1000, 1000, 'sparse')
-
-// do operations with a sparse matrix
-console.log('doing some operations on the sparse matrix...')
-const b = multiply(a, a)
-const c = multiply(b, complex(2, 2))
-const d = transpose(c)
-const e = multiply(d, a)
-console.log('size(e)=', e.size())
-
-// we will not print the output, but doing the same operations
-// with a dense matrix are very slow, try it for yourself.
-console.log('already done')
-console.log('now try this with a dense matrix :)')