mathjs/test/unit-tests/function/statistics/min.test.js

import assert from 'assert'
import math from '../../../../src/defaultInstance.js'
const BigNumber = math.BigNumber
const Complex = math.Complex
const DenseMatrix = math.DenseMatrix
const fraction = math.fraction
const min = math.min
const unit = math.unit

describe('min', function () {
  it('should return the min between several numbers', function () {
    assert.strictEqual(min(5), 5)
    assert.strictEqual(min(1, 3), 1)
    assert.strictEqual(min(3, 1), 1)
    assert.strictEqual(min(1, 3, 5, -5, 2), -5)
    assert.strictEqual(min(0, 0, 0, 0), 0)
  })

  it('should return the min of strings by their numerical value', function () {
    assert.strictEqual(min('10', '3', '4', '2'), 2)
    assert.strictEqual(min('10'), 10)
  })

  it('should return the max of strings by their numerical value (with BigNumber config)', function () {
    const bigmath = math.create({ number: 'BigNumber' })
    assert.deepStrictEqual(bigmath.min('10', '3', '4', '2'), bigmath.bignumber(2))
    assert.deepStrictEqual(bigmath.min('10'), bigmath.bignumber(10))
  })

  it('should return the max of strings by their numerical value (with bigint config)', function () {
    const bigmath = math.create({ number: 'bigint' })
    assert.strictEqual(bigmath.min('10', '3', '4', '2'), 2n)
    assert.strictEqual(bigmath.min('10'), 10n)
    assert.strictEqual(bigmath.min('2.5'), 2.5) // fallback to number
    assert.strictEqual(bigmath.min('2.5', '4'), 2.5) // fallback to number
  })

  it('should return the min element from a vector', function () {
    assert.strictEqual(min([1, 3, 5, -5, 2]), -5)
  })

  it('should return the min of big numbers', function () {
    assert.deepStrictEqual(min(new BigNumber(1), new BigNumber(3), new BigNumber(5), new BigNumber(2), new BigNumber(-5)),
      new BigNumber(-5))
  })

  it('should return the min element from a vector array', function () {
    assert.strictEqual(min(new DenseMatrix([1, 3, 5, -5, 2])), -5)
  })

  it('should return the max element from a 2d matrix', function () {
    assert.deepStrictEqual(min([
      [1, 4, 7],
      [3, 0, 5],
      [-1, 9, 11]
    ]), -1)
    assert.deepStrictEqual(min(new DenseMatrix([
      [1, 4, 7],
      [3, 0, 5],
      [-1, 9, 11]
    ])), -1)
  })

  it('should return a reduced n-1 matrix from a n matrix', function () {
    assert.deepStrictEqual(min([
      [1, 2, 3],
      [4, 5, 6],
      [7, 8, 9]], 0), [1, 2, 3])
    assert.deepStrictEqual(min([
      [1, 2, 3],
      [4, 5, 6],
      [7, 8, 9]], 1), [1, 4, 7])

    assert.deepStrictEqual(min([
      [1, 2, 3],
      [6, 5, 4],
      [8, 7, 9]], 1), [1, 4, 7])

    assert.deepStrictEqual(min([
      [[1, 2], [3, 4], [5, 6]],
      [[6, 7], [8, 9], [10, 11]]], 2),
    [[1, 3, 5], [6, 8, 10]])

    assert.deepStrictEqual(min([
      [[1, 2], [3, 4], [5, 6]],
      [[6, 7], [8, 9], [10, 11]]], 1),
    [[1, 2], [6, 7]])

    assert.deepStrictEqual(min([
      [[1, 2], [3, 4], [5, 6]],
      [[6, 7], [8, 9], [10, 11]]], 0),
    [[1, 2], [3, 4], [5, 6]])
  })

  it('should return NaN if any of the inputs contains NaN', function () {
    assert(isNaN(min([NaN])))
    assert(isNaN(min([1, NaN])))
    assert(isNaN(min([NaN, 1])))
    assert(isNaN(min([1, 3, NaN])))
    assert(isNaN(min([NaN, NaN, NaN])))
    assert(isNaN(min(NaN, NaN, NaN)))
    assert(isNaN(min(BigNumber(NaN), BigNumber(123))))
    assert(isNaN((min(BigNumber(123), BigNumber(NaN), NaN))))
    assert(isNaN(min(unit(NaN, 's'), unit(123, 's')).value))
    assert(isNaN(min(unit(123, 's'), unit(NaN, 's')).value))
    assert(isNaN(min(1, 3, fraction(2, 3), fraction(1, 2), NaN, BigNumber(1), BigNumber(NaN), 5, Infinity, -Infinity)))
  })

  it('should return the smallest of mixed types', function () {
    assert.deepStrictEqual(min(1n, 3, new BigNumber(7), fraction(5, 4)), 1n)
    assert.deepStrictEqual(min(3n, 1, new BigNumber(7), fraction(5, 4)), 1)
    const big1 = new BigNumber(1)
    assert.deepStrictEqual(min(3n, 7, big1, fraction(5, 4)), big1)
    const threeq = fraction(3, 4)
    assert.deepStrictEqual(min(3n, 7, new BigNumber(1.25), threeq), threeq)
    assert.strictEqual(min(3n, 7, big1, threeq, -Infinity), -Infinity)
  })

  it('should throw an error when called multiple arrays or matrices', function () {
    assert.throws(function () { min([1, 2], [3, 4]) }, /Scalar values expected/)
    assert.throws(function () { min(math.matrix([1, 2]), math.matrix([3, 4])) }, /Scalar values expected/)
  })

  it('should throw an error if called a dimension out of range', function () {
    assert.throws(function () { min([1, 2, 3], -1) }, /IndexError: Index out of range \(-1 < 0\)/)
    assert.throws(function () { min([1, 2, 3], 1) }, /IndexError: Index out of range \(1 > 0\)/)
  })

  it('should throw an error if called with invalid number of arguments', function () {
    assert.throws(function () { min() })
    assert.throws(function () { min([], 2, 3) })
  })

  it('should throw an error if called with an empty array', function () {
    assert.throws(function () { min([]) })
  })

  it('should throw an error if called with invalid type of arguments', function () {
    assert.throws(function () { min(2, new Complex(2, 5)) }, /TypeError: Cannot calculate min, no ordering relation is defined for complex numbers/)
    assert.throws(function () { min(new Complex(2, 3), new Complex(2, 1)) }, /TypeError: Cannot calculate min, no ordering relation is defined for complex numbers/)

    assert.throws(function () { min([[2, undefined, 4]]) }, /TypeError: Cannot calculate min, unexpected type of argument/)
    assert.throws(function () { min([[2, new Date(), 4]]) }, /TypeError: Cannot calculate min, unexpected type of argument/)
    assert.throws(function () { min([2, null, 4]) }, /TypeError: Cannot calculate min, unexpected type of argument/)
    assert.throws(function () { min([[2, 5], [4, null], [1, 7]], 0) }, /TypeError: Cannot calculate min, unexpected type of argument/)
    assert.throws(function () { min('a', 'b') }, /Error: Cannot convert "a" to a number/)
    assert.throws(function () { min('a') }, /Error: Cannot convert "a" to a number/)
  })

  it('should LaTeX min', function () {
    const expression = math.parse('min(1,2,3)')
    assert.strictEqual(expression.toTex(), '\\min\\left(1,2,3\\right)')
  })
})