IMEXP Function (Gnumeric)
Learn the IMEXP function in Gnumeric: Returns the algebraic form of the exponential of a complex number.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in Gnumeric. How formula examples are checked
Evidence: Formula values are independently calculated mathematical expectations. Official Gnumeric 1.12.62 source and documentation were reviewed on 13 October 2026; no native execution or application screenshots were produced.
Availability and versions: The function appears in Gnumeric’s official Complex manual and function catalogue, which labels its implementation Complete with Exhaustive upstream tests. That is a catalogue classification, not an execution test of the examples on this page. Gnumeric announced version 1.12.62 with improvements to complex-function compatibility; the specific release binaries/source were not executed in this review. The project directs Linux/BSD users to distribution packages and says it does not currently distribute Windows binaries. Sources: function catalogue; 1.12.62 notes; download/platform policy (checked 2026-10-13).
Quick answer
IMEXP(z) computes e raised to a complex exponent z = a + bi. In exponential form, e^(a+bi) = e^a [cos(b) + i sin(b)]. It changes both magnitude and phase: e^a controls magnitude while b controls the phase in radians. For example =IMEXP("0+1i") has the expected value approximately 0.5403023059+0.8414709848i (independent calculation, not a Gnumeric observation). The official Gnumeric manual states this purpose and the one-argument signature (official complex manual, checked 2026-10-13).
Exact syntax and argument types
=IMEXP(z)
z (required): one complex-number value, such as text "2-1i", a cell reference containing a valid complex value, or a value returned by COMPLEX. There are no optional arguments or defaults. This function is not EXP on just the real part; the imaginary coefficient participates in the calculation. The manual describes invalid z but does not define every accepted import/coercion representation, so avoid treating arbitrary words or locale-formatted text as valid. Gnumeric manual (checked 2026-10-13).
Reproducible formulas and expected results
| Cell/formula | Independently computed expectation | Why it matters |
|---|---|---|
=IMEXP("0+1i") |
0.5403023059+0.8414709848i |
Euler’s formula on the unit circle |
=IMEXP("1+i") |
1.4686939399+2.2873552872i |
Both magnitude and phase change |
=IMEXP("2-1i") |
3.9923240484-6.2176763124i |
Negative phase preserves sign |
=IMEXP("0+0i") |
1 (mathematical value) |
Exponent of zero |
=IMEXP(A2) |
-13.1287830815-15.2007844631i |
Values may land in another quadrant |
=IMEXP(COMPLEX(B2,C2)) |
Same as IMEXP(A2) |
Construct from separate numeric columns |
The figures are complex-number components rounded to 10 decimal places. Actual display strings can differ, including omission of zero components. Check numeric components with IMREAL and IMAGINARY, not exact string equality.
Worked calculation and advanced use
For A4 = 2-1i, calculate the magnitude factor e² ≈ 7.3890560989, cosine cos(-1) ≈ 0.5403023059 and sine sin(-1) ≈ -0.8414709848. Their products give 3.9923240484-6.2176763124i. In a signal-model worksheet, B might describe log-amplitude and C phase: use =IMEXP(COMPLEX(B2,C2)) to convert the two components to a complex phasor. This is a mathematical use case, not proof of device-specific signal processing accuracy.
A round-trip check is =IMEXP(IMLN(A2)), mathematically returning A2 for nonzero complex A2. Because the logarithm is taken on a principal branch and floating-point arithmetic is approximate, verify the recovered coefficients with a tolerance rather than assuming identical text. Related Gnumeric guide: IMLN, COMPLEX, IMREAL, and IMAGINARY.
Additional limit: A very large positive real coefficient can cause exponential overflow; a large negative one may underflow toward zero. Exact thresholds and returned error text are implementation/version dependent and were not tested. Use a bounded input range and test on the target installation.
Build a reproducible worksheet
Create a blank Gnumeric sheet. Enter these complex-number text literals without a leading = in column A. Use plain English-formatted samples with a period as decimal separator; inspect your locale’s input conventions before adapting them.
| Cell | Enter as text | Purpose |
|---|---|---|
| A2 | 3+4i |
Nonzero magnitude and positive phase |
| A3 | 1+i |
45° phase, useful for checking imaginary coefficient |
| A4 | 2-1i |
Negative imaginary coefficient |
| A5 | 0+1i |
Imaginary-axis input |
| A6 | 0+0i |
Zero exponent: its exponential is mathematically 1 |
| B2 | 3 (numeric) |
Real component for a constructed input |
| C2 | 4 (numeric) |
Imaginary component for a constructed input |
Enter the article’s function formula in D2 and copy to rows 3–5 if desired. For a constructed input, enter =COMPLEX(B2,C2) in D7 and use the article’s function around D7. COMPLEX’s manual signature is COMPLEX(x,y,i) with the suffix defaulting to i. The comma shown follows the English-language Gnumeric manual; locales may change separators and decimal conventions. This article does not claim to have tested other locale syntaxes. Sources: COMPLEX documentation; locale documentation (checked 2026-10-13).
Errors, limitations, and troubleshooting
- Unparseable text: The online Gnumeric 1.12 manual says
#VALUE!for invalid complex input. The checksum-verified official 1.12.62 source returns#NUM!for malformed complex strings; other unsupported value types may yield#VALUE!. This resolves the release-source provenance question, but is not a native execution result. - Quoted numeric-looking strings: Ensure your input contains a valid complex representation (
"3+4i"or"2-1i"), not a stray unit, spreadsheet formula, or text with thousands separators. Thei/jconvention belongs inside the complex text; do not append it to an ordinaryLN/LOGresult. - Locale/import: Formula syntax and text parsing can vary with decimal separators. The one-argument function signature stays one argument, but nested
COMPLEX(B2,C2)uses a delimiter that your localized installation may represent differently. Test an imported worksheet rather than silently replacing commas with semicolons; consult Gnumeric locale documentation. - Precision and formatting: Calculated complex results are floating-point approximations; displayed digits, placement of
iorj, and very small residual coefficients can vary. For verification compare real and imaginary components numerically (e.g.IMREAL/IMAGINARY) rather than comparing raw strings. - Compatibility: The manual marks this function Excel compatible, but this is Gnumeric’s documented classification. It does not establish identical parsing, error codes, version support, formatting, or calculations in another spreadsheet. Confirm a workbook separately in each target product.
- Testing boundary: All expected values on this page were independently derived using Python’s standard
cmath/mathmodules and analytic identities. Native Gnumeric checks: 0. Errors described as unresolved are deliberately not disguised as tested results.
Claim-level official references (checked 2026-10-13)
- Gnumeric Complex manual — signature, purpose, input note, compatibility and principal branch where stated.
- Official function catalogue — IMEXP: Complete / Exhaustive (upstream catalogue status, not observed execution).
- Gnumeric 1.12.62 release announcement — general complex-function compatibility improvements, not a claim of per-example native testing.
- Official Gnumeric 1.12.62 source archive — inspected complex callbacks and shared parser in plugins/fn-complex/functions.c; release archive checked against its official SHA-256 checksum.
- Gnumeric download policy and locale documentation — platform availability and locale caveats.
Native validation remains outstanding: exact displayed results, error cells, locale behavior and workbook round-trips have not been checked in a running Gnumeric installation.