New Features

• Matrix columnAddScalar
• Matrix columnSubtract
• Matrix columnSubtractScalar
• Matrix columnDivide

Bug Fixes

• Algebra::quadratic returns empty array when a=0 and b=0 (Previously would divide by zero)
• Trigonometry::unitCircle division by zero error for single-point.
• SampleData\People getShoeSize has a typo and was getShowSize. This has been fixed.
• Fixed calculation in Probability\Distribution\Discrete\Hypergeometric cdf. Implementation changed to use sum of PMFs.
• Statistics\Correlation sampleCovariance, populationCorrelationCoefficient, sampleCorrelationCoefficient, throw BadDataException or OutOfBoundsException rather than division by zero for bad input data.
• Statistics\Descriptive coefficientOfVariation will return NAN if mean is zero. Previously did division by zero.
• Fix some typos in Statistics\Distance hellinger, brayCurtis, and canberra that could have resulted in incorrect results.
• Fix \Statistics\EffectSize cohensQ bounds check [-1, 1] and throw OutOfBoundsException when outside range, and return INF when r == 1 or -1.
• Fix \Statistics\EffectSize boundary edge cases resulting in division by zero for hedgesG, cohensD, and glassDelta.

Improvements

• Refactor the geometric mean implementation to use a numerically stable log-space calculation
• Refactor ChiSquared pdf to avoid raising 0 to negative exponent which is deprecated
• Refactor LogLogistic pdf and cdf to avoid raising 0 to negative exponent which is deprecated
• Improved implementation of NoncentralT median
• Probability\Distribution\Multivariate\Multinomial uses a higher numerical precision to reject probabilities that don't sum to 1.0
• Rewrote Statistics\Distribution fractionalRanking to track original indices and use == for tie detection instead of strval() grouping, avoiding floating-point comparison bugs.
• Statistics\Distribution cumulativeFrequency and cumulativeRelativeFrequency now do a frequency distribution on sorted data, which was the original intent.
• Statistics\Divergence kullbackLeibler and jensenShannon throw an exception if there are non-negative probabilities.
• Statistics\Distribution stemAndLeafPlot throws an exception if there are negative values.
• Statistics\Experiment functions throw exceptions when input outside of range. likelihoodRatioSS returns infinity for rather than division by zero.
• Statistics\Outlier edge cases throw exceptions: Grubbs' having fewer than 3 observations; standard deviation of zero; Support upper/lower as aliases for one sided in grubbsCriticalValue.
• Improved exception message for Functions\Support checkLimits to add invalid endpoint character in the exception message

New Features

• Matrix columnAddScalar
• Matrix columnSubtract
• Matrix columnSubtractScalar
• Matrix columnDivide

Bug Fixes

• Algebra::quadratic returns empty array when a=0 and b=0 (Previously would divide by zero)
• Trigonometry::unitCircle division by zero error for single-point.
• SampleData\People getShoeSize has a typo and was getShowSize. This has been fixed.
• Fixed calculation in Probability\Distribution\Discrete\Hypergeometric cdf. Implementation changed to use sum of PMFs.
• Statistics\Correlation sampleCovariance, populationCorrelationCoefficient, sampleCorrelationCoefficient, throw BadDataException or OutOfBoundsException rather than division by zero for bad input data.
• Statistics\Descriptive coefficientOfVariation will return NAN if mean is zero. Previously did division by zero.
• Fix some typos in Statistics\Distance hellinger, brayCurtis, and canberra that could have resulted in incorrect results.
• Fix \Statistics\EffectSize cohensQ bounds check [-1, 1] and throw OutOfBoundsException when outside range, and return INF when r == 1 or -1.
• Fix \Statistics\EffectSize boundary edge cases resulting in division by zero for hedgesG, cohensD, and glassDelta.

Improvements

• Refactor the geometric mean implementation to use a numerically stable log-space calculation
• Refactor ChiSquared pdf to avoid raising 0 to negative exponent which is deprecated
• Refactor LogLogistic pdf and cdf to avoid raising 0 to negative exponent which is deprecated
• Improved implementation of NoncentralT median
• Probability\Distribution\Multivariate\Multinomial uses a higher numerical precision to reject probabilities that don't sum to 1.0
• Rewrote Statistics\Distribution fractionalRanking to track original indices and use == for tie detection instead of strval() grouping, avoiding floating-point comparison bugs.
• Statistics\Distribution cumulativeFrequency and cumulativeRelativeFrequency now do a frequency distribution on sorted data, which was the original intent.
• Statistics\Divergence kullbackLeibler and jensenShannon throw an exception if there are non-negative probabilities.
• Statistics\Distribution stemAndLeafPlot throws an exception if there are negative values.
• Statistics\Experiment functions throw exceptions when input outside of range. likelihoodRatioSS returns infinity for rather than division by zero.
• Statistics\Outlier edge cases throw exceptions: Grubbs' having fewer than 3 observations; standard deviation of zero; Support upper/lower as aliases for one sided in grubbsCriticalValue.
• Improved exception message for Functions\Support checkLimits to add invalid endpoint character in the exception message

New Features

• Matrix Hessenberg decomposition
• New special functions
  • Bessel functions
  • Airy functions
  • Legendre polynomials
  • Chebyshev polynomials
  • Hermite polynomials
  • Laguerre polynomials

Bug Fixes

• Fixed issue 487 in t-test with data with no variance: throws proper exception
• Fixed issue with Set isProperSubset where it didn't take into account identical sets

Improvements

• Numerical precision improvements to numerous special functions
• Documentation improvements and fixes

New Features

• Matrix Hessenberg decomposition
• New special functions
  • Bessel functions
  • Airy functions
  • Legendre polynomials
  • Chebyshev polynomials
  • Hermite polynomials
  • Laguerre polynomials

Bug Fixes

• Fixed issue 487 in t-test with data with no variance: throws proper exception
• Fixed issue with Set isProperSubset where it didn't take into account identical sets
• Fixed exception message for Functions\Support::checkLimits where invalid endpoint character did not display the endpoint character in the exception message

Improvements

• Numerical precision improvements to numerous special functions
• Documentation improvements and fixes

Improvements

• Minor changes for PHP 8.4 compatibility

Improvements

• Minor changes for PHP 8.4 compatibility

New Features

• NumberTheory\Integer isPrime

New Features

• NumberTheory\Integer isPrime

New Features

• Distance chebyshev

Improvements

• Internal build CI/CD improvements

New Features

• Distance chebyshev

Improvements

• Internal build CI/CD improvements

Improvements

• Internal improvements to improve conformance with static analysis tools

Improvements

• Internal improvements to improve conformance with static analysis tools

New Features

• Matrix rowAddVector
• Matrix columnAddVector

Improvements

• Better error handling and exception message in Sequence\NonIntenger::hyperharmonic
• Internal code improvements to conform to static analysis checks

Backwards Incompatible Changes

• Helper method names changed (public abstract methods but not part of published interface)
  • NumericalDifferentiation::isTargetInPoints changed to assertTargetInPoints
  • NumericalDifferentiation::isSpacingConstant changed to assertSpacingConstant

New Features

• Matrix rowAddVector
• Matrix columnAddVector

Improvements

• Better error handling and exception message in Sequence\NonIntenger::hyperharmonic
• Internal code improvements to conform to static analysis checks

Backwards Incompatible Changes

• Helper method names changed (public abstract methods but not part of published interface)
  • NumericalDifferentiation::isTargetInPoints changed to assertTargetInPoints
  • NumericalDifferentiation::isSpacingConstant changed to assertSpacingConstant

Improvements

• Improved algorithm for regularizedIncompleteBeta: Addresses issue 458
• Issue 456: Improved PHPDoc blocks: Changed "number" to "int|float"
• Added PHP 8.2 for CI test target

Improvements

• Improved algorithm for regularizedIncompleteBeta: Addresses issue 458
• Issue 456: Improved PHPDoc blocks: Changed "number" to "int|float"
• Added PHP 8.2 for CI test target

v2.6.0 - 2022-04-10

Improvements

• Average::truncatedMean behavior at 50% trim made consistent
• PHP 8.1 compatibility improvements

Backwards Incompatible Changes

• Average::truncatedMean throws exception if trim percent greater than 50% rather than error or unpredictable results.

Improvements

• Average::truncatedMean behavior at 50% trim made consistent
• PHP 8.1 compatibility improvements

Backwards Incompatible Changes

Average::truncatedMean throws exception if trim percent greater than 50% rather than error or unpredictable results.

New Features

• Special function logbeta
• Special function logGamma
• Special function logGammaCorr
• Special function stirlingError

Improvements

• Improvements in StudentT continuous distribution
• Improvements in special function gamma
• Improvements in special function beta

Bug Fixes

• Issue 393 (regularizedIncompleteBeta NAN)
• Issue 429 (Linear regression CI division by zero)

New Features

• Special function logbeta
• Special function logGamma
• Special function logGammaCorr
• Special function stirlingError

Improvements

• Improvements in StudentT continuous distribution
• Improvements in special function gamma
• Improvements in special function beta

Bug Fixes

• Issue 393 (regularizedIncompleteBeta NAN)
• Issue 429 (Linear regression CI division by zero)

New Features

• Complex Exponential (exp)
• Complex Exponentiation (pow)
• Zipf's Law Discrete Distribution
• Generalized harmonic non-integer sequence

Improvements

• Fixed Complex polarForm to compute the right values
• Fixed hyperharnomic non-integer sequence. Previously was computing the wrong thing
• Fixed how ArbitraryInterger handles pow of negative exponents

Backwards Incompatible Changes

• Complex polarForm now returns an array rather than a Complex number, as the Complex return was incorrect
• Interface to hyperharmonic non-integer sequence changed due to previous implementation being incorrect

New Features

• Matrix SVD (Singular Value Decomposition)
• Polynomial companion matrix

New Features

• PLS (Partial Least Squares Regression)

Improvements

• Add custom __debugInfo to NumericMatrix

New Features

• Quaternion numbers

New Features

• Matrix Improvements
  • walk method to map a function to all values without mutation or returning a value
  • MatrixFactory creates more matrix types
  • MatrixFactory::createNumeric to create NumericMatrix types
  • MatrixFactory::createFromRowVector
  • MatrixFactory::createFromColumnVector
  • Internal ObjectMatrix improvements
    • Add trace
    • Add scalarMultiply
  • Add initial ComplexMatrix
• Sample data People

Improvements

• Bug fixes
  • Issue 414 fixed - PCA/Eigenvalue convergence
  • Issue 413 fixed - matrix solve with singular matrix using RREF

Improvements

• Bugfix (Issue 413): Matrix solve with singular matrix using RREF
• Bugfix (Issue 414): PCA/Eigenvalue convergence

Improvements

• Bugfix (Issue 356): Fix Finance IRR NANs

New Features

• Vector min and max
• Arithmetic isqrt (integer square root)

Improvements

• Remove Travis CI (Moved CI to Github Actions in v1.8.0 release)
• Rearrange non-code files

Improvements

• Improve permutations algorithm to be more efficient and more numerically stable
• Qualify PHP function names with root namespace
• Move CI to Github Actions

New Features

• Algebra linear equation of one variable
• Rational number inverse
• Rational number pow

Improvements

• Improve combinations algorithm to be more efficient and more numerically stable
• Internal Matrix class reorganization

New Features

• Special function regularized lower incomplete gamma
• Cereal sample data set

Improvements

• Define boundary condition for lower incomplete gamma function

New Features

• Matrix LU solve
• Matrix QR solve

Improvements

• Bugfix (Issue 386) Matrix solve improvements
• Matrix solve has optional method parameter to force a solve method
• Bugfix ArbitraryInteger multiplication sign not taken into account

New Features

• Multivariate Regular Grid Interpolation
• Jensen-Shannon Distance
• Canberra Distance
• Search Sorted
• Search ArgMax
• Search NanArgMax
• Search ArgMin
• Search NanArgMin
• Search NonZero

Improvements

• Divergence factored out of Distance into new Divergence class

Backwards Incompatible Changes

• Legacy Distance divergences marked as deprecated (To be removed in v2.0.0)

New Features

• LinearAlgebra\Vector
  • Angle between two vectors
  • L¹ distance of two vectors
  • L² distance of two vectors
  • Minkowski distance of two vectors
• Statistics\Distance
  • Minkowski distance
  • Euclidean distance (L² distance)
  • Manhattan distance (Taxicab geometry, L¹ distance, etc.)
  • Cosine distance
  • Cosine similarity

New Features

• Ranking
  • Ordinal ranking
  • Standard competition ranking
  • Modified competition ranking
  • Fractional ranking

Improvements

• (Issue 380) Fixed Spearman's Rho calculation when there are rank ties

New Features

• Arithmetic modulo

Improvements

• Improved matrix multiplication performance using cache-oblivious algorithm optimization

Initial version 1.0.0 release!

Improvements

• Internal improvements

New Features

• Multivariate Hypergeometric distribution

New Features

• Sample Data
  • MtCars
  • Iris
  • ToothGrowth
  • PlantGrowth
  • UsArrests

New Features

• Add population and sample kurtosis
• Changed default kurtosis algorithm to the more common population kurtosis
• kurtosis now takes an optional parameter to set the kurtosis type algorithm

Improvements

• Changed default skewness algorithm to the more common sample skewness
• skewness now takes an optional parameter to set the skewness type algorithm
• Improvements to skewness algorithms

New Features

• Number\Rational basic getters
  • getWholePart
  • getNumerator
  • getDenominator
• Set Theory n-ary Cartesian product

Improvements

• Data direction control for Matrix meanDeviation and covarianceMatrix
• Algebra factors performance improvement

New Features

• Number Theory
  • isDeficientNumber
  • isAbundantNumber
  • aliquotSum
  • radical
  • totient
  • cototient
  • reducedTotient
  • mobius
  • isSquarefree
  • isRefactorableNumber
  • isSphenicNumber
  • numberOfDivisors
  • sumOfDivisors

Improvements

• Optimization of prime factorization algorithm

New Features

• Arbitrary length integers

Improvements

• Factorial optimization

New Features

• Matrix isNilpotent
• Matrix isRectangularDiagonal
• Matrix mapRows
• MathPHP logo

Improvements

• MatrixFactory random matrix custom lower and upper bounds for random number
• PSR-12 style compliance
• Bugfix: powerIteration random failure - Issue 346

New Features

• Matrix QR decomposition using Householder reflections
• Matrix Householder transformation
• MatrixFactory random matrix
• MatrixFactory givens rotation matrix
• Matrix isIdempotent
• Matrix Eigenvalue power iteration
• Matrix Eigenvalue jacobi method
• Arithmetic root (nᵗʰ root)
• Vector arithmetic multiply and divide
• Vector Iterator interface

Improvements

• Internal improvements to Matrix
• Matrix decompositions returned as objects
• Matrix Cholesky decomposition provides L transpose

New Features

• Grubb's test for statistical outliers

New Features

• Matrix rowSums
• Matrix columnSums
• Matrix rowMeans
• Matrix columnMeans
• Matrix isNormal
• MatrixFactory diagonal matrix creation method
• MatrixFactory vandermonde matrix creation method

Improvements

• Set custom Matrix tolerances
• Various internal improvements

Backwards Incompatible Changes

• Remove Matrix sampleMeans (use rowMeans or columnMeans instead)
• MatrixFactory create method only works with 2d arrays. 1d arrays no longer work. (use diagonal and vandermonde factory methods instead)
• Statistics methods throw exceptions instead of returning null on bad input
• Change return type of LagrangePolynomial to Polynomial

New Features

• Matrix isOrthogonal
• Matrix isEqual
• Harmonic sequence
• Hyperharmonic sequence
• Map\Single reciprocal

Improvements

• Support methods for almost equal
• Matrix getDiagonalElements works for non-square matrices
• Use more efficient algorithm in Matrix isSymmetric
• Use more efficient algorithm in Matrix isSkewSymmetric

Backwards Incompatible Changes

• Statistics methods throw exceptions instead of returning null on bad input

New Features

• Matrix augmentAbove
• Matrix augmentLeft

Improvements

• Object matrix multiplication

New Features

• Matrix submatrix
• Mahalanobis distance
• Bernoulli distribution mean, median, mode and variance
• Binomial distribution mean and variance
• Geometric distribution mean, median, mode and variance
• Hypergeometric distribution mode and variance
• NegativeBinomial (Pascal) distribution CDF, mean, mode and variance
• Poisson distribution mean, median, mode and variance
• Discrete Uniform distribution variance

Improvements

• Binomial distribution PMF uses more numerically stable multiplication method
• Fix potential divide by zero in TheilSen regression

Backwards Incompatible Changes

• Multinomial distribution moved from Discrete to Multivariate namespace

New Features

• Beta distribution median, mode, variance
• Cauchy distribution variance
• ChiSquared distribution mode, variance
• Exponential distribution median, mode, variance
• F distribution mode, variance
• Gamma distribution median, mode, variance
• Laplace distribution mode, variance
• Logistic distribution mode, vaiance
• LogLogistic distribution median, mode, variance
• LogNormal distribution mode, variance
• Normal distribution mode, variance
• StandardNormal distribution mode, variance
• StudentT distribution mode, variance
• Uniform distribution median, mode, variance
• Weibull distribution median, mode

Improvements

• Normal distribution rand algorithm changed to Box–Muller transform

New Features

• NumberTheory isPerfectNumber
• Sequence perfectNumber

Improvements

• Improve README documentation for continuous distributions
• Updates to build tools
• General improvements

Improvements

• Add Beta distribution inverse quantile function
• Improvements to Weibull distribution
• Improvements to Cauchy distribution
• Improvements to Laplace distribution
• Improvements to Logistic distribution
• Improvements to LogNormal distribution
• Improvements to Normal distribution
• Improvements to Pareto distribution
• Improvements to Algebra cubic/quartic complex root handling

Improvements

• [Issue 271] Improvements to documentation
• [Issue 269] Add closed-form inverse function for Exponential distribution

New Features

• Arithmetic copySign
• Matrix negate
• Matrix isSkewSymmetric

New Features

• Weighted mean
• Weighted sample variance
• Weighted covariance
• Weighted correlation coefficient

Improvements

• Minor code improvements

New Features

• Arithmetic almostEqual

Improvements

• Statistics\Average::mode improved to work with non-integer values
• Various minor code improvements

New Features

• Simpler interface for Significance tTest for one and two samples

Improvements

• T test for two samples uses more robust Welch test
• Improvements to Normal and Standard Normal continuous distributions
• General improvements to continuous distributions

Improvements

• Upgrade unit testing framework to PHPUnit 6
• Update unit tests for PHPUnit 6 compatibility
• Add PHP 7.2 to continuous integration tests

Improvements

• Percentile reimplemented to use linear interpolation between closest ranks method - Second variant, C = 1
• General code improvements
• Better error and exception handling

Improvements

• Change probability distributions to be objects instead of static methods

Backwards Incompatible Changes

• Change probability distributions to be objects instead of static methods

New Features

• Rational number
• Gamma distribution mean

Improvements

• Add .gitignore file

New Features

• Matrix isTridiagonal
• Matrix isUpperHessenberg
• Matrix isLowerHessenberg
• Matrix getSuperdiagonalElements
• Matrix getSubdiagonalElements

Improvements

• Issue 242 - documentation improvement

New Features

• Multivariate normal distribution

New Features

• Kernel density estimation

New Features

• Matrix Crout decomposition
• Categorical discrete distribution

New Features

• Hypergeometric distribution
• Discrete uniform distribution

New Features

• Dirichlet multivariate distribution
• Gamma distribution
• Initial eigenvalue matrix method
• Initial eigenvector matrix method
• Confidence ellipse

Improvements

• Internal Bitwise addition