mathjs 8.1.0 → 12.2.1

package/lib/cjs/expression/embeddedDocs/function/logical/xor.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.xorDocs = void 0;
-var xorDocs = {
+var xorDocs = exports.xorDocs = {
   name: 'xor',
   category: 'Logical',
   syntax: ['x xor y', 'xor(x, y)'],
   description: 'Logical exclusive or, xor. Test whether one and only one value is defined with a nonzero/nonempty value.',
   examples: ['true xor false', 'false xor false', 'true xor true', '0 xor 4'],
   seealso: ['not', 'and', 'or']
-};
-exports.xorDocs = xorDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/column.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.columnDocs = void 0;
-var columnDocs = {
+var columnDocs = exports.columnDocs = {
   name: 'column',
   category: 'Matrix',
   syntax: ['column(x, index)'],
   description: 'Return a column from a matrix or array.',
   examples: ['A = [[1, 2], [3, 4]]', 'column(A, 1)', 'column(A, 2)'],
-  seealso: ['row']
-};
-exports.columnDocs = columnDocs;
+  seealso: ['row', 'matrixFromColumns']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/concat.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.concatDocs = void 0;
-var concatDocs = {
+var concatDocs = exports.concatDocs = {
   name: 'concat',
   category: 'Matrix',
   syntax: ['concat(A, B, C, ...)', 'concat(A, B, C, ..., dim)'],
   description: 'Concatenate matrices. By default, the matrices are concatenated by the last dimension. The dimension on which to concatenate can be provided as last argument.',
   examples: ['A = [1, 2; 5, 6]', 'B = [3, 4; 7, 8]', 'concat(A, B)', 'concat(A, B, 1)', 'concat(A, B, 2)'],
   seealso: ['det', 'diag', 'identity', 'inv', 'ones', 'range', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.concatDocs = concatDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/count.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.countDocs = void 0;
+var countDocs = exports.countDocs = {
+  name: 'count',
+  category: 'Matrix',
+  syntax: ['count(x)'],
+  description: 'Count the number of elements of a matrix, array or string.',
+  examples: ['a = [1, 2; 3, 4; 5, 6]', 'count(a)', 'size(a)', 'count("hello world")'],
+  seealso: ['size']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/cross.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.crossDocs = void 0;
-var crossDocs = {
+var crossDocs = exports.crossDocs = {
   name: 'cross',
   category: 'Matrix',
   syntax: ['cross(A, B)'],
   description: 'Calculate the cross product for two vectors in three dimensional space.',
   examples: ['cross([1, 1, 0],  [0, 1, 1])', 'cross([3, -3, 1], [4, 9, 2])', 'cross([2, 3, 4],  [5, 6, 7])'],
   seealso: ['multiply', 'dot']
-};
-exports.crossDocs = crossDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/ctranspose.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.ctransposeDocs = void 0;
-var ctransposeDocs = {
+var ctransposeDocs = exports.ctransposeDocs = {
   name: 'ctranspose',
   category: 'Matrix',
   syntax: ['x\'', 'ctranspose(x)'],
   description: 'Complex Conjugate and Transpose a matrix',
   examples: ['a = [1, 2, 3; 4, 5, 6]', 'a\'', 'ctranspose(a)'],
   seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'ones', 'range', 'size', 'squeeze', 'subset', 'trace', 'zeros']
-};
-exports.ctransposeDocs = ctransposeDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/det.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.detDocs = void 0;
-var detDocs = {
+var detDocs = exports.detDocs = {
   name: 'det',
   category: 'Matrix',
   syntax: ['det(x)'],
   description: 'Calculate the determinant of a matrix',
   examples: ['det([1, 2; 3, 4])', 'det([-2, 2, 3; -1, 1, 3; 2, 0, -1])'],
   seealso: ['concat', 'diag', 'identity', 'inv', 'ones', 'range', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.detDocs = detDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/diag.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.diagDocs = void 0;
-var diagDocs = {
+var diagDocs = exports.diagDocs = {
   name: 'diag',
   category: 'Matrix',
   syntax: ['diag(x)', 'diag(x, k)'],
   description: 'Create a diagonal matrix or retrieve the diagonal of a matrix. When x is a vector, a matrix with the vector values on the diagonal will be returned. When x is a matrix, a vector with the diagonal values of the matrix is returned. When k is provided, the k-th diagonal will be filled in or retrieved, if k is positive, the values are placed on the super diagonal. When k is negative, the values are placed on the sub diagonal.',
   examples: ['diag(1:3)', 'diag(1:3, 1)', 'a = [1, 2, 3; 4, 5, 6; 7, 8, 9]', 'diag(a)'],
   seealso: ['concat', 'det', 'identity', 'inv', 'ones', 'range', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.diagDocs = diagDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/diff.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.diffDocs = void 0;
-var diffDocs = {
+var diffDocs = exports.diffDocs = {
   name: 'diff',
   category: 'Matrix',
   syntax: ['diff(arr)', 'diff(arr, dim)'],
   description: ['Create a new matrix or array with the difference of the passed matrix or array.', 'Dim parameter is optional and used to indicant the dimension of the array/matrix to apply the difference', 'If no dimension parameter is passed it is assumed as dimension 0', 'Dimension is zero-based in javascript and one-based in the parser', 'Arrays must be \'rectangular\' meaning arrays like [1, 2]', 'If something is passed as a matrix it will be returned as a matrix but other than that all matrices are converted to arrays'],
-  examples: ['diff([1, 2, 4, 7, 0])', 'diff([1, 2, 4, 7, 0], 0)', 'diff(matrix([1, 2, 4, 7, 0]))', 'diff([[1, 2], [3, 4]])', 'diff([[1, 2], [3, 4]], 0)', 'diff([[1, 2], [3, 4]], 1)', 'diff([[1, 2], [3, 4]], bignumber(1))', 'diff(matrix([[1, 2], [3, 4]]), 1)', 'diff([[1, 2], matrix([3, 4])], 1)'],
+  examples: ['A = [1, 2, 4, 7, 0]', 'diff(A)', 'diff(A, 1)', 'B = [[1, 2], [3, 4]]', 'diff(B)', 'diff(B, 1)', 'diff(B, 2)', 'diff(B, bignumber(2))', 'diff([[1, 2], matrix([3, 4])], 2)'],
   seealso: ['subtract', 'partitionSelect']
-};
-exports.diffDocs = diffDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/dot.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.dotDocs = void 0;
-var dotDocs = {
+var dotDocs = exports.dotDocs = {
   name: 'dot',
   category: 'Matrix',
   syntax: ['dot(A, B)', 'A * B'],
   description: 'Calculate the dot product of two vectors. ' + 'The dot product of A = [a1, a2, a3, ..., an] and B = [b1, b2, b3, ..., bn] ' + 'is defined as dot(A, B) = a1 * b1 + a2 * b2 + a3 * b3 + ... + an * bn',
   examples: ['dot([2, 4, 1], [2, 2, 3])', '[2, 4, 1] * [2, 2, 3]'],
   seealso: ['multiply', 'cross']
-};
-exports.dotDocs = dotDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/eigs.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.eigsDocs = void 0;
-var eigsDocs = {
+var eigsDocs = exports.eigsDocs = {
   name: 'eigs',
   category: 'Matrix',
   syntax: ['eigs(x)'],
-  description: 'Calculate the eigenvalues and eigenvectors of a real symmetric matrix',
-  examples: ['eigs([[5, 2.3], [2.3, 1]])'],
+  description: 'Calculate the eigenvalues and optionally eigenvectors of a square matrix',
+  examples: ['eigs([[5, 2.3], [2.3, 1]])', 'eigs([[1, 2, 3], [4, 5, 6], [7, 8, 9]], { precision: 1e-6, eigenvectors: false })'],
   seealso: ['inv']
-};
-exports.eigsDocs = eigsDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/fft.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.fftDocs = void 0;
+var fftDocs = exports.fftDocs = {
+  name: 'fft',
+  category: 'Matrix',
+  syntax: ['fft(x)'],
+  description: 'Calculate N-dimensional fourier transform',
+  examples: ['fft([[1, 0], [1, 0]])'],
+  seealso: ['ifft']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/filter.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.filterDocs = void 0;
-var filterDocs = {
+var filterDocs = exports.filterDocs = {
   name: 'filter',
   category: 'Matrix',
   syntax: ['filter(x, test)'],
   description: 'Filter items in a matrix.',
   examples: ['isPositive(x) = x > 0', 'filter([6, -2, -1, 4, 3], isPositive)', 'filter([6, -2, 0, 1, 0], x != 0)'],
   seealso: ['sort', 'map', 'forEach']
-};
-exports.filterDocs = filterDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/flatten.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.flattenDocs = void 0;
-var flattenDocs = {
+var flattenDocs = exports.flattenDocs = {
   name: 'flatten',
   category: 'Matrix',
   syntax: ['flatten(x)'],
   description: 'Flatten a multi dimensional matrix into a single dimensional matrix.',
   examples: ['a = [1, 2, 3; 4, 5, 6]', 'size(a)', 'b = flatten(a)', 'size(b)'],
   seealso: ['concat', 'resize', 'size', 'squeeze']
-};
-exports.flattenDocs = flattenDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/forEach.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.forEachDocs = void 0;
-var forEachDocs = {
+var forEachDocs = exports.forEachDocs = {
   name: 'forEach',
   category: 'Matrix',
   syntax: ['forEach(x, callback)'],
   description: 'Iterates over all elements of a matrix/array, and executes the given callback function.',
-  examples: ['forEach([1, 2, 3], function(val) { console.log(val) })'],
+  examples: ['numberOfPets = {}', 'addPet(n) = numberOfPets[n] = (numberOfPets[n] ? numberOfPets[n]:0 ) + 1;', 'forEach(["Dog","Cat","Cat"], addPet)', 'numberOfPets'],
   seealso: ['map', 'sort', 'filter']
-};
-exports.forEachDocs = forEachDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/getMatrixDataType.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getMatrixDataTypeDocs = void 0;
-var getMatrixDataTypeDocs = {
+var getMatrixDataTypeDocs = exports.getMatrixDataTypeDocs = {
   name: 'getMatrixDataType',
   category: 'Matrix',
   syntax: ['getMatrixDataType(x)'],
   description: 'Find the data type of all elements in a matrix or array, ' + 'for example "number" if all items are a number ' + 'and "Complex" if all values are complex numbers. ' + 'If a matrix contains more than one data type, it will return "mixed".',
   examples: ['getMatrixDataType([1, 2, 3])', 'getMatrixDataType([[5 cm], [2 inch]])', 'getMatrixDataType([1, "text"])', 'getMatrixDataType([1, bignumber(4)])'],
   seealso: ['matrix', 'sparse', 'typeOf']
-};
-exports.getMatrixDataTypeDocs = getMatrixDataTypeDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/identity.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.identityDocs = void 0;
-var identityDocs = {
+var identityDocs = exports.identityDocs = {
   name: 'identity',
   category: 'Matrix',
   syntax: ['identity(n)', 'identity(m, n)', 'identity([m, n])'],
   description: 'Returns the identity matrix with size m-by-n. The matrix has ones on the diagonal and zeros elsewhere.',
   examples: ['identity(3)', 'identity(3, 5)', 'a = [1, 2, 3; 4, 5, 6]', 'identity(size(a))'],
   seealso: ['concat', 'det', 'diag', 'inv', 'ones', 'range', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.identityDocs = identityDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/ifft.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ifftDocs = void 0;
+var ifftDocs = exports.ifftDocs = {
+  name: 'ifft',
+  category: 'Matrix',
+  syntax: ['ifft(x)'],
+  description: 'Calculate N-dimensional inverse fourier transform',
+  examples: ['ifft([[2, 2], [0, 0]])'],
+  seealso: ['fft']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/inv.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.invDocs = void 0;
-var invDocs = {
+var invDocs = exports.invDocs = {
   name: 'inv',
   category: 'Matrix',
   syntax: ['inv(x)'],
   description: 'Calculate the inverse of a matrix',
   examples: ['inv([1, 2; 3, 4])', 'inv(4)', '1 / 4'],
   seealso: ['concat', 'det', 'diag', 'identity', 'ones', 'range', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.invDocs = invDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/kron.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.kronDocs = void 0;
-var kronDocs = {
+var kronDocs = exports.kronDocs = {
   name: 'kron',
   category: 'Matrix',
   syntax: ['kron(x, y)'],
   description: 'Calculates the kronecker product of 2 matrices or vectors.',
   examples: ['kron([[1, 0], [0, 1]], [[1, 2], [3, 4]])', 'kron([1,1], [2,3,4])'],
   seealso: ['multiply', 'dot', 'cross']
-};
-exports.kronDocs = kronDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/map.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.mapDocs = void 0;
-var mapDocs = {
+var mapDocs = exports.mapDocs = {
   name: 'map',
   category: 'Matrix',
   syntax: ['map(x, callback)'],
   description: 'Create a new matrix or array with the results of the callback function executed on each entry of the matrix/array.',
   examples: ['map([1, 2, 3], square)'],
   seealso: ['filter', 'forEach']
-};
-exports.mapDocs = mapDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/matrixFromColumns.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.matrixFromColumnsDocs = void 0;
+var matrixFromColumnsDocs = exports.matrixFromColumnsDocs = {
+  name: 'matrixFromColumns',
+  category: 'Matrix',
+  syntax: ['matrixFromColumns(...arr)', 'matrixFromColumns(row1, row2)', 'matrixFromColumns(row1, row2, row3)'],
+  description: 'Create a dense matrix from vectors as individual columns.',
+  examples: ['matrixFromColumns([1, 2, 3], [[4],[5],[6]])'],
+  seealso: ['matrix', 'matrixFromRows', 'matrixFromFunction', 'zeros']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/matrixFromFunction.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.matrixFromFunctionDocs = void 0;
+var matrixFromFunctionDocs = exports.matrixFromFunctionDocs = {
+  name: 'matrixFromFunction',
+  category: 'Matrix',
+  syntax: ['matrixFromFunction(size, fn)', 'matrixFromFunction(size, fn, format)', 'matrixFromFunction(size, fn, format, datatype)', 'matrixFromFunction(size, format, fn)', 'matrixFromFunction(size, format, datatype, fn)'],
+  description: 'Create a matrix by evaluating a generating function at each index.',
+  examples: ['f(I) = I[1] - I[2]', 'matrixFromFunction([3,3], f)', 'g(I) = I[1] - I[2] == 1 ? 4 : 0', 'matrixFromFunction([100, 100], "sparse", g)', 'matrixFromFunction([5], random)'],
+  seealso: ['matrix', 'matrixFromRows', 'matrixFromColumns', 'zeros']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/matrixFromRows.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.matrixFromRowsDocs = void 0;
+var matrixFromRowsDocs = exports.matrixFromRowsDocs = {
+  name: 'matrixFromRows',
+  category: 'Matrix',
+  syntax: ['matrixFromRows(...arr)', 'matrixFromRows(row1, row2)', 'matrixFromRows(row1, row2, row3)'],
+  description: 'Create a dense matrix from vectors as individual rows.',
+  examples: ['matrixFromRows([1, 2, 3], [[4],[5],[6]])'],
+  seealso: ['matrix', 'matrixFromColumns', 'matrixFromFunction', 'zeros']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/ones.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.onesDocs = void 0;
-var onesDocs = {
+var onesDocs = exports.onesDocs = {
   name: 'ones',
   category: 'Matrix',
   syntax: ['ones(m)', 'ones(m, n)', 'ones(m, n, p, ...)', 'ones([m])', 'ones([m, n])', 'ones([m, n, p, ...])'],
   description: 'Create a matrix containing ones.',
   examples: ['ones(3)', 'ones(3, 5)', 'ones([2,3]) * 4.5', 'a = [1, 2, 3; 4, 5, 6]', 'ones(size(a))'],
   seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'range', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.onesDocs = onesDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/partitionSelect.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.partitionSelectDocs = void 0;
-var partitionSelectDocs = {
+var partitionSelectDocs = exports.partitionSelectDocs = {
   name: 'partitionSelect',
   category: 'Matrix',
   syntax: ['partitionSelect(x, k)', 'partitionSelect(x, k, compare)'],
   description: 'Partition-based selection of an array or 1D matrix. Will find the kth smallest value, and mutates the input array. Uses Quickselect.',
-  examples: ['partitionSelect([5, 10, 1], 2)', 'partitionSelect(["C", "B", "A", "D"], 1)'],
+  examples: ['partitionSelect([5, 10, 1], 2)', 'partitionSelect(["C", "B", "A", "D"], 1, compareText)', 'arr = [5, 2, 1]', 'partitionSelect(arr, 0) # returns 1, arr is now: [1, 2, 5]', 'arr', 'partitionSelect(arr, 1, \'desc\') # returns 2, arr is now: [5, 2, 1]', 'arr'],
   seealso: ['sort']
-};
-exports.partitionSelectDocs = partitionSelectDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/pinv.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.pinvDocs = void 0;
+var pinvDocs = exports.pinvDocs = {
+  name: 'pinv',
+  category: 'Matrix',
+  syntax: ['pinv(x)'],
+  description: 'Calculate the Moore–Penrose inverse of a matrix',
+  examples: ['pinv([1, 2; 3, 4])', 'pinv([[1, 0], [0, 1], [0, 1]])', 'pinv(4)'],
+  seealso: ['inv']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/range.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.rangeDocs = void 0;
-var rangeDocs = {
+var rangeDocs = exports.rangeDocs = {
   name: 'range',
   category: 'Type',
   syntax: ['start:end', 'start:step:end', 'range(start, end)', 'range(start, end, step)', 'range(string)'],
   description: 'Create a range. Lower bound of the range is included, upper bound is excluded.',
-  examples: ['1:5', '3:-1:-3', 'range(3, 7)', 'range(0, 12, 2)', 'range("4:10")', 'a = [1, 2, 3, 4; 5, 6, 7, 8]', 'a[1:2, 1:2]'],
+  examples: ['1:5', '3:-1:-3', 'range(3, 7)', 'range(0, 12, 2)', 'range("4:10")', 'range(1m, 1m, 3m)', 'a = [1, 2, 3, 4; 5, 6, 7, 8]', 'a[1:2, 1:2]'],
   seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'ones', 'size', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.rangeDocs = rangeDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/reshape.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.reshapeDocs = void 0;
-var reshapeDocs = {
+var reshapeDocs = exports.reshapeDocs = {
   name: 'reshape',
   category: 'Matrix',
   syntax: ['reshape(x, sizes)'],
   description: 'Reshape a multi dimensional array to fit the specified dimensions.',
-  examples: ['reshape([1, 2, 3, 4, 5, 6], [2, 3])', 'reshape([[1, 2], [3, 4]], [1, 4])', 'reshape([[1, 2], [3, 4]], [4])'],
+  examples: ['reshape([1, 2, 3, 4, 5, 6], [2, 3])', 'reshape([[1, 2], [3, 4]], [1, 4])', 'reshape([[1, 2], [3, 4]], [4])', 'reshape([1, 2, 3, 4], [-1, 2])'],
   seealso: ['size', 'squeeze', 'resize']
-};
-exports.reshapeDocs = reshapeDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/resize.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.resizeDocs = void 0;
-var resizeDocs = {
+var resizeDocs = exports.resizeDocs = {
   name: 'resize',
   category: 'Matrix',
   syntax: ['resize(x, size)', 'resize(x, size, defaultValue)'],
   description: 'Resize a matrix.',
   examples: ['resize([1,2,3,4,5], [3])', 'resize([1,2,3], [5])', 'resize([1,2,3], [5], -1)', 'resize(2, [2, 3])', 'resize("hello", [8], "!")'],
   seealso: ['size', 'subset', 'squeeze', 'reshape']
-};
-exports.resizeDocs = resizeDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/rotate.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.rotateDocs = void 0;
-var rotateDocs = {
+var rotateDocs = exports.rotateDocs = {
   name: 'rotate',
   category: 'Matrix',
   syntax: ['rotate(w, theta)', 'rotate(w, theta, v)'],
   description: 'Returns a 2-D rotation matrix (2x2) for a given angle (in radians). ' + 'Returns a 2-D rotation matrix (3x3) of a given angle (in radians) around given axis.',
-  examples: ['rotate([1, 0], math.pi / 2)', 'rotate(matrix([1, 0]), unit("35deg"))', 'rotate([1, 0, 0], unit("90deg"), [0, 0, 1])', 'rotate(matrix([1, 0, 0]), unit("90deg"), matrix([0, 0, 1]))'],
+  examples: ['rotate([1, 0], pi / 2)', 'rotate(matrix([1, 0]), unit("35deg"))', 'rotate([1, 0, 0], unit("90deg"), [0, 0, 1])', 'rotate(matrix([1, 0, 0]), unit("90deg"), matrix([0, 0, 1]))'],
   seealso: ['matrix', 'rotationMatrix']
-};
-exports.rotateDocs = rotateDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/rotationMatrix.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.rotationMatrixDocs = void 0;
-var rotationMatrixDocs = {
+var rotationMatrixDocs = exports.rotationMatrixDocs = {
   name: 'rotationMatrix',
   category: 'Matrix',
   syntax: ['rotationMatrix(theta)', 'rotationMatrix(theta, v)', 'rotationMatrix(theta, v, format)'],
   description: 'Returns a 2-D rotation matrix (2x2) for a given angle (in radians). ' + 'Returns a 2-D rotation matrix (3x3) of a given angle (in radians) around given axis.',
   examples: ['rotationMatrix(pi / 2)', 'rotationMatrix(unit("45deg"), [0, 0, 1])', 'rotationMatrix(1, matrix([0, 0, 1]), "sparse")'],
   seealso: ['cos', 'sin']
-};
-exports.rotationMatrixDocs = rotationMatrixDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/row.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.rowDocs = void 0;
-var rowDocs = {
+var rowDocs = exports.rowDocs = {
   name: 'row',
   category: 'Matrix',
   syntax: ['row(x, index)'],
   description: 'Return a row from a matrix or array.',
   examples: ['A = [[1, 2], [3, 4]]', 'row(A, 1)', 'row(A, 2)'],
-  seealso: ['column']
-};
-exports.rowDocs = rowDocs;
+  seealso: ['column', 'matrixFromRows']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/size.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.sizeDocs = void 0;
-var sizeDocs = {
+var sizeDocs = exports.sizeDocs = {
   name: 'size',
   category: 'Matrix',
   syntax: ['size(x)'],
   description: 'Calculate the size of a matrix.',
   examples: ['size(2.3)', 'size("hello world")', 'a = [1, 2; 3, 4; 5, 6]', 'size(a)', 'size(1:6)'],
-  seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'ones', 'range', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.sizeDocs = sizeDocs;
+  seealso: ['concat', 'count', 'det', 'diag', 'identity', 'inv', 'ones', 'range', 'squeeze', 'subset', 'trace', 'transpose', 'zeros']
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/sort.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.sortDocs = void 0;
-var sortDocs = {
+var sortDocs = exports.sortDocs = {
   name: 'sort',
   category: 'Matrix',
   syntax: ['sort(x)', 'sort(x, compare)'],
   description: 'Sort the items in a matrix. Compare can be a string "asc", "desc", "natural", or a custom sort function.',
-  examples: ['sort([5, 10, 1])', 'sort(["C", "B", "A", "D"])', 'sortByLength(a, b) = size(a)[1] - size(b)[1]', 'sort(["Langdon", "Tom", "Sara"], sortByLength)', 'sort(["10", "1", "2"], "natural")'],
+  examples: ['sort([5, 10, 1])', 'sort(["C", "B", "A", "D"], "natural")', 'sortByLength(a, b) = size(a)[1] - size(b)[1]', 'sort(["Langdon", "Tom", "Sara"], sortByLength)', 'sort(["10", "1", "2"], "natural")'],
   seealso: ['map', 'filter', 'forEach']
-};
-exports.sortDocs = sortDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/squeeze.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.squeezeDocs = void 0;
-var squeezeDocs = {
+var squeezeDocs = exports.squeezeDocs = {
   name: 'squeeze',
   category: 'Matrix',
   syntax: ['squeeze(x)'],
   description: 'Remove inner and outer singleton dimensions from a matrix.',
   examples: ['a = zeros(3,2,1)', 'size(squeeze(a))', 'b = zeros(1,1,3)', 'size(squeeze(b))'],
   seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'ones', 'range', 'size', 'subset', 'trace', 'transpose', 'zeros']
-};
-exports.squeezeDocs = squeezeDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/subset.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.subsetDocs = void 0;
-var subsetDocs = {
+var subsetDocs = exports.subsetDocs = {
   name: 'subset',
   category: 'Matrix',
   syntax: ['value(index)', 'value(index) = replacement', 'subset(value, [index])', 'subset(value, [index], replacement)'],
-  description: 'Get or set a subset of a matrix or string. ' + 'Indexes are one-based. ' + 'Both the ranges lower-bound and upper-bound are included.',
-  examples: ['d = [1, 2; 3, 4]', 'e = []', 'e[1, 1:2] = [5, 6]', 'e[2, :] = [7, 8]', 'f = d * e', 'f[2, 1]', 'f[:, 1]'],
+  description: 'Get or set a subset of the entries of a matrix or ' + 'characters of a string. ' + 'Indexes are one-based. There should be one index specification for ' + 'each dimension of the target. Each specification can be a single ' + 'index, a list of indices, or a range in colon notation `l:u`. ' + 'In a range, both the lower bound l and upper bound u are included; ' + 'and if a bound is omitted it defaults to the most extreme valid value. ' + 'The cartesian product of the indices specified in each dimension ' + 'determines the target of the operation.',
+  examples: ['d = [1, 2; 3, 4]', 'e = []', 'e[1, 1:2] = [5, 6]', 'e[2, :] = [7, 8]', 'f = d * e', 'f[2, 1]', 'f[:, 1]', 'f[[1,2], [1,3]] = [9, 10; 11, 12]', 'f'],
   seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'ones', 'range', 'size', 'squeeze', 'trace', 'transpose', 'zeros']
-};
-exports.subsetDocs = subsetDocs;
+};

package/lib/cjs/expression/embeddedDocs/function/matrix/trace.js

@@ -4,12 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.traceDocs = void 0;
-var traceDocs = {
+var traceDocs = exports.traceDocs = {
   name: 'trace',
   category: 'Matrix',
   syntax: ['trace(A)'],
   description: 'Calculate the trace of a matrix: the sum of the elements on the main diagonal of a square matrix.',
   examples: ['A = [1, 2, 3; -1, 2, 3; 2, 0, 3]', 'trace(A)'],
   seealso: ['concat', 'det', 'diag', 'identity', 'inv', 'ones', 'range', 'size', 'squeeze', 'subset', 'transpose', 'zeros']
-};
-exports.traceDocs = traceDocs;
+};