ERF in Calligra Sheets: Error Function and Bounded Differences
Calculate the Gaussian error function with one or two inputs in Calligra Sheets; reproduce 13 numerical cases and check sign conventions.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
Quick answer
=ERF(1) has an independently expected result of 0.842700792950. The two-input =ERF(0;1) expects the same value because the inspected source computes erf(upper) - erf(lower). All results here are independent arithmetic expectations, not Calligra runtime observations. The exact function name and 1–2-argument registration appear in KDE’s pinned 26.08.2 source; details are confirmed with the calculation branch, XML function definition and official handbook. Source consultation: 2026-10-13.
Availability and version history
- First introduced: Introduction version not established.
- Current support: Registered in Calligra Sheets 26.08.2; see the function-specific source and official release listing. This is support evidence for that release, not a final supported version.
- Platform and retirement: The KDE application listing provides Linux installation. Other packaged platforms/builds and a retirement endpoint have not been established.
- Checked: October 14, 2026. Native test: Not executed in Calligra Sheets.
Examples use semicolons and decimal points, matching the English formula handbook. Numerical results were checked independently against the published implementation. Calligra itself was not run, so packaged-build behavior, locale handling and displayed errors remain untested.
Syntax, arguments and defaults
=ERF(x)
=ERF(lower;upper)
| Argument | Required / source type | Interpretation |
|---|---|---|
lower |
Required; documented Float | Single-input case evaluates erf(lower) relative to 0; with two inputs, the first is the lower bound. |
upper |
Optional in the registered function; numeric input | With two inputs, compute erf(upper)-erf(lower); omitting it selects the one-argument form; there is no default upper bound. |
The pinned registration permits one or two arguments, with an explicit alternate compatibility name COM.SUN.STAR.SHEET.ADDIN.ANALYSIS.GETERF. This is a compatibility spelling of the same registered function; use the shorter name in ordinary formulas. KDE’s engineering XML and C++ registration were checked separately.
Documentation mismatch: The XML’s second parameter is not marked optional, yet the pinned C++ accepts one argument and the handbook shows a one-argument example. Treat one-input support as documented/source-backed, not native-executed. Do not invent a default upper bound: a one-input call uses a distinct calculation branch rather than supplying an upper value.
Reproducible worksheet: 13 independently calculated cases
- Open a blank Calligra Sheets document. Enter
First input / valuein A1,Second input / bound (optional)in B1, andFormula resultin C1. Use D1 for notes if recording native observations later. Confirm the formula editor recognizes the=prefix and;separator in your locale. - Type the numeric values below into A2:B14. Rows labelled omit optional argument are intentionally single-argument formulas; leave the B cell blank and do not pass B in that row’s formula. The blank column cell alone is not a demonstrated default.
- Copy the displayed formula text for each row into the corresponding C cell. Each example uses its own references. Do not simply fill down a two-argument formula across single-argument rows.
- Format the output column to about 12 decimal places. Compare with the independent expected output column. The values are predictions derived outside Calligra, not screenshots or logs of native runs.
- If running the test independently, note Calligra version, operating system, locale and any observed errors; do not treat source predictions as proof that the application returned them.
| Row | A input | B input | Formula placed in C | Independently expected output |
|---|---|---|---|---|
| 2 | 0 | (blank; omit optional argument) | =ERF(A2) |
0 |
| 3 | 1 | (blank; omit optional argument) | =ERF(A3) |
0.84270079295 |
| 4 | -1 | (blank; omit optional argument) | =ERF(A4) |
-0.84270079295 |
| 5 | 0.4 | (blank; omit optional argument) | =ERF(A5) |
0.428392355047 |
| 6 | 0.5 | (blank; omit optional argument) | =ERF(A6) |
0.520499877813 |
| 7 | 2 | (blank; omit optional argument) | =ERF(A7) |
0.995322265019 |
| 8 | 0 | 1 | =ERF(A8;B8) |
0.84270079295 |
| 9 | -1 | 1 | =ERF(A9;B9) |
1.685401585899 |
| 10 | 1 | 2 | =ERF(A10;B10) |
0.152621472069 |
| 11 | 1 | 0 | =ERF(A11;B11) |
-0.84270079295 |
| 12 | -0.5 | 0.5 | =ERF(A12;B12) |
1.040999755626 |
| 13 | -2 | -1 | =ERF(A13;B13) |
0.152621472069 |
| 14 | 1.5 | (blank; omit optional argument) | =ERF(A14) |
0.966105146475 |
Mathematical meaning and important calling convention
For a real number x, the mathematical error function is erf(x) = (2/√π) ∫₀ˣ exp(-t²) dt. When the function receives one argument, the pinned source calls calc->erf(x); this is the ordinary error function. The independent values erf(0)=0, erf(1)≈0.842700792950 and erf(-1)≈-0.842700792950 illustrate symmetry around zero.
For two arguments, Calligra’s pinned source computes erf(upper) − erf(lower). Thus =ERF(0;1) has an independently calculated expected result of +0.842700792950, while =ERF(1;0) has the negative. It is a difference of error-function values, not just a call with a redundant parameter. Note this distinction when comparing against a probability model. KDE C++ branch.
Source versus manual nuance: The handbook and XML show ERF(Lower limit; Upper limit) and XML lists two required-looking <Parameter> nodes. Nonetheless, the same release C++ registers setParamCount(1,2) and the handbook explicitly gives a single-argument example ERF(0.4). The guide therefore accepts one or two arguments on the evidence of registration and example, but flags the XML’s missing optional marker; native formula-dialog acceptance remains untested. Function metadata; registration; manual.
Advanced examples and applications
Convert a standard-normal z-score into a CDF
The standard-normal CDF identity is Φ(z) = (1 + erf(z/√2))/2. To model z=1 using functions documented in Calligra Sheets, enter the conceptual expression =(1+ERF(1/SQRT(2)))/2. The independent mathematical result is 0.841344746069. This is a cross-check against probability mathematics, not a spreadsheet-executed combined-formula test. SQRT is documented separately; verify the entire formula in the installed application before relying on it. KDE SQRT handbook.
Compute a signed interval and reverse it
Using bounds from 0 to 1, =ERF(0;1) has an independent expected output of 0.842700792950. Reversing the limits to =ERF(1;0) gives −0.842700792950. This makes ERF useful for signed differences in the transformed error-function scale, but the sign is not automatically a probability.
Symmetric interval about zero
The mathematical identity erf(a)-erf(-a)=2erf(a) gives =ERF(-1;1) independently expected 1.685401585899. This can exceed 1; an interval difference of error-function values is not a probability until divided by an appropriate normalization such as 2 for a particular transformed-normal model. Avoid labeling every two-input ERF output a probability.
Troubleshooting and numerical limits
| Issue | Evidence and interpretation | Recommended check |
|---|---|---|
| One input appears undocumented by XML | XML’s second node lacks optional, but C++ allows 1–2 and handbook uses 1. |
Use the source-backed syntax and native-test installed version’s function dialog. |
| Reversing bounds changes sign | Two-input branch subtracts erf(lower) from erf(upper). |
Inspect column order; do not sort bounds without considering signs. |
| Expectation exceeds 1 | erf(1)-erf(-1)≈1.6854 is a valid mathematical difference. |
Do not treat it as a probability without a justified transformation. |
| Decimal display differs | math.erf is rounded to 12 places in this guide, while native numeric library may use other rounding. |
Compare with adequate precision and a practical tolerance. |
| Very large positive/negative inputs | Mathematical erf tends to +1 / −1, with loss of detail in saturated outputs. | Check whether a complementary or log-tail approach is numerically appropriate. |
| Text/blank/Boolean input | XML labels arguments Float; coercion and errors untested. |
Use numeric literals/validated number cells. |
| Wrong function/arity/locale | Name ERF, 1–2 args by C++; English examples use semicolons. |
Check local formula editor, installed version and separators. |
How ERF differs from ERFC
For a single argument x, erf(x) + erfc(x) = 1. Thus =ERF(1) is independently expected 0.842700792950 and =ERFC(1) 0.157299207050. The two-argument source branch for ERFC has a different sign convention from ERF; do not assume every two-input ERF and ERFC pair sums to 1. See the ERFC reference and the pinned implementation before importing a two-input formula.
Sources and related functions
- Official ERF function entry
- 26.08.2 registration and argument count
- Function-specific parameter metadata
- Numerical helper: standard-library erf and erfc
These are documentation and source checks. All displayed results are independent expectations, not claims of an executed Calligra worksheet.