tomchor / Oceanostics.jl

Diagnostics for Oceananigans
https://tomchor.github.io/Oceanostics.jl/
MIT License
24 stars 8 forks source link

Animation in tilted bottom boundary layer example doesn't work in the docs when the grid is stretched #159

Closed tomchor closed 1 week ago

tomchor commented 6 months ago

This is a problem that popped up in https://github.com/tomchor/Oceanostics.jl/pull/157 and I haven't been able to fix it.

Basically when the grid there is stretched, the docs hang at the point where the animation is being created.

So for now https://github.com/tomchor/Oceanostics.jl/pull/157 re-wrote the example using a regular grid and things seems to be working properly. I believe the problem is either in the interaction between Documenter and Makie or in the interaction between Documenter and Rasters.

What makes it hard to investigate this is that I wasn't able to reproduce it locally at all :/ So for each iteration I've been having to make a change, commit, push it to a PR, wait for about an hour for the docs to get there and see the CI hangs. I think the next step is to make a MWE with an animation without Rasters, to at least narrow down if the issue is with Makie + Documenter, or Rasters + Documenter.

glwagner commented 6 months ago

Maybe try speeding up the docs build in CI by commenting everything out except this one example in make.jl.

tomchor commented 6 months ago

I've done that in the course of #157, but it's slow since there's no error, so it forces me to wait for a longer-than-usual amount of time to see if indeed nothing is happening.

glwagner commented 6 months ago

You mean even with only one example being loaded the docs still take an hour to run? 😱

glwagner commented 6 months ago

Can you paste the code that creates the animation?

tomchor commented 5 months ago

Here!:

https://github.com/tomchor/Oceanostics.jl/blob/2036fe3780efb6e8a8b7d386e506da446be976bf/docs/examples/tilted_bottom_boundary_layer.jl#L167-L218

glwagner commented 5 months ago

Huh, I'm not familiar with the packages being used. It seems probable that the relative slowdown for stretched vs uniform vertical grid has to do with :zF => Z. What's Z?