Add NDPointIndex examples

[benbovy]

• Simple example (using scipy's KDTree)
• Advanced example based on ROMS data (using custom adapter based on scikit-learn's BallTree) (wip)

[dcherian]

How about we put the default KDTree example under "Builtin" with title "KDTree with NDPointIndex" and leave the advanced example for this "Building Blocks" page

[benbovy]

How about we put the default KDTree example under "Builtin" with title "KDTree with NDPointIndex" and leave the advanced example for this "Building Blocks" page.

Or some "3rd-party extensible" visual marker, e.g., in the detailed TOC?

It is nice to keep short each section but at the same time too much breaking down might make things hardly discoverable.

Like @scottyhq (#17 (comment)) I think that built-in and building block categories could be merged together (CoordinateTransformIndex can also be used as-is, especially if we later provide some built-in transforms). But I also think that is is important to be able to identify which indexes are building blocks.

[benbovy]

Aouch pydata/xarray#10503 broke the xdggs example.

[dcherian]

But I also think that is is important to be able to identify which indexes are building blocks.

that was my initial thinking.

Aouch pydata/xarray#10503 broke the xdggs example.

ouch indeed, I can revert in an hour or I can merge if someone else sends up the revert PR.

cc @keewis

[benbovy]

Tried pydata/xarray#10518 but it created other problems.

A working fix would be in xdggs to rename the wrapped pandas Index after creating the xarray index in xdggs.DGGSIndex.from_variables (and/or in each DGGS index subclass) , like it is done in xarray.indexes.PandasIndex.from_variables.

[dcherian]

So... how did this get fixed?

I have seen the light.

[dcherian]

Amazing work, @benbovy I pushed a minor edit (mostly a new image to make it easier to present), and will merge now.

Thanks for pushing hard here this week. I think this gallery is now an impressive testament to what you've accomplished!