Loading documentation…
Loading documentation…
This page lists the 92 functions of the statistical family. Taxonomy/source: Statistical functions. The formula function contract has every family, the engine builds, and the evaluation limits.
All functions
| Function (aliases) | Engine | Contract |
|---|---|---|
AVERAGEAVG | Default + full | |
MIN | Default + full | |
MAX | Default + full | |
COUNT | Default + full | |
COUNTA | Default + full | |
COUNTIF | Default + full | |
COUNTIFS | Default + full | |
AVERAGEIF | Default + full | |
AVERAGEIFS | Default + full | |
MEDIAN | Default + full | |
MODE.SNGL | Default + full | |
LARGE | Default + full | |
SMALL | Default + full | |
RANK.EQ | Default + full | |
PERCENTILE.INC | Default + full | |
QUARTILE.INC | Default + full | |
STDEV.S | Default + full | |
STDEV.P | Default + full | |
VAR.S | Default + full | |
VAR.P | Default + full | |
GEOMEAN | Default + full | |
CORREL | Default + full | |
COVARIANCE.S | Default + full | |
COVARIANCE.P | Default + full | |
COUNTBLANK | Default + full | |
MAXIFS | Default + full | |
MINIFS | Default + full | |
NORM.DIST | Full only | |
NORM.INV | Full only | |
NORM.S.DIST | Full only | |
NORM.S.INV | Full only | |
T.DIST | Full only | |
T.DIST.2T | Full only | |
T.DIST.RT | Full only | |
T.INV | Full only | |
T.INV.2T | Full only | |
CHISQ.DIST | Full only | |
CHISQ.DIST.RT | Full only | |
CHISQ.INV | Full only | |
CHISQ.INV.RT | Full only | |
F.DIST | Full only | |
F.DIST.RT | Full only | |
F.INV | Full only | |
F.INV.RT | Full only | |
BINOM.DIST | Full only | |
POISSON.DIST | Full only | |
EXPON.DIST | Full only | |
GAMMA | Full only | |
GAMMALN | Full only | |
GAMMA.DIST | Full only | |
GAMMA.INV | Full only | |
BETA.DIST | Full only | |
BETA.INV | Full only | |
LOGNORM.DIST | Full only | |
LOGNORM.INV | Full only | |
WEIBULL.DIST | Full only | |
CONFIDENCE.NORM | Full only | |
CONFIDENCE.T | Full only | |
STANDARDIZE | Full only | |
FISHER | Full only | |
FISHERINV | Full only | |
PHI | Full only | |
GAUSS | Full only | |
AVEDEV | Full only | |
DEVSQ | Full only | |
HARMEAN | Full only | |
KURT | Full only | |
SKEW | Full only | |
SKEW.P | Full only | |
TRIMMEAN | Full only | |
PERCENTILE.EXC | Full only | |
QUARTILE.EXC | Full only | |
PERCENTRANK.INC | Full only | |
PERCENTRANK.EXC | Full only | |
RANK.AVG | Full only | |
PEARSON | Full only | |
RSQ | Full only | |
SLOPE | Full only | |
INTERCEPT | Full only | |
STEYX | Full only | |
FORECAST.LINEARFORECAST | Full only | |
FREQUENCY | Full only | |
MODE.MULT | Full only | |
GROWTH | Full only | |
LINEST | Full only | |
LOGEST | Full only | |
PERCENTILE | Full only | |
PERCENTRANK | Full only | |
PROB | Full only | |
QUARTILE | Full only | |
RANK | Full only | |
TREND | Full only |
Argument order, required/default state, accepted shapes, repetition, and return shape come directly from the inventory.
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
value | no | none | scalar, range, array, reference | zero-or-more |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
range | yes | none | range, array, reference | once |
criteria | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
rangeAndCriteria | yes | none | scalar, range, array, reference | paired |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
range | yes | none | range, array, reference | once |
criteria | yes | none | scalar, reference | once |
sumRange | no | range | range, array, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
sumRange | yes | none | range, array, reference | once |
rangeAndCriteria | yes | none | scalar, range, array, reference | paired |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
value | yes | none | scalar, range, array, reference | one-or-more |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
array | yes | none | range, array, reference | once |
k | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
number | yes | none | scalar, reference | once |
reference | yes | none | range, array, reference | once |
order | no | 0 | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
array | yes | none | range, array, reference | once |
fraction | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
array1 | yes | none | range, array, reference | once |
array2 | yes | none | range, array, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
value | yes | none | scalar, range, array, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
mean | yes | none | scalar, reference | once |
standardDeviation | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
probability | yes | none | scalar, reference | once |
mean | yes | none | scalar, reference | once |
standardDeviation | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
z | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
number | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
degreesFreedom | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
degreesFreedom | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
probability | yes | none | scalar, reference | once |
degreesFreedom | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
degreesFreedom1 | yes | none | scalar, reference | once |
degreesFreedom2 | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
degreesFreedom1 | yes | none | scalar, reference | once |
degreesFreedom2 | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
probability | yes | none | scalar, reference | once |
degreesFreedom1 | yes | none | scalar, reference | once |
degreesFreedom2 | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
successes | yes | none | scalar, reference | once |
trials | yes | none | scalar, reference | once |
probability | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
mean | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
lambda | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
alpha | yes | none | scalar, reference | once |
beta | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
probability | yes | none | scalar, reference | once |
alpha | yes | none | scalar, reference | once |
beta | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
alpha | yes | none | scalar, reference | once |
beta | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
lower | no | 0 | scalar, reference | once |
upper | no | 1 | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
probability | yes | none | scalar, reference | once |
alpha | yes | none | scalar, reference | once |
beta | yes | none | scalar, reference | once |
lower | no | 0 | scalar, reference | once |
upper | no | 1 | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
mean | yes | none | scalar, reference | once |
standardDeviation | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
probability | yes | none | scalar, reference | once |
mean | yes | none | scalar, reference | once |
standardDeviation | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
alpha | yes | none | scalar, reference | once |
beta | yes | none | scalar, reference | once |
cumulative | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
alpha | yes | none | scalar, reference | once |
standardDeviation | yes | none | scalar, reference | once |
size | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
mean | yes | none | scalar, reference | once |
standardDeviation | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
array | yes | none | range, array, reference | once |
percent | yes | none | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
array | yes | none | range, array, reference | once |
x | yes | none | scalar, reference | once |
significance | no | 3 | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
knownYs | yes | none | range, array, reference | once |
knownXs | yes | none | range, array, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
x | yes | none | scalar, reference | once |
knownYs | yes | none | range, array, reference | once |
knownXs | yes | none | range, array, reference | once |
Return shape: array.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
data | yes | none | range, array, reference | once |
bins | yes | none | range, array, reference | once |
Return shape: array.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
value | yes | none | scalar, range, array, reference | one-or-more |
Return shape: array.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
knownY | yes | none | range, array, reference | once |
knownX | no | 1,2,3,... | range, array, reference | once |
newX | no | knownX | range, array, reference | once |
const | no | true | scalar, reference | once |
Return shape: array.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
knownY | yes | none | range, array, reference | once |
knownX | no | 1,2,3,... | range, array, reference | once |
const | no | true | scalar, reference | once |
stats | no | false | scalar, reference | once |
Return shape: scalar.
| Argument | Required | Default | Accepts | Repetition |
|---|---|---|---|---|
xRange | yes | none | range, array, reference | once |
probRange | yes | none | range, array, reference | once |
lowerLimit | no | 0 | scalar, reference | once |
upperLimit | no | lowerLimit | scalar, reference | once |
These values are normative for the listed Sheetwrite subset. function-defined and contextual are explicit limitations: consult the formula guides' function-specific sections rather than assuming another spreadsheet's edge behavior.
| Dimension | Contract |
|---|---|
| shape | scalar: accepted range: accepted array: accepted broadcast: none result: scalar |
| coercion | blank: ignored text: ignored-in-ranges boolean: ignored-in-ranges error: propagate |
| text | case: not-applicable wildcard: not-applicable |
| environment | locale: invariant dateSystem: not-applicable |
| numeric | tolerance: binary64 domain: function-defined iteration: kind: none maximum: none |
| calculation | dependencies: tracked lazy: eager spill: scalar fill: relative-reference-rewrite copy: relative-reference-rewrite structuralRewrite: ast-reference-rewrite |
| persistence | snapshot: formula-source history: formula-source collaboration: formula-source xlsxSource: rewrite-on-structural-edit |
| Dimension | Contract |
|---|---|
| shape | scalar: accepted range: accepted array: accepted broadcast: pairwise result: scalar |
| coercion | blank: function-defined text: function-defined boolean: function-defined error: propagate |
| text | case: insensitive wildcard: supported |
| environment | locale: invariant dateSystem: function-defined |
| numeric | tolerance: binary64 domain: function-defined iteration: kind: none maximum: none |
| calculation | dependencies: tracked lazy: eager spill: scalar fill: relative-reference-rewrite copy: relative-reference-rewrite structuralRewrite: ast-reference-rewrite |
| persistence | snapshot: formula-source history: formula-source collaboration: formula-source xlsxSource: rewrite-on-structural-edit |
| Dimension | Contract |
|---|---|
| shape | scalar: accepted range: contextual array: contextual broadcast: none result: scalar |
| coercion | blank: zero text: number-if-parseable boolean: number error: propagate |
| text | case: not-applicable wildcard: not-applicable |
| environment | locale: invariant dateSystem: not-applicable |
| numeric | tolerance: binary64 domain: bounded iteration: kind: function-defined maximum: none |
| calculation | dependencies: tracked lazy: eager spill: scalar fill: relative-reference-rewrite copy: relative-reference-rewrite structuralRewrite: ast-reference-rewrite |
| persistence | snapshot: formula-source history: formula-source collaboration: formula-source xlsxSource: rewrite-on-structural-edit |
| Dimension | Contract |
|---|---|
| shape | scalar: accepted range: accepted array: accepted broadcast: none result: scalar |
| coercion | blank: ignored text: ignored-in-ranges boolean: ignored-in-ranges error: propagate |
| text | case: not-applicable wildcard: not-applicable |
| environment | locale: invariant dateSystem: not-applicable |
| numeric | tolerance: binary64 domain: function-defined iteration: kind: none maximum: none |
| calculation | dependencies: tracked lazy: eager spill: scalar fill: relative-reference-rewrite copy: relative-reference-rewrite structuralRewrite: ast-reference-rewrite |
| persistence | snapshot: formula-source history: formula-source collaboration: formula-source xlsxSource: rewrite-on-structural-edit |
| Dimension | Contract |
|---|---|
| shape | scalar: accepted range: accepted array: accepted broadcast: none result: contextual |
| coercion | blank: function-defined text: function-defined boolean: function-defined error: propagate |
| text | case: not-applicable wildcard: not-applicable |
| environment | locale: invariant dateSystem: not-applicable |
| numeric | tolerance: binary64 domain: function-defined iteration: kind: none maximum: none |
| calculation | dependencies: tracked lazy: eager spill: contextual fill: relative-reference-rewrite copy: relative-reference-rewrite structuralRewrite: ast-reference-rewrite |
| persistence | snapshot: formula-source history: formula-source collaboration: formula-source xlsxSource: rewrite-on-structural-edit |
| Dialect | Status |
|---|---|
| Microsoft Excel | documented |
| Google Sheets | unverified |
| OpenFormula | unverified |
Limitations: Google Sheets and OpenFormula results require producer evidence before compatibility is claimed.
| Dialect | Status |
|---|---|
| Microsoft Excel | documented |
| Google Sheets | unverified |
| OpenFormula | unverified |
Limitations: Available only in the optional @sheetwrite/formulas analysis build; default @sheetwrite/wasm returns #NAME?. Scalar binary64 evaluation, not array broadcasting or blanket spreadsheet parity. Domain validation and finite numerical convergence may return #NUM!.
| Dialect | Status |
|---|---|
| Microsoft Excel | documented |
| Google Sheets | unverified |
| OpenFormula | unverified |
Limitations: Available only in the optional @sheetwrite/formulas analysis build; default @sheetwrite/wasm returns #NAME?. Regression functions skip pairs where either value is not a number. PERCENTRANK results are truncated, not rounded, to the requested significant digits.
| Dialect | Status |
|---|---|
| Microsoft Excel | documented |
| Google Sheets | unverified |
| OpenFormula | unverified |
Limitations: Available only in the optional @sheetwrite/formulas analysis build; default @sheetwrite/wasm returns #NAME?.
| Layer | Status and source/evidence |
|---|---|
| Parser | implementedpackages/wasm/src/calc.rs |
| Evaluator | implementedpackages/wasm/src/eval/mod.rspackages/wasm/src/eval/functions.rs |
| Formula assist | implementedpackages/core/src/formula-assist.ts |
| Evidence | source-linkedpackages/wasm/src/tests.rspackages/core/test/formula-assist.test.ts |
| Layer | Status and source/evidence |
|---|---|
| Parser | implementedpackages/wasm/src/calc.rs |
| Evaluator | implementedpackages/wasm/src/eval/analysis/distributions.rs |
| Formula assist | implementedpackages/core/src/formula-assist.ts |
| Evidence | source-linkedscripts/formula-contract.test.ts |
| Layer | Status and source/evidence |
|---|---|
| Parser | implementedpackages/wasm/src/calc.rs |
| Evaluator | implementedpackages/wasm/src/eval/analysis/descriptive.rs |
| Formula assist | implementedpackages/core/src/formula-assist.ts |
| Evidence | source-linkedscripts/formula-contract.test.ts |
| Layer | Status and source/evidence |
|---|---|
| Parser | implementedpackages/wasm/src/calc.rs |
| Evaluator | implementedpackages/wasm/src/eval/analysis/regression.rs |
| Formula assist | implementedpackages/core/src/formula-assist.ts |
| Evidence | source-linkedpackages/wasm/src/eval/analysis/regression.rsscripts/formula-contract.test.ts |