Add docs for new hypergeometric functions #866
Conversation
|
This should mention the size constraints on p,q (I think it's just that We could also put some of the math in the "mathematical functions" appendix -- not really sure we use that all that much though |
|
Going to ask @bob-carpenter if he can take a look at this |
|
Are these functions in the new release? |
|
@spinkney yes! so it would be nice to get this reviewed and merged in the next week |
|
|
||
| Hypergeometric functions refer to a power series of the form | ||
| \begin{equation*} | ||
| _pF_q(a_1,...,a_p;b_1,...,b_q;z) = \sum_{n=0}^\infty \frac{(a_1)_n\cdot\cdot\cdot(a_p)_n}{(b_1)_n\cdot\cdot\cdot(b_q)_n} \frac{x^n}{n!} |
There was a problem hiding this comment.
z shows up on left and not on right and x shows up on right but not on left, so I think these are meant to be the same symbol.
There was a problem hiding this comment.
Based on the documentation at https://www.boost.org/doc/libs/1_85_0/libs/math/doc/html/math_toolkit/hypergeometric/hypergeometric_pfq.html, you are correct
Just wanted to chime in and say this is useful in constructing cdfs for some discrete distributions. These can then be used in copulas with data augmentation for the discrete margins. I'm sure that there are plenty of other use cases as well! |
|
Thanks, @spinkney. We're working on getting a copulas chapter into the User's Guide at which point it might be nice to add the how-to. Speaking of which, there are probably other of the tricks you have in your library that'd be useful to document in the User's Guide. |
Submission Checklist
<<{ since VERSION }>>Summary
Corresponding docs PR for the newly-exposed hypergeometric functions
I've made a separate section for these, since there will be more specialisations coming - but let me know if they should be somewhere else!
Copyright and Licensing
Please list the copyright holder for the work you are submitting (this will be you or your assignee, such as a university or company): Andrew Johnson
By submitting this pull request, the copyright holder is agreeing to license the submitted work under the following licenses: