Conventions and parameter maps for Heun functions
Why this page exists
Section titled “Why this page exists”The fastest way to make a wrong statement about a Heun function is to write only its name and not its equation.
For Heun functions, the symbol alone is rarely enough. In practice you must also know
- the differential equation,
- the parameter order,
- the normalization or base point, and
- the analytic-continuation convention (for example a branch cut, or a local power series around an ordinary point).
This page is the site-wide reference for those choices on heun.xyz. It is not claiming that one universal convention exists. It does the opposite: it makes our conventions explicit and gives the translations you need when moving among
- the attached reference volume Heun’s Differential Equations (Ronveaux, ed., 1995),
- the NIST Digital Library of Mathematical Functions (DLMF),
- the Wolfram Language documentation, and
- Maple’s built-in Heun functions.
The family at a glance
Section titled “The family at a glance”| Function | Singularities in a standard form | Local object used as the function | Base point on heun.xyz | Convergence / global issue |
|---|---|---|---|---|
HeunG | four regular singularities | Frobenius solution analytic at | power series radius $\min(1, | |
HeunC | regular at ; irregular at of rank | Frobenius solution analytic at | power series radius ; principal branch cut convention matters | |
HeunD | two irregular singularities (standardly at or, in Maple, at ) | local analytic solution fixed at an ordinary point | in the site convention | no Frobenius normalization at an irregular singular point |
HeunB | regular at ; irregular at of rank | Frobenius solution analytic at | entire in for the usual local solution | |
HeunT | only an irregular singularity at of rank | power-series solution fixed by two initial conditions | entire in ; Stokes behavior appears only at infinity |
The house conventions used on heun.xyz
Section titled “The house conventions used on heun.xyz”HeunG on heun.xyz
Section titled “HeunG on heun.xyz”We use the standard general Heun equation
with
Our symbol
means the solution analytic at and normalized by
This is the easiest family conventionally because the major CAS agree on it: Maple and the Wolfram Language use the same parameter order and the same local normalization.
Practical reading rule. If a paper writes , that is usually the same local object as our HeunG, up to notation.
HeunC on heun.xyz
Section titled “HeunC on heun.xyz”We use the DLMF / Wolfram confluent Heun equation
Our symbol
means the Frobenius solution at normalized by
The local exponents are and at , and and at . The Taylor series at has radius of convergence . In the principal Wolfram convention the branch cut runs from to .
Maple-to-site map for HeunC
Section titled “Maple-to-site map for HeunC”Maple uses
for the local solution of
where
Then the equivalent site parameters are
Conversely, given the site parameters ,
HeunD on heun.xyz
Section titled “HeunD on heun.xyz”We use the Wolfram/DLMF-style double-confluent equation
or equivalently
Our symbol
means the local analytic solution fixed at the ordinary point by
This choice is not cosmetic. In this convention is an irregular singular point, so there is no Frobenius normalization there.
Relation to the DLMF reduced DCHE
Section titled “Relation to the DLMF reduced DCHE”DLMF writes the doubly confluent equation in the reduced form
If , a rescaling of the independent variable reduces the site convention to the DLMF normalization with the constant term in fixed to . After that rescaling, the two conventions differ only by a relabeling of the coefficients of and .
Maple warning for HeunD
Section titled “Maple warning for HeunD”Maple also has a built-in HeunD, but it uses a different normal form: the irregular singularities are placed at , the origin is an ordinary point, and the built-in function is expanded around .
So Maple HeunD is not a simple parameter relabeling of the site convention.
Translation rule. For HeunD, never compare software output by symbol name alone. Compare by ODE and normalization.
HeunB on heun.xyz
Section titled “HeunB on heun.xyz”We use the 4-parameter Ronveaux / Maple biconfluent form
Our symbol
means the solution analytic at and normalized by
This convention is extremely convenient because
- the exponents at are transparent,
- the local power series is straightforward,
- polynomial truncation is easy to state,
- and Maple uses the same 4-parameter structure.
Exact map from the site convention to Wolfram HeunB
Section titled “Exact map from the site convention to Wolfram HeunB”Wolfram uses the 5-parameter equation
with the regular solution normalized by .
The exact parameter map from the site convention to Wolfram’s parameters is
DLMF warning for HeunB
Section titled “DLMF warning for HeunB”DLMF uses a different reduced biconfluent form,
which is equivalent to the site convention only after a rescaling of the independent variable and a linear redefinition of parameters.
So for HeunB the correct question is not “which symbol is right?”, but “which ODE am I actually solving?”
HeunT on heun.xyz
Section titled “HeunT on heun.xyz”We use a reduced 3-parameter triconfluent form,
Our symbol
means the entire solution fixed by
This convention is well adapted to entire-function methods, Taylor recurrences, and polynomial solutions.
Relation to Wolfram HeunT
Section titled “Relation to Wolfram HeunT”Wolfram uses the 5-parameter triconfluent equation
with the power-series normalization
If you want the site convention with the same independent variable and no further gauge transformation, then it is the specialization
DLMF warning for HeunT
Section titled “DLMF warning for HeunT”DLMF uses another 3-parameter triconfluent standard form,
which belongs to the same triconfluent family but is not the same literal ODE as the site convention. In the triconfluent literature, different normal forms are common, and one often passes among them by normal-form reductions, rescalings, and gauge transformations.
So for HeunT, more than for any other member of the family, you should compare by the ODE itself and not by the function name alone.
A compact crosswalk of the five site conventions
Section titled “A compact crosswalk of the five site conventions”| Site page | House symbol on heun.xyz | Closest direct CAS match | What to watch for |
|---|---|---|---|
| General | HeunG(a,q,\alpha,\beta,\gamma,\delta;z) | Maple and Wolfram both match directly | remember the Fuchs relation for |
| Confluent | HeunC(q,\alpha,\gamma,\delta,\epsilon;z) | Wolfram matches directly | Maple uses and a different ODE presentation |
| Double confluent | HeunD(q,\alpha,\gamma,\delta,\epsilon;z) | Wolfram matches directly | Maple HeunD uses a different canonical variable placement and a different base point |
| Biconfluent | HeunB(\alpha,\beta,\gamma,\delta;z) | Maple is the closest direct match | Wolfram uses a 5-parameter form; DLMF uses a reduced form |
| Triconfluent | HeunT(\alpha,\beta,\gamma;z) | reduced 3-parameter literature / Maple-style workflows | Wolfram uses a 5-parameter form; DLMF uses another reduced normal form |
Which parameter is the accessory parameter?
Section titled “Which parameter is the accessory parameter?”This matters in spectral problems.
- For
HeunG, the accessory parameter is . - For
HeunC, the accessory parameter is again in the DLMF / Wolfram convention; Maple packages the same freedom into together with the other coefficients. - For
HeunD, the accessory parameter is naturally in the Wolfram / DLMF-like convention. - For
HeunB, in the 4-parameter Ronveaux / Maple form the role most often played by an accessory parameter is carried by . - For
HeunT, different normal forms distribute the free coefficients differently; in the reduced 3-parameter form used on this site there is no universally preferred “one true accessory parameter” in the same way as forHeunGorHeunC.
Practical rule. The accessory parameter is the one not fixed by the local exponent data and usually determined by a global boundary condition.
Polynomial conditions: the site-wide rule of thumb
Section titled “Polynomial conditions: the site-wide rule of thumb”The detailed truncation formulas depend strongly on the chosen convention, but the overall pattern is stable.
HeunG: one exponent parameter must be a nonpositive integer, and the accessory parameter must satisfy a finite algebraic condition.HeunC: a linear truncation condition plus a determinant or accessory-root condition.HeunB: a linear truncation condition plus a root condition in the accessory-like parameter.HeunD: the usual double-confluent normalizations do not lead to the same simple Frobenius-polynomial story, because the canonical equation has no regular singular point at which a polynomial truncation is naturally defined.HeunT: polynomial solutions occur when one coefficient parameter takes a positive-integer value and the remaining parameters satisfy a finite determinant condition.
So when you quote a “Heun polynomial condition,” always quote it in the same convention as the ODE you are using.
The common traps this site is designed to eliminate
Section titled “The common traps this site is designed to eliminate”1. Confusing a local solution with a global eigenfunction
Section titled “1. Confusing a local solution with a global eigenfunction”HeunG, HeunC, HeunB, and the ordinary-point normalizations of HeunD and HeunT are first and foremost local normalized solutions. In applications you often want something else: a solution satisfying conditions at multiple singular points or in multiple Stokes sectors. That usually turns the accessory parameter into an eigenvalue.
2. Comparing Maple and Wolfram values without converting parameters
Section titled “2. Comparing Maple and Wolfram values without converting parameters”This is harmless for HeunG, but dangerous for HeunC, very dangerous for HeunD, and often fatal for HeunB and HeunT.
3. Forgetting that irregular singularities change what “normalization” means
Section titled “3. Forgetting that irregular singularities change what “normalization” means”At a regular singular point you can define a Frobenius solution. At an irregular singular point you usually cannot. Then the function is defined instead by initial data at an ordinary point or by an asymptotic condition in a Stokes sector.
4. Treating branch issues and Stokes issues as if they were the same thing
Section titled “4. Treating branch issues and Stokes issues as if they were the same thing”HeunGandHeunChave branch-cut conventions for principal values.HeunD,HeunB, andHeunTare better thought of in terms of local analytic continuation and Stokes phenomena near irregular singular points.
5. Switching conventions in the middle of a derivation
Section titled “5. Switching conventions in the middle of a derivation”Pick one convention, do the algebra in that convention, and only translate at the beginning or at the end.
What every function page on heun.xyz should state up front
Section titled “What every function page on heun.xyz should state up front”Every page on this site should begin with a compact definition box containing the following items.
- Exact ODE. No shorthand, no hidden parameter constraints.
- Normalization. For example or , .
- Singularity structure. Regular vs irregular, and rank when irregular.
- Expansion point. The point around which the local series is defined.
- Closest CAS match. Maple, Wolfram, both, or neither directly.
- Parameter map note. A one-line warning if the same symbol means something else elsewhere.
That single box already removes most avoidable confusion.
References and authoritative sources
Section titled “References and authoritative sources”Core mathematical references
Section titled “Core mathematical references”- A. Ronveaux (ed.), Heun’s Differential Equations, Oxford University Press, 1995. In particular Part B (confluent), Part C (double confluent), Part D (biconfluent), and Part E (triconfluent).
- NIST Digital Library of Mathematical Functions, Chapter 31, especially §31.2 and §31.12: https://dlmf.nist.gov/31 and https://dlmf.nist.gov/31.12
Official CAS documentation
Section titled “Official CAS documentation”- Wolfram Language:
HeunG,HeunC,HeunD,HeunB,HeunT. - Maple Help:
HeunG,HeunC,HeunD,HeunB,HeunT.- https://www.maplesoft.com/support/help/Maple/view.aspx?path=HeunG
- https://www.maplesoft.com/support/help/Maple/view.aspx?path=HeunC
- https://www.maplesoft.com/support/help/Maple/view.aspx?path=HeunD
- https://www.maplesoft.com/support/help/Maple/view.aspx?path=HeunB
- https://www.maplesoft.com/support/help/Maple/view.aspx?path=HeunT
Suggested use of this page
Section titled “Suggested use of this page”Use this page first, then go to the function-specific guide:
HeunGfor the general equation,HeunCfor the singly confluent case,HeunDfor the double-confluent case,HeunBfor the biconfluent case,HeunTfor the triconfluent case.
When those pages mention a “site convention,” they mean exactly the conventions fixed here.