FISHERINV Function (Gnumeric)
Learn the FISHERINV function in Gnumeric: Returns the inverse of the Fisher transformation.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in Gnumeric. How formula examples are checked
What FISHERINV does
Gnumeric’s FISHERINV reverses the Fisher z-transformation and is mathematically equivalent to the hyperbolic tangent for a real numeric input:
[r=\tanh(z)=\frac{\exp(2z)-1}{\exp(2z)+1}.]
The result falls between −1 and 1 for finite real z, making FISHERINV suitable for translating transformed correlation values or approximate confidence limits back onto the familiar correlation scale. FISHERINV does not perform statistical analysis of a data range by itself. The official Gnumeric Statistics reference identifies this purpose and lists FISHER and TANH as related functions. [S1]
Exact Gnumeric syntax
=FISHERINV(x)
| Argument | Required? | Type and meaning | Default |
|---|---|---|---|
x |
Yes | One numeric real Fisher-z input | None |
This function requires one argument, without optional parameters. Unlike FISHER, it has no documented requirement that its argument be between −1 and 1. For example, Gnumeric’s own upstream help gives =FISHERINV(2) as a sample expression. [S1, S3]
Independent reproducible calculations
Put the numbers in column A; enter each formula in another column.
| Cell input | Gnumeric formula | Expected result (10 decimals) |
|---|---|---|
A2 = 0 |
=FISHERINV(A2) |
0 |
A3 = 0.5 |
=FISHERINV(A3) |
0.4621171573 |
A4 = 1 |
=FISHERINV(A4) |
0.7615941560 |
A5 = 2 |
=FISHERINV(A5) |
0.9640275801 |
A6 = -2 |
=FISHERINV(A6) |
-0.9640275801 |
The values were independently calculated with the mathematical tanh function. They are predicted worksheet outputs rather than screenshots or native observations. Display decimal-place settings should not be confused with source accuracy or measurement precision. [S1, S3]
Round-trip check: transform and reverse
Set B2 = 0.75 and enter:
=FISHERINV(FISHER(B2))
Expected result: approximately 0.75. The intermediary value is FISHER(0.75) ≈ 0.9729550745276566. If you instead enter the rounded intermediary value 0.972955, the reverse result will only be approximately 0.75, because rounding has discarded information. [S1]
The direction of the operations matters: a correlation coefficient r goes into FISHER, while a transformed z goes into FISHERINV. Placing an already transformed value into FISHER a second time changes the statistic and may fail if its magnitude is at least 1.
Advanced practical case: confidence limits after transformation
Suppose a survey of 30 paired observations reports a sample Pearson correlation of 0.75. With the same statistical assumptions required for the usual large-sample Fisher-z approximation, construct an illustrative, approximate 95% interval:
| Cell | Meaning | Value |
|---|---|---|
B2 |
r, correlation |
0.75 |
B3 |
n, number of paired observations |
30 |
B4 |
Approximate multiplier | 1.96 |
B5 |
Fisher transformed coefficient | =FISHER(B2) |
B6 |
Approximate lower correlation bound | =FISHERINV(B5-B4/SQRT(B3-3)) |
B7 |
Approximate upper correlation bound | =FISHERINV(B5+B4/SQRT(B3-3)) |
Independently calculated values: B5 ≈ 0.9729550745, B6 ≈ 0.5340205334, B7 ≈ 0.8740903987. The interval transformation and assumptions are statistical methodology, not an assertion that Gnumeric’s help automatically computes confidence intervals. n must exceed 3. Correlation and its interval do not establish causation. [S1]
A useful reusable layout puts the z value in column C and calls =FISHERINV(C2) in D2, then copies down; this helps avoid mixing transformed z scores with raw correlations in reports.
Error handling and limitations
| Case | Documented / independently reasoned behavior | What to do |
|---|---|---|
| A nonnumeric argument | Gnumeric officially documents #VALUE! |
Confirm the input’s cell type, remove accidental leading apostrophe, and correct imports. [S1] |
=FISHERINV(2) |
Valid numeric input; independently expected 0.9640275801 |
Do not apply FISHER’s narrow −1 < x < 1 domain to its inverse. [S1, S3] |
| Very large positive or negative x | Mathematical tanh approaches +1 or −1; floating-point outputs may round or saturate | Do not infer exact ±1 from a display rounded to a few digits; numerical extremes require native precision checks. |
| Empty cells, TRUE/FALSE, numeric-looking text, spreadsheet errors | This run did not natively test coercion/error propagation in Gnumeric | Use explicit numeric values; document observed application behavior separately. |
#NAME? |
Parsing or function-name issue | Check the spelling FISHERINV, leading equals sign, and use Gnumeric’s Functions menu/help. [S5] |
| Formula displayed as literal text | Input may be stored as a string | Remove any leading apostrophe and re-enter a formula; the manual distinguishes text and formulas. [S5] |
For calculations where extreme z inputs are possible, retain full numeric precision in the source and review the transformation’s suitability for your statistical model rather than blindly reporting 1.00 or −1.00.
Related Gnumeric functions
Gnumeric version, syntax, and compatibility notes
- Documentation target: Gnumeric 1.12, cross-checked with the 1.12.62 release (released September 20, 2026; GNOME download directory posted September 21). This is documentation/source checking, not an on-device runtime certification. [S1–S4]
- The function has a dedicated entry in Gnumeric’s Statistics reference and an implementation registered Complete with Basic upstream tests in the public catalogue. Registered means the upstream distribution advertises the function; it does not prove that the individual examples here were run successfully on your OS, distribution, locale or plugin configuration. [S1–S3]
- Gnumeric’s manual writes English-function examples with an equals sign, uses commas between arguments, and states function names are case-insensitive. Its locale and number formats can vary; these examples use an English-language, dot-decimal configuration. Verify localized input syntax and displayed separators inside your installed application rather than assuming another spreadsheet’s settings. [S5–S6]
- Gnumeric marks this function Microsoft Excel compatible in its own function help. That is a vendor statement about the documented function, not proof of identical results for all imported files, spreadsheet programs, edge cases or historical editions. ODF/other-spreadsheet behavior has not been used to infer undocumented Gnumeric behavior. [S1]
The approximate Fisher confidence-interval method is described by Penn State STAT 505, Lesson 5; its statistical assumptions are separate from Gnumeric’s function contract.
Official references and evidence status (checked 2026-10-13)
- S1 — Official Gnumeric 1.12 Statistics function manual. Relevant lines in current published HTML: 795–818; defines function name, exact argument order, documented errors and vendor Excel-compatibility statement. Publication/update date of the HTML page is not specified; access checked 2026-10-13.
- S2 — Official public function catalogue. Statistics listing registers
fisherinvas Implementation: Complete; Testing: Basic. This is upstream catalogue status, not a test performed for this guide; access checked 2026-10-13. - S3 — Official Gnumeric 1.12.62 source archive. Its
plugins/fn-stat/functions.chelp and callback were inspected after verification against GNOME’s published SHA-256 checksum. This is source-level evidence, not a native test. - S4 — Gnumeric release 1.12.62 announcement and GNOME official source-release index. The Gnumeric source ChangeLog records 2026-09-20, and GNOME’s source index timestamps the tarball 2026-09-21. Release availability does not prove that this guide’s examples were run on any installed OS.
- S5 — Gnumeric formula entry/type/reference manual, including
=, commas, relative/absolute references and typical error names; checked 2026-10-13. - S6 — Gnumeric language/locale manual, locale-controlled numeric representation; checked 2026-10-13.
Validation limits: Official documentation and checksum-verified Gnumeric 1.12.62 source were inspected, and examples were independently calculated. No native Gnumeric execution, screenshots, locale regression or workbook round-trip was performed.