Implement interpolation methods from NaturalNeighbours.jl

[asinghvi17]

NaturalNeighbours.jl is a package which does Delaunay triangulation based interpolation on non-gridded data. This PR integrates it into TopoPlots via a direct dependency and an exposed NaturalNeighboursMethod.

The PR also introduces a reference page for interpolations in interpolation_reference.md, which currently just contains a bunch of plots for each interpolation object I could think of. The actual NaturalNeighbours interpolators are in the bottom two rows.

[codecov]

Codecov Report

Attention: Patch coverage is 43.47826% with 13 lines in your changes missing coverage. Please review.

Project coverage is 79.32%. Comparing base (db4c6b0) to head (4cd374d).
Report is 4 commits behind head on master.

Files	Patch %	Lines
src/interpolators.jl	0.00%	13 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #46      +/-   ##
==========================================
- Coverage   85.54%   79.32%   -6.22%     
==========================================
  Files           5        5              
  Lines         166      179      +13     
==========================================
  Hits          142      142              
- Misses         24       37      +13     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[asinghvi17]

I'm not sure how to test this here, it looks like there's some kind of a reference testing setup though? Or should I just test that this works given that it's coming from an external and well-tested package?

[behinger]

this looks like a great PR!

Regarding the testing: We can test the CloughTocher against the reference python/scipy-MNE implementation. I'm not sure how I'd formally test the other implementations. For me the plots look pretty good, and I always used that as a sanity check.

One thing that would be great, is to write two sentences on what Interpolator we recommend in what usecase. That is, what is your motivation to include NaturalNeighbours in addition to the methods from ScatteredInterpolation?

[asinghvi17]

This should now be in a mergeable state, but will need to wait to merge until NaturalNeighbours.jl is compatible with DelaunayTriangulation.jl v1.0 (cc @DanielVandH)

[DanielVandH]

Just some things I noticed about the multithreading options

[asinghvi17]

This should be ready for review/merge now. I also added a commit to add Makie v0.21 compatibility.

[asinghvi17]

Just wanted to bump this - is there anything holding it back at this point?

[behinger]

looks great!

PS: Holding back I think is my goldfish-memory and the unclear "decision-making" process in TopoPlots.jl, e.g. who is leading/deciding anyway here.

PPS: We could do the version bump directly here

[behinger]

Thanks for the contribution!!

[behinger]

Well, that was celebrated too early. Documentation is failling. @asinghvi17 can you have a look?

  exception = 
    The required storage space exceeds the available storage space:
    nxest or nyest too small, or s too small. Try increasing s.

https://github.com/MakieOrg/TopoPlots.jl/actions/runs/9512297332/job/26220010961

[asinghvi17]

Ah, I guess that example is pretty fragile with random data. I will try to PR something that works more consistently, but I think if you rerun the documentation job a couple of times it should work!