pub fn hyp1f2(a: f64, b1: f64, b2: f64, z: f64) -> Option<f64>Expand description
Generalized hypergeometric function $_1F_2$ for real arguments
This function is not available in SciPy.
§Notes
For all $z$,
$$ \hyp 1 2 a {b_1\enspace b_2} z = \sum_{n=0}^\infty {\rpow a n \over \rpow{b_1}{n} \ \rpow{b_2}{n}} {z^n \over n!} , $$
with the rising factorial $\rpow \square n$ (pow_rising) 1. A
non-positive integer $a = -n$ makes it a polynomial of degree $n$.
As in hyp2f2, an $a$ equal to a $b_j$ cancels it, also if it is a non-positive integer, so
that the result is the $_0F_1$ of the other $b_j$, and it is $+\infty$ if a $b_j$ is a
non-positive integer $-m$, unless it is a polynomial of degree $\lt m$. It is NaN if an argument
is NaN, and overflows to $\pm\infty$ for large $z > 0$. For an infinite argument, it is the
limit as in hyppfq.
§Returns None
If the relative error could exceed about $10^{-13}$:
- for some $z < 0$: rarely if all $\abs a, \abs{b_j} \le 10$, but e.g. for about half of $-10^5 < z < -10^3$ if they are up to 100;
- for most $z \lesssim -10^{32}$;
- near a zero, or if the result underflows;
- for some infinite arguments, as for
hyppfq.
§See also
hyp0f1: Confluent hypergeometric limit function, $_0F_1(b; z)$hyp2f2: Generalized hypergeometric function, $\hyp 2 2 {a_1\enspace a_2} {b_1\enspace b_2} z$
NIST Digital Library of Mathematical Functions https://dlmf.nist.gov/16.2 ↩