'use strict'; function factory (type, config, load, typed) { var collection = load(require('../../type/collection')); var multiply = load(require('../arithmetic/multiply')); /** * Compute the product of a matrix or a list with values. * In case of a (multi dimensional) array or matrix, the sum of all * elements will be calculated. * * Syntax: * * math.prod(a, b, c, ...) * math.prod(A) * * Examples: * * math.multiply(2, 3); // returns 6 * math.prod(2, 3); // returns 6 * math.prod(2, 3, 4); // returns 24 * math.prod([2, 3, 4]); // returns 24 * math.prod([[2, 5], [4, 3]]); // returns 120 * * See also: * * mean, median, min, max, sum, std, var * * @param {... *} args A single matrix or or multiple scalar values * @return {*} The product of all values */ return typed('prod', { // prod([a, b, c, d, ...]) 'Array | Matrix': _prod, // prod([a, b, c, d, ...], dim) 'Array | Matrix, number | BigNumber': function (array, dim) { // TODO: implement prod(A, dim) throw new Error('prod(A, dim) is not yet supported'); //return collection.reduce(arguments[0], arguments[1], math.prod); }, // prod(a, b, c, d, ...) '...': function () { return _prod(arguments); } }); /** * Recursively calculate the product of an n-dimensional array * @param {Array} array * @return {Number} prod * @private */ function _prod(array) { var prod = undefined; collection.deepForEach(array, function (value) { prod = (prod === undefined) ? value : multiply(prod, value); }); if (prod === undefined) { throw new Error('Cannot calculate prod of an empty array'); } return prod; } } exports.name = 'prod'; exports.factory = factory;