mathjs 10.4.3 → 10.5.0

package/types/index.d.ts

@@ -811,7 +811,21 @@ declare namespace math {
     ceil(x: Complex): Complex;
     ceil(x: MathArray): MathArray;
     ceil(x: Matrix): Matrix;
-    ceil(x: Unit): Unit;
+
+    /**
+     * Round a value towards plus infinity If x is complex, both real and
+     * imaginary part are rounded towards plus infinity. For matrices, the
+     * function is evaluated element wise.
+     * @param x Number to be rounded
+     * @param n Number of decimals Default value: 0.
+     * @returns Rounded value
+     */
+    ceil(x: number, n: number | MathArray): number;
+    ceil(x: BigNumber, n: BigNumber | MathArray): BigNumber;
+    ceil(x: Fraction, n: number): Fraction;
+    ceil(x: Complex, n: number | MathArray): Complex;
+    ceil(x: MathArray, n: number): MathArray;
+    ceil(x: Matrix, n: number | BigNumber): Matrix;
 
     /**
      * Compute the cube of a value, x * x * x. For matrices, the function is
@@ -1818,6 +1832,13 @@ declare namespace math {
      */
     kldivergence(q: MathArray | Matrix, p: MathArray | Matrix): number;
 
+    /**
+     * Compute the log gamma function of a value, using Lanczos approximation for numbers and Stirling series for complex numbers.
+     * @param n A real or complex number
+     * @returns The log gamma of `n`
+     */
+    lgamma<T extends number | Complex>(n: T): NoLiteralType<T>;
+
     /**
      * Multinomial Coefficients compute the number of ways of picking a1,
      * a2, ..., ai unordered outcomes from n possibilities. multinomial

package/types/index.ts

@@ -831,3 +831,13 @@ Factory Test
     expectTypeOf(x).toMatchTypeOf<math.MathJsChain>()
   }
 }
+
+/*
+Probability function examples
+*/
+{
+  const math = create(all, {});
+
+  expectTypeOf(math.lgamma(1.5)).toMatchTypeOf<number>()
+  expectTypeOf(math.lgamma(math.complex(1.5, -1.5))).toMatchTypeOf<math.Complex>()
+}