@sheetxl/formulas 0.7.26 → 0.7.28-beta.1

package/types/src/statistical/Distribution.d.ts

@@ -0,0 +1,858 @@
+import { IRange, AcceptError, Scalar, Omittable } from '@sheetxl/primitives';
+/**
+ * @name BETA.DIST
+ * @summary Returns the beta probability distribution function.
+ * @param x is the value between A and B at which to evaluate the function.
+ * @param alpha is a parameter to the distribution and must be greater than 0.
+ * @param beta is a parameter to the distribution and must be greater than 0.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
+ * @param a lower bound to the interval of x.
+ * @param b upper bound to the interval of x.
+ */
+export declare function BETA_DIST(x: number, alpha: number, beta: number, cumulative: boolean, a?: number, b?: Omittable<number>): number;
+/**
+ * @summary Returns the cumulative beta probability density function.
+ * @param x is the value between A and B at which to evaluate the function.
+ * @param alpha is a parameter to the distribution and must be greater than 0.
+ * @param beta is a parameter to the distribution and must be greater than 0.
+ * @param a lower bound to the interval of x.
+ * @param b upper bound to the interval of x.
+ * @category Compatibility
+ */
+export declare function BETADIST(x: number, alpha: number, beta: number, a?: number, b?: Omittable<number>): number;
+/**
+ * @name BETA.INV
+ * @summary Returns the inverse of the cumulative beta probability density function (BETA.DIST).
+ * @param probability is a probability associated with the beta distribution.
+ * @param alpha is a parameter to the distribution and must be greater than 0.
+ * @param beta is a parameter to the distribution and must be greater than 0.
+ * @param a lower bound to the interval of x.
+ * @param b upper bound to the interval of x.
+ */
+export declare function BETA_INV(probability: number, alpha: number, beta: number, a?: number, b?: Omittable<number>): number;
+/**
+ * @summary Returns the inverse of the cumulative beta probability density function (BETADIST).
+ * @param probability is a probability associated with the beta distribution.
+ * @param alpha is a parameter to the distribution and must be greater than 0.
+ * @param beta is a parameter to the distribution and must be greater than 0.
+ * @param a lower bound to the interval of x.
+ * @param b upper bound to the interval of x.
+ * @category Compatibility
+ */
+export declare function BETAINV(probability: number, alpha: number, beta: number, a?: number, b?: Omittable<number>): number;
+/**
+ * @name BINOM.DIST
+ * @summary Returns the individual term binomial distribution probability.
+ * @param numberS is the number of successes in trials.
+ * @param trials is the number of independent trials.
+ * @param probabilityS is the probability of success on each trial.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.
+ */
+export declare function BINOM_DIST(numberS: number, trials: number, probabilityS: number, cumulative: boolean): number;
+/**
+ * @summary Returns the individual term binomial distribution probability.
+ * @param numberS is the number of successes in trials.
+ * @param trials is the number of independent trials.
+ * @param probabilityS is the probability of success on each trial.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.
+ * @category Compatibility
+ */
+export declare function BINOMDIST(numberS: number, trials: number, probabilityS: number, cumulative: boolean): number;
+/**
+ * @name BINOM.DIST.RANGE
+ * @summary Returns the probability of a trial result using a binomial distribution.
+ * @param trials is the number of independent trials.
+ * @param probabilityS is the probability of success on each trial.
+ * @param numberS is the number of successes in trials.
+ * @param numberS2 if provided this function returns the probability that the number of successful trials shall lie between number_s and number_s2.
+ */
+export declare function BINOM_DIST_RANGE(trials: number, probabilityS: number, numberS: number, numberS2?: Omittable<number>): number;
+/**
+ * @name BINOM.INV
+ * @summary Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.
+ * @param trials is the number of Bernoulli trials.
+ * @param probabilityS is the probability of success on each trial, a number between 0 and 1 inclusive.
+ * @param alpha is the criterion value, a number between 0 and 1 inclusive.
+ */
+export declare function BINOM_INV(trials: number, probabilityS: number, alpha: number): number;
+/**
+ * @name CHISQ.DIST
+ * @summary Returns the left-tailed probability of the chi-squared distribution.
+ * @param x is the value at which you want to evaluate the distribution, a nonnegative number.
+ * @param degFreedom is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param cumulative is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.
+ */
+export declare function CHISQ_DIST(x: number, degFreedom: number, cumulative: boolean): number;
+/**
+ * @summary Returns the right-tailed probability of the chi-squared distribution.
+ * @param x is the value at which you want to evaluate the distribution, a nonnegative number.
+ * @param degFreedom is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @category Compatibility
+ */
+export declare function CHIDIST(x: number, degFreedom: number): number;
+/**
+ * @name CHISQ.DIST.RT
+ * @summary Returns the right-tailed probability of the chi-squared distribution.
+ * @param x is the value at which you want to evaluate the distribution, a nonnegative number.
+ * @param degFreedom is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ */
+export declare function CHISQ_DIST_RT(x: number, degFreedom: number): number;
+/**
+ * @name CHISQ.INV
+ * @summary Returns the inverse of the left-tailed probability of the chi-squared distribution.
+ * @param probability is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.
+ * @param degFreedom is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ */
+export declare function CHISQ_INV(probability: number, degFreedom: number): number;
+/**
+ * @summary Returns the inverse of the right-tailed probability of the chi-squared distribution.
+ * @param probability is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.
+ * @param degFreedom is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @category Compatibility
+ */
+export declare function CHIINV(probability: number, degFreedom: number): number;
+/**
+ * @name CHISQ.INV.RT
+ * @summary Returns the inverse of the right-tailed probability of the chi-squared distribution.
+ * @param probability is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.
+ * @param degFreedom is the number of degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ */
+export declare function CHISQ_INV_RT(probability: number, degFreedom: number): number;
+/**
+ * @name CHISQ.TEST
+ * @summary Returns the test for independence: the value from the chi-squared distribution for the statistic and the appropriate degrees of freedom.
+ * @param actualRange is the range of data that contains observations to test against expected values.
+ * @param expectedRange is the range of data that contains the ratio of the product of row totals and column totals to the grand total.
+ */
+export declare function CHISQ_TEST(actualRange: AcceptError<IRange>, expectedRange: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns the test for independence: the value from the chi-squared distribution for the statistic and the appropriate degrees of freedom.
+ * @param actualRange is the range of data that contains observations to test against expected values.
+ * @param expectedRange is the range of data that contains the ratio of the product of row totals and column totals to the grand total.
+ * @category Compatibility
+ */
+export declare function CHITEST(actualRange: IRange, expectedRange: IRange): Scalar;
+/**
+ * @name CONFIDENCE.NORM
+ * @summary Returns the confidence interval for a population mean, using a normal distribution.
+ * @param alpha is the significance level used to compute the confidence level, a number greater than 0 and less than 1.
+ * @param standardDev is the population standard deviation for the data range and is assumed to be known. Standard_dev must be greater than 0.
+ * @param size is the sample size.
+ */
+export declare function CONFIDENCE_NORM(alpha: number, standardDev: number, size: number): number;
+/**
+ * @summary Returns the confidence interval for a population mean, using a normal distribution.
+ * @param alpha is the significance level used to compute the confidence level, a number greater than 0 and less than 1.
+ * @param standardDev is the population standard deviation for the data range and is assumed to be known. Standard_dev must be greater than 0.
+ * @param size is the sample size.
+ * @category Compatibility
+ */
+export declare function CONFIDENCE(alpha: number, standardDev: number, size: number): number;
+/**
+ * @name CONFIDENCE.T
+ * @summary Returns the confidence interval for a population mean, using a Student's T distribution.
+ * @param alpha is the significance level used to compute the confidence level, a number greater than 0 and less than 1.
+ * @param standardDev is the population standard deviation for the data range and is assumed to be known. Standard_dev must be greater than 0.
+ * @param size is the sample size.
+ */
+export declare function CONFIDENCE_T(alpha: number, standardDev: number, size: number): number;
+/**
+ * @summary Returns the correlation coefficient between two data sets.
+ * @param array1 is a cell range of values. The values should be numbers, names, arrays, or references that contain numbers.
+ * @param array2 is a second cell range of values. The values should be numbers, names, arrays, or references that contain numbers.
+ */
+export declare function CORREL(array1: AcceptError<IRange>, array2: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns population covariance, the average of the products of deviations for each data point pair in two data sets.
+ * @param array1 is the first cell range of integers and must be numbers, arrays, or references that contain numbers.
+ * @param array2 is the second cell range of integers and must be numbers, arrays, or references that contain numbers.
+ * @category Compatibility
+ *
+ */
+export declare function COVAR(array1: AcceptError<IRange>, array2: AcceptError<IRange>): Scalar;
+/**
+ * @name COVARIANCE.P
+ * @summary Returns population covariance, the average of the products of deviations for each data point pair in two data sets.
+ * @param array1 is the first cell range of integers and must be numbers, arrays, or references that contain numbers.
+ * @param array2 is the second cell range of integers and must be numbers, arrays, or references that contain numbers.
+ */
+export declare function COVARIANCE_P(array1: AcceptError<IRange>, array2: AcceptError<IRange>): Scalar;
+/**
+ * @name COVARIANCE.S
+ * @summary Returns sample covariance, the average of the products of deviations for each data point pair in two data sets.
+ * @param array1 is the first cell range of integers and must be numbers, arrays, or references that contain numbers.
+ * @param array2 is the second cell range of integers and must be numbers, arrays, or references that contain numbers.
+ */
+export declare function COVARIANCE_S(array1: AcceptError<IRange>, array2: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.
+ * @param trials is the number of Bernoulli trials.
+ * @param probabilityS is the probability of success on each trial, a number between 0 and 1 inclusive.
+ * @param alpha is the criterion value, a number between 0 and 1 inclusive.
+ * @category Compatibility
+ */
+export declare function CRITBINOM(trials: number, probabilityS: number, alpha: number): number;
+/**
+ * @summary Returns the sum of squares of deviations of data points from their sample mean.
+ * @param number are 1 to 255 arguments, or an array or array reference, on which you want DEVSQ to calculate.
+ */
+export declare function DEVSQ(number: IRange<number>[]): number;
+/**
+ * @name EXPON.DIST
+ * @summary Returns the exponential distribution.
+ * @param x is the value of the function, a nonnegative number.
+ * @param lambda is the parameter value, a positive number.
+ * @param cumulative is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.
+ */
+export declare function EXPON_DIST(x: number, lambda: number, cumulative: boolean): number;
+/**
+ * @summary Returns the exponential distribution.
+ * @param x is the value of the function, a nonnegative number.
+ * @param lambda is the parameter value, a positive number.
+ * @param cumulative is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.
+ * @category Compatibility
+ */
+export declare function EXPONDIST(x: number, lambda: number, cumulative: boolean): number;
+/**
+ * @name F.DIST
+ * @summary Returns the (left-tailed) F probability distribution (degree of diversity) for two data sets.
+ * @param x is the value at which to evaluate the function, a nonnegative number.
+ * @param degFreedom1 is the numerator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param degFreedom2 is the denominator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param cumulative is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.
+ */
+export declare function F_DIST(x: number, degFreedom1: number, degFreedom2: number, cumulative: boolean): number;
+/**
+ * @summary Returns the (right-tailed) F probability distribution (degree of diversity) for two data sets.
+ * @param x is the value at which to evaluate the function, a nonnegative number.
+ * @param degFreedom1 is the numerator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param degFreedom2 is the denominator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @category Compatibility
+ */
+export declare function FDIST(x: number, degFreedom1: number, degFreedom2: number): number;
+/**
+ * @name F.DIST.RT
+ * @summary Returns the (right-tailed) F probability distribution (degree of diversity) for two data sets.
+ * @param x is the value at which to evaluate the function, a nonnegative number.
+ * @param degFreedom1 is the numerator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param degFreedom2 is the denominator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ */
+export declare function F_DIST_RT(x: number, degFreedom1: number, degFreedom2: number): number;
+/**
+ * @name F.INV
+ * @summary Returns the inverse of the (left-tailed) F probability distribution: if p = F.DIST(x,...), then F.INV(p,...) = x
+ * @param probability is a probability associated with the F cumulative distribution, a number between 0 and 1 inclusive.
+ * @param degFreedom1 is the numerator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param degFreedom2 is the denominator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ */
+export declare function F_INV(probability: number, degFreedom1: number, degFreedom2: number): number;
+/**
+ * @summary Returns the inverse of the (right-tailed) F probability distribution: if p = FDIST(x,...), then FINV(p,...) = x.
+ * @param probability is a probability associated with the F cumulative distribution, a number between 0 and 1 inclusive.
+ * @param degFreedom1 is the numerator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param degFreedom2 is the denominator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @category Compatibility
+ */
+export declare function FINV(probability: number, degFreedom1: number, degFreedom2: number): number;
+/**
+ * @name F.INV.RT
+ * @summary Returns the inverse of the (right-tailed) F probability distribution: if p = F.DIST.RT(x,...), then F.INV.RT(p,...) = x.
+ * @param probability is a probability associated with the F cumulative distribution, a number between 0 and 1 inclusive.
+ * @param degFreedom1 is the numerator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ * @param degFreedom2 is the denominator degrees of freedom, a number between 1 and 10^10, excluding 10^10.
+ */
+export declare function F_INV_RT(probability: number, degFreedom1: number, degFreedom2: number): number;
+/**
+ * @name F.TEST
+ * @summary Returns the result of an F-test, the two-tailed probability that the variances in Array1 and Array2 are not significantly different.
+ * @param array1 is the first array or range of data and can be numbers or names, arrays, or references that contain numbers (blanks are ignored).
+ * @param array2 is the second array or range of data and can be numbers or names, arrays, or references that contain numbers (blanks are ignored).
+ *
+ * @help https://en.wikipedia.org/wiki/F-test_of_equality_of_variances
+ */
+export declare function F_TEST(array1: IRange, array2: IRange): Scalar;
+/**
+ * @summary Returns the result of an F-test, the two-tailed probability that the variances in Array1 and Array2 are not significantly different.
+ * @param array1 is the first array or range of data and can be numbers or names, arrays, or references that contain numbers (blanks are ignored).
+ * @param array2 is the second array or range of data and can be numbers or names, arrays, or references that contain numbers (blanks are ignored).
+ * @category Compatibility
+ */
+export declare function FTEST(array1: IRange, array2: IRange): Scalar;
+/**
+ * @summary Returns the Fisher transformation.
+ * @param x is the value for which you want the transformation, a number between -1 and 1, excluding -1 and 1.
+ */
+export declare function FISHER(x: number): number;
+/**
+ * @summary Returns the inverse of the Fisher transformation: if y = FISHER(x), then FISHERINV(y) = x.
+ * @param y is the value for which you want to perform the inverse of the transformation.
+ */
+export declare function FISHERINV(y: number): number;
+/**
+ * @summary Calculates, or predicts, a future value along a linear trend by using existing values.
+ * @param x is the data point for which you want to predict a value and must be a numeric value.
+ * @param knownYs is the dependent array or range of numeric data.
+ * @param knownXs is the independent array or range of numeric data. The variance of Known_x's must not be zero.
+ * @category Compatibility
+ */
+export declare function FORECAST(x: number, knownYs: AcceptError<IRange>, knownXs: AcceptError<IRange>): Scalar;
+/**
+ * @name FORECAST.LINEAR
+ * @summary Calculates, or predicts, a future value along a linear trend by using existing values.
+ * @param x is the data point for which you want to predict a value and must be a numeric value.
+ * @param knownYs is the dependent array or range of numeric data.
+ * @param knownXs is the independent array or range of numeric data. The variance of Known_x's must not be zero.
+ */
+export declare function FORECAST_LINEAR(x: number, knownYs: AcceptError<IRange>, knownXs: AcceptError<IRange>): Scalar;
+/**
+ * @summary Calculates how often values occur within a range of values and then returns a vertical array of numbers having one more element than Bins_array.
+ * @param dataArray is an array of or reference to a set of values for which you want to count frequencies (blanks and text are ignored).
+ * @param binsArray is an array of or reference to intervals into which you want to group the values in data_array.
+ */
+export declare function FREQUENCY(dataArray: IRange, binsArray: IRange): number[][];
+/**
+ * @summary Returns the Gamma function value.
+ * @param x is the value for which you want to calculate Gamma.
+ */
+export declare function GAMMA(x: number): number;
+/**
+ * @name GAMMA.DIST
+ * @summary Returns the gamma distribution.
+ * @param x is the value at which you want to evaluate the distribution, a nonnegative number.
+ * @param alpha is a parameter to the distribution, a positive number.
+ * @param beta is a parameter to the distribution, a positive number. If beta = 1, GAMMA.DIST returns the standard gamma distribution.
+ * @param cumulative is a logical value: return the cumulative distribution function = TRUE; return the probability mass function = FALSE.
+ */
+export declare function GAMMA_DIST(x: number, alpha: number, beta: number, cumulative: boolean): number;
+/**
+ * @summary Returns the gamma distribution.
+ * @param x is the value at which you want to evaluate the distribution, a nonnegative number.
+ * @param alpha is a parameter to the distribution, a positive number.
+ * @param beta is a parameter to the distribution, a positive number. If beta = 1, GAMMADIST returns the standard gamma distribution.
+ * @param cumulative is a logical value: return the cumulative distribution function = TRUE; return the probability mass function = FALSE.
+ * @category Compatibility
+ */
+export declare function GAMMADIST(x: number, alpha: number, beta: number, cumulative: boolean): number;
+/**
+ * @name GAMMA.INV
+ * @summary Returns the inverse of the gamma cumulative distribution: if p = GAMMA.DIST(x,...), then GAMMA.INV(p,...) = x.
+ * @param probability is the probability associated with the gamma distribution, a number between 0 and 1, inclusive.
+ * @param alpha is a parameter to the distribution, a positive number.
+ * @param beta is a parameter to the distribution, a positive number. If beta = 1, GAMMA.DIST returns the standard gamma distribution.
+ */
+export declare function GAMMA_INV(probability: number, alpha: number, beta: number): number;
+/**
+ * @summary Returns the inverse of the gamma cumulative distribution: if p = GAMMADIST(x,...), then GAMMAINV(p,...) = x.
+ * @param probability is the value at which you want to evaluate the distribution, a nonnegative number.
+ * @param alpha is a parameter to the distribution, a positive number.
+ * @param beta is a parameter to the distribution, a positive number. If beta = 1, GAMMAINV returns the standard gamma distribution.
+ * @category Compatibility
+ */
+export declare function GAMMAINV(probability: number, alpha: number, beta: number): number;
+/**
+ * @summary Returns the natural logarithm of the gamma function.
+ * @param x is the value for which you want to calculate GAMMALN, a positive number.
+ */
+export declare function GAMMALN(x: number): number;
+/**
+ * @name GAMMALN.PRECISE
+ * @summary Returns the natural logarithm of the gamma function.
+ * @param x is the value for which you want to calculate GAMMALN.PRECISE, a positive number.
+ */
+export declare function GAMMALN_PRECISE(x: number): number;
+/**
+ * @summary Returns 0.5 less than the standard normal cumulative distribution.
+ * @param x is the value for which you want the distribution.
+ */
+export declare function GAUSS(x: number): number;
+/**
+ * @summary Returns the geometric mean of an array or range of positive numeric data.
+ * @param number are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the mean.
+ */
+export declare function GEOMEAN(number: IRange<number>[]): number;
+/**
+ * @summary Returns the harmonic mean of a data set of positive numbers: the reciprocal of the arithmetic mean of reciprocals.
+ * @param number are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the harmonic mean.
+ */
+export declare function HARMEAN(number: IRange<number>[]): number;
+/**
+ * @name HYPGEOM.DIST
+ * @summary Returns the hypergeometric distribution.
+ * @param sampleS is the number of successes in the sample.
+ * @param numberSample is the size of the sample.
+ * @param populationS is the number of successes in the population.
+ * @param numberPop is the population size.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
+ */
+export declare function HYPGEOM_DIST(sampleS: number, numberSample: number, populationS: number, numberPop: number, cumulative: boolean): number;
+/**
+ * @summary Returns the hypergeometric distribution.
+ * @param sampleS is the number of successes in the sample.
+ * @param numberSample is the size of the sample.
+ * @param populationS is the number of successes in the population.
+ * @param numberPop is the population size.
+ * @category Compatibility
+ */
+export declare function HYPGEOMDIST(sampleS: number, numberSample: number, populationS: number, numberPop: number): number;
+/**
+ * @summary Calculates the point at which a line will intersect the y-axis by using a best-fit regression line plotted through the known x-values and y-values.
+ * @param knownYs is the dependent set of observations or data and can be numbers or names, arrays, or references that contain numbers.
+ * @param knownXs is the independent set of observations or data and can be numbers or names, arrays, or references that contain numbers.
+ */
+export declare function INTERCEPT(knownYs: AcceptError<IRange>, knownXs: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns the kurtosis of a data set.
+ * @param number are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the kurtosis.
+ */
+export declare function KURT(number: IRange<number>[]): number;
+/**
+ * @name LOGNORM.DIST
+ * @summary Returns the lognormal distribution of x, where ln(x) is normally distributed with parameters Mean and Standard_dev.
+ * @param x is the value at which to evaluate the function, a positive number.
+ * @param mean is the mean of ln(x).
+ * @param standardDev is the standard deviation of ln(x), a positive number.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
+ */
+export declare function LOGNORM_DIST(x: number, mean: number, standardDev: number, cumulative: boolean): number;
+/**
+ * @summary Returns the cumulative lognormal distribution of x, where ln(x) is normally distributed with parameters Mean and Standard_dev.
+ * @param x is the value at which to evaluate the function, a positive number.
+ * @param mean is the mean of ln(x).
+ * @param standardDev is the standard deviation of ln(x), a positive number.
+ * @category Compatibility
+ */
+export declare function LOGNORMDIST(x: number, mean: number, standardDev: number): number;
+/**
+ * @name LOGNORM.INV
+ * @summary Returns the inverse of the lognormal cumulative distribution function of x, where ln(x) is normally distributed with parameters Mean and Standard_dev.
+ * @param probability is a probability associated with the lognormal distribution, a number between 0 and 1, inclusive.
+ * @param mean is the mean of ln(x).
+ * @param standardDev is the standard deviation of ln(x), a positive number.
+ */
+export declare function LOGNORM_INV(probability: number, mean: number, standardDev: number): number;
+/**
+ * @summary Returns the inverse of the lognormal normal distribution function of x, where ln(x) is normally distributed with parameters Mean and Standard_dev.
+ * @param probability is a probability associated with the lognormal distribution, a number between 0 and 1, inclusive.
+ * @param mean is the mean of ln(x).
+ * @param standardDev is the standard deviation of ln(x), a positive number.
+ * @category Compatibility
+ */
+export declare function LOGINV(probability: number, mean: number, standardDev: number): number;
+/**
+ * @name MODE
+ * @summary Returns the most frequently occurring, or repetitive, value in an array or range of data.
+ * @param number numbers or names, arrays, or references that contain numbers for which you want to find the mode.
+ * @category Compatibility
+ */
+export declare function MODE(number: IRange[]): Scalar;
+/**
+ * @name MODE.MULT
+ * @summary Returns a vertical array of the most frequently occurring, or repetitive, values in an array or range of data.  For a horizontal array, use =TRANSPOSE(MODE.MULT(number1,number2,...)).
+ * @param number numbers or names, arrays, or references that contain numbers for which you want to find the mode..
+ */
+export declare function MODE_MULT(number: IRange[]): number[][];
+/**
+ * @name MODE.SNGL
+ * @summary Returns the most frequently occurring, or repetitive, value in an array or range of data.
+ * @param number numbers or names, arrays, or references that contain numbers for which you want to find the mode.
+ */
+export declare function MODE_SNGL(number: IRange[]): Scalar;
+/**
+ * @name NEGBINOM.DIST
+ * @summary Returns the negative binomial distribution, the probability that there will be Number_f failures before the Number_s-th success, with Probability_s probability of a success.
+ * @param numberF is the number of failures.
+ * @param numberS is the threshold number of successes.
+ * @param probabilityS is the probability of a success; a number between 0 and 1.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.
+ */
+export declare function NEGBINOM_DIST(numberF: number, numberS: number, probabilityS: number, cumulative: boolean): number;
+/**
+ * @summary Returns the negative binomial distribution, the probability that there will be Number_f failures before the Number_s-th success, with Probability_s probability of a success.
+ * @param numberF is the number of failures.
+ * @param numberS is the threshold number of successes.
+ * @param probabilityS is the probability of a success; a number between 0 and 1.
+ * @category Compatibility
+ */
+export declare function NEGBINOMDIST(numberF: number, numberS: number, probabilityS: number): number;
+/**
+ * @name NORM.DIST
+ * @summary Returns the normal distribution for the specified mean and standard deviation.
+ * @param x is the value for which you want the distribution.
+ * @param mean is the arithmetic mean of the distribution.
+ * @param standardDev is the standard deviation of the distribution, a positive number.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
+ */
+export declare function NORM_DIST(x: number, mean: number, standardDev: number, cumulative: boolean): number;
+/**
+ * @summary Returns the normal distribution for the specified mean and standard deviation.
+ * @param x is the value for which you want the distribution.
+ * @param mean is the arithmetic mean of the distribution.
+ * @param standardDev is the standard deviation of the distribution, a positive number.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
+ * @category Compatibility
+ */
+export declare function NORMDIST(x: number, mean: number, standardDev: number, cumulative: boolean): number;
+/**
+ * @name NORM.INV
+ * @summary Returns the inverse of the normal cumulative distribution for the specified mean and standard deviation.
+ * @param probability is a probability corresponding to the normal distribution, a number between 0 and 1 inclusive.
+ * @param mean is the arithmetic mean of the distribution.
+ * @param standardDev is the standard deviation of the distribution, a positive number.
+ */
+export declare function NORM_INV(probability: number, mean: number, standardDev: number): number;
+/**
+ * @summary Returns the inverse of the normal distribution function for the specified mean and standard deviation.
+ * @param probability is a probability associated with the normal distribution, a number between 0 and 1, inclusive.
+ * @param mean is the mean of the distribution.
+ * @param standardDev is the standard deviation of the distribution, a positive number.
+ * @category Compatibility
+ */
+export declare function NORMINV(probability: number, mean: number, standardDev: number): number;
+/**
+ * @name NORM.S.DIST
+ * @summary Returns the standard normal distribution (has a mean of zero and a standard deviation of one).
+ * @param z is the value for which you want the distribution.
+ * @param cumulative is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.
+ */
+export declare function NORM_S_DIST(z: number, cumulative: boolean): number;
+/**
+ * @summary Returns the standard normal cumulative distribution (has a mean of zero and a standard deviation of one).
+ * @param z is the value for which you want the distribution.
+ * @category Compatibility
+ */
+export declare function NORMSDIST(z: number): number;
+/**
+ * @name NORM.S.INV
+ * @summary Returns the inverse of the standard normal cumulative distribution (has a mean of zero and a standard deviation of one).
+ * @param probability is a probability corresponding to the normal distribution, a number between 0 and 1 inclusive.
+ */
+export declare function NORM_S_INV(probability: number): number;
+/**
+ * @summary Returns the inverse of the standard normal cumulative distribution (has a mean of zero and a standard deviation of one).
+ * @param probability is a probability corresponding to the normal distribution, a number between 0 and 1 inclusive.
+ * @category Compatibility
+ */
+export declare function NORMSINV(probability: number): number;
+/**
+ * @summary Returns the Pearson product moment correlation coefficient, r.
+ * @param array1 is a set of independent values.
+ * @param array2 is a set of dependent values.
+ */
+export declare function PEARSON(array1: AcceptError<IRange>, array2: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns the k-th percentile of values in a range, where k is in the range 0..1, inclusive.
+ * @param array is the array or range of data that defines relative standing.
+ * @param k is the percentile value that is between 0 through 1, inclusive.
+ * @category Compatibility
+ */
+export declare function PERCENTILE(array: IRange, k: number): number;
+/**
+ * @name PERCENTILE.EXC
+ * @summary Returns the k-th percentile of values in a range, where k is in the range 0..1, exclusive.
+ * @param array is the array or range of data that defines relative standing.
+ * @param k is the percentile value that is between 0 through 1, exclusive (must satisfy 1/(n+1) <= k <= n/(n+1)).
+ */
+export declare function PERCENTILE_EXC(array: IRange, k: number): number;
+/**
+ * @name PERCENTILE.INC
+ * @summary Returns the k-th percentile of values in a range, where k is in the range 0..1, inclusive.
+ * @param array is the array or range of data that defines relative standing.
+ * @param k is the percentile value that is between 0 through 1, inclusive.
+ */
+export declare function PERCENTILE_INC(array: IRange, k: number): number;
+/**
+ * @name PERCENTRANK
+ * @summary Returns the rank of a value in a data set as a percentage (0..1, inclusive) of the data set.
+ * @param array is the array or range of data with numeric values that defines relative standing.
+ * @param x is the value for which you want to know the rank.
+ * @param significance is the number of decimal places to truncate the percentage to, at least 1. Defaults to 3.
+ * @category Compatibility
+ */
+export declare function PERCENTRANK(array: IRange, x: number, significance?: Omittable<number>): Scalar;
+/**
+ * @name PERCENTRANK.EXC
+ * @summary Returns the rank of a value in a data set as a percentage (0..1, exclusive) of the data set.
+ * @param array is the array or range of data with numeric values that defines relative standing.
+ * @param x is the value for which you want to know the rank.
+ * @param significance is the number of decimal places to truncate the percentage to, at least 1. Defaults to 3.
+ */
+export declare function PERCENTRANK_EXC(array: IRange, x: number, significance?: Omittable<number>): Scalar;
+/**
+ * @name PERCENTRANK.INC
+ * @summary Returns the rank of a value in a data set as a percentage (0..1, inclusive) of the data set.
+ * @param array is the array or range of data with numeric values that defines relative standing.
+ * @param x is the value for which you want to know the rank.
+ * @param significance is the number of decimal places to truncate the percentage to, at least 1. Defaults to 3.
+ */
+export declare function PERCENTRANK_INC(array: IRange, x: number, significance?: Omittable<number>): Scalar;
+/**
+ * @summary Returns the value of the density function for a standard normal distribution.
+ * @param x is the number for which you want the density of the standard normal distribution.
+ */
+export declare function PHI(x: number): number;
+/**
+ * @name POISSON.DIST
+ * @summary Returns the Poisson distribution.
+ * @param x is the number of events.
+ * @param mean is the expected numeric value, a positive number.
+ * @param cumulative is a logical value: for the cumulative Poisson probability, use TRUE; for the Poisson probability mass function, use FALSE.
+ */
+export declare function POISSON_DIST(x: number, mean: number, cumulative: boolean): number;
+/**
+ * @summary Returns the Poisson distribution.
+ * @param x is the number of events.
+ * @param mean is the expected numeric value, a positive number.
+ * @param cumulative is a logical value: for the cumulative Poisson probability, use TRUE; for the Poisson probability mass function, use FALSE.
+ * @category Compatibility
+ */
+export declare function POISSON(x: number, mean: number, cumulative: boolean): number;
+/**
+ * @summary Returns the probability that values in a range are between two limits or equal to a lower limit.
+ * @param xRange is the range of numeric values of x with which there are associated probabilities.
+ * @param probRange is the set of probabilities associated with values in X_range, values between 0 and 1 and excluding 0.
+ * @param lowerLimit is the lower bound on the value for which you want a probability.
+ * @param upperLimit is the optional upper bound on the value. If omitted, PROB returns the probability that X_range values are equal to Lower_limit.
+ */
+export declare function PROB(xRange: AcceptError<IRange>, probRange: AcceptError<IRange>, lowerLimit: number, upperLimit?: Omittable<number>): Scalar;
+/**
+ * @summary Returns the quartile of a data set, based on percentile values from 0..1, inclusive.
+ * @param array is the array or cell range of numeric values for which you want the quartile value.
+ * @param quart is a number: minimum value = 0; 1st quartile = 1; median value = 2; 3rd quartile = 3; maximum value = 4.
+ * @category Compatibility
+ */
+export declare function QUARTILE(array: IRange, quart: number): number;
+/**
+ * @name QUARTILE.EXC
+ * @summary Returns the quartile of a data set, based on percentile values from 0..1, exclusive.
+ * @param array is the array or cell range of numeric values for which you want the quartile value.
+ * @param quart is a number: 1st quartile = 1; median value = 2; 3rd quartile = 3 (0 and 4 are invalid for EXC).
+ */
+export declare function QUARTILE_EXC(array: IRange, quart: number): number;
+/**
+ * @name QUARTILE.INC
+ * @summary Returns the quartile of a data set, based on percentile values from 0..1, inclusive.
+ * @param array is the array or cell range of numeric values for which you want the quartile value.
+ * @param quart is a number: minimum value = 0; 1st quartile = 1; median value = 2; 3rd quartile = 3; maximum value = 4.
+ */
+export declare function QUARTILE_INC(array: IRange, quart: number): number;
+/**
+ * @name RANK
+ * @summary Returns the rank of a number in a list of numbers. Legacy alias for RANK.EQ.
+ * @param number is the number for which you want to find the rank.
+ * @param ref is an array of, or a reference to, a list of numbers. Nonnumeric values are ignored.
+ * @param order is a number: 0 or omitted ranks largest value as 1 (descending); any other value ranks smallest as 1 (ascending).
+ * @category Compatibility
+ */
+export declare function RANK(number: number, ref: IRange, order?: number): Scalar;
+/**
+ * @name RANK.AVG
+ * @summary Returns the rank of a number in a list of numbers. Tied values receive the average of the rank positions they span.
+ * @param number is the number for which you want to find the rank.
+ * @param ref is an array of, or a reference to, a list of numbers. Nonnumeric values are ignored.
+ * @param order is a number: 0 or omitted ranks largest value as 1 (descending); any other value ranks smallest as 1 (ascending).
+ */
+export declare function RANK_AVG(number: number, ref: IRange, order?: number): Scalar;
+/**
+ * @name RANK.EQ
+ * @summary Returns the rank of a number in a list of numbers. Tied values all receive the top rank of that set.
+ * @param number is the number for which you want to find the rank.
+ * @param ref is an array of, or a reference to, a list of numbers. Nonnumeric values are ignored.
+ * @param order is a number: 0 or omitted ranks largest value as 1 (descending); any other value ranks smallest as 1 (ascending).
+ */
+export declare function RANK_EQ(number: number, ref: IRange, order?: number): Scalar;
+/**
+ * @summary Returns the square of the Pearson product moment correlation coefficient through the given data points.
+ * @param knownYs is an array or range of data points and can be numbers or names, arrays, or references that contain numbers.
+ * @param knownXs is an array or range of data points and can be numbers or names, arrays, or references that contain numbers.
+ */
+export declare function RSQ(knownYs: AcceptError<IRange>, knownXs: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns the skewness of a distribution: a characterization of the degree of asymmetry of a distribution around its mean.
+ * @param number are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the skewness.
+ */
+export declare function SKEW(number: IRange[]): Scalar;
+/**
+ * @name SKEW.P
+ * @summary Returns the skewness of a distribution based on a population: a characterization of the degree of asymmetry of a distribution around its mean.
+ * @param number are 1 to 254 numbers or names, arrays, or references that contain numbers for which you want the population skewness.
+ */
+export declare function SKEW_P(number: IRange[]): Scalar;
+/**
+ * @summary Returns the slope of the linear regression line through the given data points.
+ * @param knownYs is an array or cell range of numeric dependent data points and can be numbers or names, arrays, or references that contain numbers.
+ * @param knownXs iis the set of independent data points and can be numbers or names, arrays, or references that contain numbers.
+ */
+export declare function SLOPE(knownYs: AcceptError<IRange>, knownXs: AcceptError<IRange>): Scalar;
+/**
+ * @summary Returns a normalized value from a distribution characterized by a mean and standard deviation.
+ * @param x is the value you want to normalize.
+ * @param mean is the arithmetic mean of the distribution.
+ * @param standardDev is the standard deviation of the distribution, a positive number.
+ */
+export declare function STANDARDIZE(x: number, mean: number, standardDev: number): number;
+/**
+ * @name STDEV.S
+ * @summary Estimates standard deviation based on a sample (ignores logical values and text in the sample).
+ * @param number are 1 to 255 numbers corresponding to a sample of a population and can be numbers or references that contain numbers.
+ */
+export declare function STDEV_S(number: IRange<number>[]): number;
+/**
+ * @summary Estimates standard deviation based on a sample, ignoring logical values and text in the sample.
+ * @param number are 1 to 255 numbers corresponding to a sample of a population and can be numbers or references that contain numbers.
+ * @category Compatibility
+ */
+export declare function STDEV(number: IRange<number>[]): number;
+/**
+ * @name STDEV.P
+ * @summary Calculates standard deviation based on the entire population given as arguments (ignores logical values and text).
+ * @param number are 1 to 255 numbers corresponding to a population and can be numbers or references that contain numbers.
+ */
+export declare function STDEV_P(number: IRange<number>[]): number;
+/**
+ * @summary Calculates standard deviation based on the entire population given as arguments (ignores logical values and text).
+ * @param number are 1 to 255 numbers corresponding to a population and can be numbers or references that contain numbers.
+ * @category Compatibility
+ */
+export declare function STDEVP(number: IRange<number>[]): number;
+/**
+ * @summary Estimates standard deviation based on a sample, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE have the value 1.
+ * @param value are 1 to 255 values corresponding to a sample of a population and can be values or names or references to values.
+ */
+export declare function STDEVA(value: IRange[]): number;
+/**
+ * @summary Calculates standard deviation based on an entire population, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE have the value 1.
+ * @param value are 1 to 255 values corresponding to a population and can be values, names, arrays, or references that contain values.
+ */
+export declare function STDEVPA(value: IRange[]): number;
+/**
+ * @summary Returns the standard error of the predicted y-value for each x in a regression.
+ * @param knownYs is an array or range of dependent data points and can be numbers or names, arrays, or references that contain numbers.
+ * @param knownXs is an array or range of independent data points and can be numbers or names, arrays, or references that contain numbers.
+ */
+export declare function STEYX(knownYs: AcceptError<IRange>, knownXs: AcceptError<IRange>): Scalar;
+/**
+ * @name T.DIST
+ * @summary Returns the left-tailed Student's t-distribution.
+ * @param x is the numeric value at which to evaluate the distribution.
+ * @param degFreedom is an integer indicating the number of degrees of freedom that characterize the distribution.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
+ */
+export declare function T_DIST(x: number, degFreedom: number, cumulative: boolean): number;
+/**
+ * @summary Returns the Student's t-distribution: the right-tailed probability for tails = 1, twice that for tails = 2.
+ * @param x is the numeric value at which to evaluate the distribution, a nonnegative number.
+ * @param degFreedom is an integer indicating the number of degrees of freedom that characterize the distribution.
+ * @param tails is the number of distribution tails to return. If tails = 1, TDIST returns the one-tailed distribution; if tails = 2, TDIST returns the two-tailed distribution.
+ * @category Compatibility
+ */
+export declare function TDIST(x: number, degFreedom: number, tails: number): number;
+/**
+ * @name T.DIST.2T
+ * @summary Returns the two-tailed Student's t-distribution.
+ * @param x is the numeric value at which to evaluate the distribution.
+ * @param degFreedom is an integer indicating the number of degrees of freedom that characterize the distribution.
+ */
+export declare function T_DIST_2T(x: number, degFreedom: number): number;
+/**
+ * @name T.DIST.RT
+ * @summary Returns the right-tailed Student's t-distribution.
+ * @param x is the numeric value at which to evaluate the distribution.
+ * @param degFreedom is an integer indicating the number of degrees of freedom that characterize the distribution.
+ */
+export declare function T_DIST_RT(x: number, degFreedom: number): number;
+/**
+ * @name T.INV
+ * @summary Returns the left-tailed inverse of the Student's t-distribution.
+ * @param probability is the probability associated with the two-tailed Student's t-distribution, a number between 0 and 1 inclusive.
+ * @param degFreedom is a positive integer indicating the number of degrees of freedom to characterize the distribution.
+ */
+export declare function T_INV(probability: number, degFreedom: number): number;
+/**
+ * @summary Returns the two-tailed inverse of the Student's t-distribution.
+ * @param probability is the probability associated with the two-tailed Student's t-distribution, a number between 0 and 1 inclusive.
+ * @param degFreedom is a positive integer indicating the number of degrees of freedom to characterize the distribution.
+ * @category Compatibility
+ */
+export declare function TINV(probability: number, degFreedom: number): number;
+/**
+ * @name T.INV.2T
+ * @summary Returns the two-tailed inverse of the Student's t-distribution.
+ * @param probability is the probability associated with the two-tailed Student's t-distribution, a number between 0 and 1 inclusive.
+ * @param degFreedom is a positive integer indicating the number of degrees of freedom to characterize the distribution.
+ */
+export declare function T_INV_2T(probability: number, degFreedom: number): number;
+/**
+ * @summary Returns the mean of the interior portion of a set of data values.
+ * @param array is the range or array of values to trim and average.
+ * @param percent is the fractional number of data points to exclude from the top and bottom of the data set.
+ */
+export declare function TRIMMEAN(array: IRange, percent: number): Scalar;
+/**
+ * @name VAR.P
+ * @summary Calculates variance based on the entire population (ignores logical values and text in the population).
+ * @param number are 1 to 255 numeric arguments corresponding to a population.
+ */
+export declare function VAR_P(number: IRange<number>[]): number;
+/**
+ * @summary Calculates variance based on the entire population (ignores logical values and text in the population).
+ * @param number are 1 to 255 numeric arguments corresponding to a population.
+ * @category Compatibility
+ */
+export declare function VARP(number: IRange<number>[]): number;
+/**
+ * @name VAR.S
+ * @summary Estimates variance based on a sample (ignores logical values and text in the sample).
+ * @param number are 1 to 255 numeric arguments corresponding to a sample of a population.
+ */
+export declare function VAR_S(number: IRange<number>[]): number;
+/**
+ * @summary Estimates variance based on a sample (ignores logical values and text in the sample).
+ * @param number are 1 to 255 numeric arguments corresponding to a sample of a population.
+ * @category Compatibility
+ */
+export declare function VAR(number: IRange<number>[]): number;
+/**
+ * @summary Estimates variance based on a sample, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE have the value 1.
+ * @param value are 1 to 255 value arguments corresponding to a sample of a population.
+ */
+export declare function VARA(value: IRange<number>[]): number;
+/**
+ * @summary Calculates variance based on the entire population, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE have the value 1.
+ * @param value are 1 to 255 value arguments corresponding to a population.
+ */
+export declare function VARPA(value: IRange<number>[]): number;
+/**
+ * @name WEIBULL.DIST
+ * @summary Returns the Weibull distribution.
+ * @param x is the value at which to evaluate the function, a nonnegative number.
+ * @param alpha is a parameter to the distribution, a positive number.
+ * @param beta is a parameter to the distribution, a positive number.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.
+ */
+export declare function WEIBULL_DIST(x: number, alpha: number, beta: number, cumulative: boolean): number;
+/**
+ * @summary Returns the Weibull distribution.
+ * @param x is the value at which to evaluate the function, a nonnegative number.
+ * @param alpha is a parameter to the distribution, a positive number.
+ * @param beta is a parameter to the distribution, a positive number.
+ * @param cumulative is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.
+ * @category Compatibility
+ */
+export declare function WEIBULL(x: number, alpha: number, beta: number, cumulative: boolean): number;
+/**
+ * @name Z.TEST
+ * @summary Returns the one-tailed P-value of a z-test.
+ * @param array is the array or range of data against which to test X.
+ * @param x is the value to test.
+ * @param sigma is the population (known) standard deviation. If omitted, the sample standard deviation is used.
+ */
+export declare function Z_TEST(array: IRange, x: number, sigma?: number): number;
+/**
+ * @summary Returns the one-tailed P-value of a z-test.
+ * @param array is the array or range of data against which to test X.
+ * @param x is the value to test.
+ * @param sigma is the population (known) standard deviation. If omitted, the sample standard deviation is used.
+ * @category Compatibility
+ */
+export declare function ZTEST(array: IRange, x: number, sigma?: number): number;
+//# sourceMappingURL=Distribution.d.ts.map