Missing Doc on 1D Integrator about docs HOT 18 CLOSED

tracked down section in latex that got lost during conversion to bookdown in Aug/Sept 2018.
added section to chapter "Higher Order Functions" -
https://mc-stan.org/docs/2_19/functions-reference/functions-1d-integrator.html

from docs.

Thanks. We'll add the doc before the next release.

from docs.

cf discussion here: https://discourse.mc-stan.org/t/how-to-use-integrate-1d/9218/11

from docs.

updated 2_19 html and pdfs - docs are online.

from docs.

Thanks for fixing this!

In the "precision loss" section of the integrate_1d function, there is reference to an example in the user guide of how to mitigate precision loss.

I cannot seem to find it: Not any reference to integrate_1d, nor in any of the documentation relating to ODEs or algebra solver. Searching for precision loss doesn't help either. I can't find an example in the arithmetic precision section of the guide either.

Does this example exist? Maybe it also got lost?

from docs.

That advice is coming from here: https://www.boost.org/doc/libs/1_70_0/libs/math/doc/html/math_toolkit/double_exponential/de_tanh_sinh_2_arg.html

So if you have terms that look like (integral_endpoint - x), you can replace them with xc.

from docs.

(Also thanks for pointing that out, yeah, musta gotten lost as well)

from docs.

@mitzimorris I think the latest version of that example code for the user's guide is here: stan-dev/stan@4a0595a

from docs.

@bbbales2 restored your fabulous prose to its rightful place:
https://mc-stan.org/docs/2_19/stan-users-guide/integrate-1d.html

from docs.

I was just using this and there still isn't any mention of the tolerance argument in the docs (e.g. here https://mc-stan.org/docs/2_21/stan-users-guide/calling-the-integrator.html).

I had the same parser issue discussed here: https://discourse.mc-stan.org/t/how-to-use-integrate-1d/9218/17

from docs.

@bbbales2 - tolerance argument guidance?

from docs.

I guess in the best case we'd change the 2.21 docs that are posted to indicate that the tolerance is required (and specify a default of like 1e-8). Is there any mechanism of changing the release docs? Or does this just wait until 2.22?

from docs.

And by "Or does this just wait until 2.22" I guess what I mean is, do changes to the online docs wait until the next release?

from docs.

from docs.

I guess in the best case we'd change the 2.21 docs that are posted to indicate that the tolerance is required (and specify a default of like 1e-8)

we can change the 2.21 docs - is this something that should be in the 2.21 docs?

from docs.

@bbbales2 - is there something further that needs to be done here?

from docs.

We gotta add the tolerance-free version of the docs back after the next release (assuming the tolerance-free version works then)

from docs.

tolerance free will work in 2.22?
in which case, will add back in before generating release docs.

from docs.