mathjs 10.0.0 → 10.6.4

package/docs/reference/functions/import.md

@@ -1,68 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function import
-
-Import functions from an object or a module.
-
-This function is only available on a mathjs instance created using `create`.
-
-
-## Syntax
-
-```js
-math.import(functions)
-math.import(functions, options)
-```
-
-### Where
-
-- `functions: Object`
-  An object with functions or factories to be imported.
-- `options: Object` An object with import options. Available options:
-  - `override: boolean`
-    If true, existing functions will be overwritten. False by default.
-  - `silent: boolean`
-    If true, the function will not throw errors on duplicates or invalid
-    types. False by default.
-  - `wrap: boolean`
-    If true, the functions will be wrapped in a wrapper function
-    which converts data types like Matrix to primitive data types like Array.
-    The wrapper is needed when extending math.js with libraries which do not
-    support these data type. False by default.
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`functions` | Object &#124; Array | Object with functions to be imported.
-`options` | Object | Import options.
-
-## Examples
-
-```js
-import { create, all } from 'mathjs'
-import * as numbers from 'numbers'
-
-// create a mathjs instance
-const math = create(all)
-
-// define new functions and variables
-math.import({
-  myvalue: 42,
-  hello: function (name) {
-    return 'hello, ' + name + '!'
-  }
-})
-
-// use the imported function and variable
-math.myvalue * 2               // 84
-math.hello('user')             // 'hello, user!'
-
-// import the npm module 'numbers'
-// (must be installed first with `npm install numbers`)
-math.import(numbers, {wrap: true})
-
-math.fibonacci(7) // returns 13
-```
-
-

package/docs/reference/functions/index.md

@@ -1,55 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function index
-
-Create an index. An Index can store ranges having start, step, and end
-for multiple dimensions.
-Matrix.get, Matrix.set, and math.subset accept an Index as input.
-
-
-## Syntax
-
-```js
-math.index(range1, range2, ...)
-```
-
-### Where
-
-- A number
-- A string for getting/setting an object property
-- An instance of `Range`
-- A one-dimensional Array or a Matrix with numbers
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`ranges` | ...* | Zero or more ranges or numbers.
-
-### Returns
-
-Type | Description
----- | -----------
-Index | Returns the created index
-
-
-## Examples
-
-```js
-const b = [1, 2, 3, 4, 5]
-math.subset(b, math.index([1, 2, 3]))     // returns [2, 3, 4]
-
-const a = math.matrix([[1, 2], [3, 4]])
-a.subset(math.index(0, 1))             // returns 2
-```
-
-
-## See also
-
-[bignumber](bignumber.md),
-[boolean](boolean.md),
-[complex](complex.md),
-[matrix](matrix.md),
-[number](number.md),
-[string](string.md),
-[unit](unit.md)

package/docs/reference/functions/intersect.md

@@ -1,44 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function intersect
-
-Calculates the point of intersection of two lines in two or three dimensions
-and of a line and a plane in three dimensions. The inputs are in the form of
-arrays or 1 dimensional matrices. The line intersection functions return null
-if the lines do not meet.
-
-Note: Fill the plane coefficients as `x + y + z = c` and not as `x + y + z + c = 0`.
-
-
-## Syntax
-
-```js
-math.intersect(endPoint1Line1, endPoint2Line1, endPoint1Line2, endPoint2Line2)
-math.intersect(endPoint1, endPoint2, planeCoefficients)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`w` | Array &#124; Matrix | Co-ordinates of first end-point of first line
-`x` | Array &#124; Matrix | Co-ordinates of second end-point of first line
-`y` | Array &#124; Matrix | Co-ordinates of first end-point of second line OR Co-efficients of the plane's equation
-`z` | Array &#124; Matrix | Co-ordinates of second end-point of second line OR undefined if the calculation is for line and plane
-
-### Returns
-
-Type | Description
----- | -----------
-Array | Returns the point of intersection of lines/lines-planes
-
-
-## Examples
-
-```js
-math.intersect([0, 0], [10, 10], [10, 0], [0, 10])              // Returns [5, 5]
-math.intersect([0, 0, 0], [10, 10, 0], [10, 0, 0], [0, 10, 0])  // Returns [5, 5, 0]
-math.intersect([1, 0, 1],  [4, -2, 2], [1, 1, 1, 6])            // Returns [7, -4, 3]
-```
-
-

package/docs/reference/functions/inv.md

@@ -1,39 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function inv
-
-Calculate the inverse of a square matrix.
-
-
-## Syntax
-
-```js
-math.inv(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; Complex &#124; Array &#124; Matrix | Matrix to be inversed
-
-### Returns
-
-Type | Description
----- | -----------
-number &#124; Complex &#124; Array &#124; Matrix | The inverse of `x`.
-
-
-## Examples
-
-```js
-math.inv([[1, 2], [3, 4]])  // returns [[-2, 1], [1.5, -0.5]]
-math.inv(4)                 // returns 0.25
-1 / 4                       // returns 0.25
-```
-
-
-## See also
-
-[det](det.md),
-[transpose](transpose.md)

package/docs/reference/functions/isInteger.md

@@ -1,49 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isInteger
-
-Test whether a value is an integer number.
-The function supports `number`, `BigNumber`, and `Fraction`.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isInteger(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Fraction &#124; Array &#124; Matrix | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` contains a numeric, integer value. Throws an error in case of an unknown data type.
-
-
-## Examples
-
-```js
-math.isInteger(2)                     // returns true
-math.isInteger(0)                     // returns true
-math.isInteger(0.5)                   // returns false
-math.isInteger(math.bignumber(500))   // returns true
-math.isInteger(math.fraction(4))      // returns true
-math.isInteger('3')                   // returns true
-math.isInteger([3, 0.5, -2])          // returns [true, false, true]
-math.isInteger(math.complex('2-4i')   // throws an error
-```
-
-
-## See also
-
-[isNumeric](isNumeric.md),
-[isPositive](isPositive.md),
-[isNegative](isNegative.md),
-[isZero](isZero.md)

package/docs/reference/functions/isNaN.md

@@ -1,50 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isNaN
-
-Test whether a value is NaN (not a number).
-The function supports types `number`, `BigNumber`, `Fraction`, `Unit` and `Complex`.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isNaN(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Fraction &#124; Unit &#124; Array &#124; Matrix | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` is NaN. Throws an error in case of an unknown data type.
-
-
-## Examples
-
-```js
-math.isNaN(3)                     // returns false
-math.isNaN(NaN)                   // returns true
-math.isNaN(0)                     // returns false
-math.isNaN(math.bignumber(NaN))   // returns true
-math.isNaN(math.bignumber(0))     // returns false
-math.isNaN(math.fraction(-2, 5))  // returns false
-math.isNaN('-2')                  // returns false
-math.isNaN([2, 0, -3, NaN]')      // returns [false, false, false, true]
-```
-
-
-## See also
-
-[isNumeric](isNumeric.md),
-[isNegative](isNegative.md),
-[isPositive](isPositive.md),
-[isZero](isZero.md),
-[isInteger](isInteger.md)

package/docs/reference/functions/isNegative.md

@@ -1,49 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isNegative
-
-Test whether a value is negative: smaller than zero.
-The function supports types `number`, `BigNumber`, `Fraction`, and `Unit`.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isNegative(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Fraction &#124; Unit &#124; Array &#124; Matrix | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` is larger than zero. Throws an error in case of an unknown data type.
-
-
-## Examples
-
-```js
-math.isNegative(3)                     // returns false
-math.isNegative(-2)                    // returns true
-math.isNegative(0)                     // returns false
-math.isNegative(-0)                    // returns false
-math.isNegative(math.bignumber(2))     // returns false
-math.isNegative(math.fraction(-2, 5))  // returns true
-math.isNegative('-2')                  // returns true
-math.isNegative([2, 0, -3]')           // returns [false, false, true]
-```
-
-
-## See also
-
-[isNumeric](isNumeric.md),
-[isPositive](isPositive.md),
-[isZero](isZero.md),
-[isInteger](isInteger.md)

package/docs/reference/functions/isNumeric.md

@@ -1,49 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isNumeric
-
-Test whether a value is an numeric value.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isNumeric(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | * | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` is a `number`, `BigNumber`, `Fraction`, or `boolean`. Returns false for other types. Throws an error in case of unknown types.
-
-
-## Examples
-
-```js
-math.isNumeric(2)                     // returns true
-math.isNumeric('2')                   // returns false
-math.hasNumericValue('2')             // returns true
-math.isNumeric(0)                     // returns true
-math.isNumeric(math.bignumber(500))   // returns true
-math.isNumeric(math.fraction(4))      // returns true
-math.isNumeric(math.complex('2-4i')   // returns false
-math.isNumeric([2.3, 'foo', false])   // returns [true, false, true]
-```
-
-
-## See also
-
-[isZero](isZero.md),
-[isPositive](isPositive.md),
-[isNegative](isNegative.md),
-[isInteger](isInteger.md),
-[hasNumericValue](hasNumericValue.md)

package/docs/reference/functions/isPositive.md

@@ -1,51 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isPositive
-
-Test whether a value is positive: larger than zero.
-The function supports types `number`, `BigNumber`, `Fraction`, and `Unit`.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isPositive(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Fraction &#124; Unit &#124; Array &#124; Matrix | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` is larger than zero. Throws an error in case of an unknown data type.
-
-
-## Examples
-
-```js
-math.isPositive(3)                     // returns true
-math.isPositive(-2)                    // returns false
-math.isPositive(0)                     // returns false
-math.isPositive(-0)                    // returns false
-math.isPositive(0.5)                   // returns true
-math.isPositive(math.bignumber(2))     // returns true
-math.isPositive(math.fraction(-2, 5))  // returns false
-math.isPositive(math.fraction(1,3))    // returns false
-math.isPositive('2')                   // returns true
-math.isPositive([2, 0, -3])            // returns [true, false, false]
-```
-
-
-## See also
-
-[isNumeric](isNumeric.md),
-[isZero](isZero.md),
-[isNegative](isNegative.md),
-[isInteger](isInteger.md)

package/docs/reference/functions/isPrime.md

@@ -1,48 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isPrime
-
-Test whether a value is prime: has no divisors other than itself and one.
-The function supports type `number`, `bignumber`.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isPrime(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Array &#124; Matrix | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` is larger than zero. Throws an error in case of an unknown data type.
-
-
-## Examples
-
-```js
-math.isPrime(3)                     // returns true
-math.isPrime(-2)                    // returns false
-math.isPrime(0)                     // returns false
-math.isPrime(-0)                    // returns false
-math.isPrime(0.5)                   // returns false
-math.isPrime('2')                   // returns true
-math.isPrime([2, 17, 100])           // returns [true, true, false]
-```
-
-
-## See also
-
-[isNumeric](isNumeric.md),
-[isZero](isZero.md),
-[isNegative](isNegative.md),
-[isInteger](isInteger.md)

package/docs/reference/functions/isZero.md

@@ -1,53 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function isZero
-
-Test whether a value is zero.
-The function can check for zero for types `number`, `BigNumber`, `Fraction`,
-`Complex`, and `Unit`.
-
-The function is evaluated element-wise in case of Array or Matrix input.
-
-
-## Syntax
-
-```js
-math.isZero(x)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Complex &#124; Fraction &#124; Unit &#124; Array &#124; Matrix | Value to be tested
-
-### Returns
-
-Type | Description
----- | -----------
-boolean | Returns true when `x` is zero. Throws an error in case of an unknown data type.
-
-
-## Examples
-
-```js
-math.isZero(0)                     // returns true
-math.isZero(2)                     // returns false
-math.isZero(0.5)                   // returns false
-math.isZero(math.bignumber(0))     // returns true
-math.isZero(math.fraction(0))      // returns true
-math.isZero(math.fraction(1,3))    // returns false
-math.isZero(math.complex('2 - 4i') // returns false
-math.isZero(math.complex('0i')     // returns true
-math.isZero('0')                   // returns true
-math.isZero('2')                   // returns false
-math.isZero([2, 0, -3]')           // returns [false, true, false]
-```
-
-
-## See also
-
-[isNumeric](isNumeric.md),
-[isPositive](isPositive.md),
-[isNegative](isNegative.md),
-[isInteger](isInteger.md)

package/docs/reference/functions/kldivergence.md

@@ -1,35 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function kldivergence
-
-Calculate the Kullback-Leibler (KL) divergence  between two distributions
-
-
-## Syntax
-
-```js
-math.kldivergence(x, y)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`q` | Array &#124; Matrix | First vector
-`p` | Array &#124; Matrix | Second vector
-
-### Returns
-
-Type | Description
----- | -----------
-number | Returns distance between q and p
-
-
-## Examples
-
-```js
-math.kldivergence([0.7,0.5,0.4], [0.2,0.9,0.5])   //returns 0.24376698773121153
-
-```
-
-

package/docs/reference/functions/kron.md

@@ -1,47 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function kron
-
-Calculates the kronecker product of 2 matrices or vectors.
-
-NOTE: If a one dimensional vector / matrix is given, it will be
-wrapped so its two dimensions.
-See the examples.
-
-
-## Syntax
-
-```js
-math.kron(x, y)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | Array &#124; Matrix | First vector
-`y` | Array &#124; Matrix | Second vector
-
-### Returns
-
-Type | Description
----- | -----------
-Array &#124; Matrix | Returns the kronecker product of `x` and `y`
-
-
-## Examples
-
-```js
-math.kron([[1, 0], [0, 1]], [[1, 2], [3, 4]])
-// returns [ [ 1, 2, 0, 0 ], [ 3, 4, 0, 0 ], [ 0, 0, 1, 2 ], [ 0, 0, 3, 4 ] ]
-
-math.kron([1,1], [2,3,4])
-// returns [ [ 2, 3, 4, 2, 3, 4 ] ]
-```
-
-
-## See also
-
-[multiply](multiply.md),
-[dot](dot.md),
-[cross](cross.md)

package/docs/reference/functions/larger.md

@@ -1,54 +0,0 @@
-<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->
-
-# Function larger
-
-Test whether value x is larger than y.
-
-The function returns true when x is larger than y and the relative
-difference between x and y is larger than the configured epsilon. The
-function cannot be used to compare values smaller than approximately 2.22e-16.
-
-For matrices, the function is evaluated element wise.
-Strings are compared by their numerical value.
-
-
-## Syntax
-
-```js
-math.larger(x, y)
-```
-
-### Parameters
-
-Parameter | Type | Description
---------- | ---- | -----------
-`x` | number &#124; BigNumber &#124; Fraction &#124; boolean &#124; Unit &#124; string &#124; Array &#124; Matrix | First value to compare
-`y` | number &#124; BigNumber &#124; Fraction &#124; boolean &#124; Unit &#124; string &#124; Array &#124; Matrix | Second value to compare
-
-### Returns
-
-Type | Description
----- | -----------
-boolean &#124; Array &#124; Matrix | Returns true when the x is larger than y, else returns false
-
-
-## Examples
-
-```js
-math.larger(2, 3)             // returns false
-math.larger(5, 2 + 2)         // returns true
-
-const a = math.unit('5 cm')
-const b = math.unit('2 inch')
-math.larger(a, b)             // returns false
-```
-
-
-## See also
-
-[equal](equal.md),
-[unequal](unequal.md),
-[smaller](smaller.md),
-[smallerEq](smallerEq.md),
-[largerEq](largerEq.md),
-[compare](compare.md)