... and adds amake show target indoc/Makefile to make it easier to pop open the built docs

I'm very very psyched, but why are some of the examples not showing? Is there something that can be done on matplotlib's side to get that working?

During build I see:

Animation size has reached 21248815 bytes, exceeding the limit of 20971520.0. If you're sure you want a larger animation embedded, set the animation.embed_limit rc parameter to a larger value (in MB). This and further frames will be dropped.

I'll bump this up indoc/matplotlibrc, it's very close to the limit. Here is how it looks thus far:

https://37238-1385122-gh.circle-artifacts.com/0/doc/build/html/gallery/index.html#animation

I'm very very psyched, but why are some of the examples not showing?

• It currently only processes the FuncAnimation examples, because I didn't think to implement ArtistAnimation support at the Sphinx-gallery end (didn't actually know about it and didn't investigate all the options).
• At least a couple of the examples (e.g., "pyplot animation") just loop directly rather than using a*Animation object.
• one of the examples usesinterval=2 which goes super fast, which might break the GIF thumbnailing (it animates in the example)

I'll take a quick pass at making the ones that do use FuncAnimation build a bit more nicely.

How are you identifying the animation object to capture?

We want to leave at least some of the "plt.pause in a loop" exmaple as is. For simple things it is enough and we don't want to suppress it.

How are you identifying the animation object to capture?

Global variable inspectionisintance(var, FuncAnimation) currently. So probably just needs to expand to includeArtistAnimation via tuple or a super class if there is one

We want to leave at least some of the "plt.pause in a loop" exmaple as is. For simple things it is enough and we don't want to suppress it.

Indeed, not planning to change that one. But thedouble_pendulum seems like it should be okay to run so I'm going to try removing itssgskip...

I would go withmatplotlib.animation.Animation as the base class.

Done insphinx-gallery/sphinx-gallery#693 , will have to wait for 0.7.1 to land before it takes effect, though. In the meantime I've addedscipy to the doc build requirements so that the pendulum example can run (and be removed fromsgskip) --scipy is easilypip-installable nowadays so it doesn't seem too onerous. If you disagree I can restore thesgskip status, but it does look cool -- locally with the SG PR branch I now see:

The CircleCI build should produce the same thing, except that thedynamic_imag.py example won't animate (though I did make it so that it should produce a still image rather than a blank canvas now).

CircleCI output can be viewed here.

Now the animation timings are:

    - ../examples/animation/strip_chart.py:                                        27.75 sec   0.0 MB    - ../examples/animation/double_pendulum.py:                                    27.36 sec   0.0 MB    - ../examples/animation/animate_decay.py:                                      26.73 sec   0.0 MB    - ../examples/animation/random_walk.py:                                        18.80 sec   0.0 MB    - ../examples/animation/unchained.py:                                          15.93 sec   0.0 MB    - ../examples/animation/bayes_update.py:                                       13.91 sec   0.0 MB    - ../examples/animation/simple_anim.py:                                        13.38 sec   0.0 MB    - ../examples/animation/animated_histogram.py:                                 12.40 sec   0.0 MB    - ../examples/animation/animation_demo.py:                                      9.19 sec   0.0 MB    - ../examples/animation/rain.py:                                                8.14 sec   0.0 MB

And the non-animation ones in roughly the same range for reference:

    - ../examples/style_sheets/style_sheets_reference.py:                          27.31 sec   0.0 MB    - ../tutorials/intermediate/constrainedlayout_guide.py:                        23.00 sec   0.0 MB    - ../tutorials/colors/colormaps.py:                                            19.41 sec   0.0 MB    - ../examples/lines_bars_and_markers/markevery_demo.py:                        13.22 sec   0.0 MB    - ../tutorials/intermediate/gridspec.py:                                       12.41 sec   0.0 MB    - ../examples/subplots_axes_and_figures/subplots_demo.py:                       9.88 sec   0.0 MB    - ../tutorials/intermediate/tight_layout_guide.py:                              8.93 sec   0.0 MB    - ../tutorials/introductory/images.py:                                          8.87 sec   0.0 MB    - ../examples/showcase/mandelbrot.py:                                           8.21 sec   0.0 MB

So there is something like a 2-3 minute time penalty from rendering these animations now. If this is too much time, I can work on trimming them. Ready for merge from my end otherwise!

I am 👍 on adding scipy as a docs build dependancy (as I thought it already was), but we should note that change as well (attn@timhoffm@QuLogic )

git grep scipy inexamples suggests thatexamples/images_contours_and_fields/irregulardatagrid.py has a code snippet that could be simplified using / refers toscipy.interpolate as a shortcut. Can push here if it's helpful