Added approximate KNN backend

[nicolassidoux]

I had to from scanpy.neighbors._types import KnnTransformerLike, _KnownTransformer to make transformer argument of neighbors() consistent with scanpy. But _types is protected...

[eroell]

@Zethson what is your stance on importing private variables from scanpy, as we are doing elsewhere too?

I remember in the past you've added a fix of a previously imported, external private variable by defining the required variable ourselves.

I lean towards doing this here too

[Zethson]

@Zethson what is your stance on importing private variables from scanpy, as we are doing elsewhere too?

I remember in the past you've added a fix of a previously imported, external private variable by defining the required variable ourselves.

I lean towards doing this here too

Yeah, we should try to avoid importing internals so I think that's a good option.

[eroell]

Thank you so much @nicolassidoux !
One thing I realized here was that we should add tests for the pass through function calls of scanpy...

But this is from our side so far a lacking suite of tests (as we as of now have been closely eyeing scanpy), and hence no test suite at this point to add to here :)

[eroell]

ready for me to take a quick look again or are you still doing stuff? :)

[nicolassidoux]

Hi @eroell, ready for re-review!

[eroell]

Added the intersphinx mappings for pynndescent, and linked the reference to the scanpy knn tutorial with a readable text; Also added a more wordy description on the arguments, more wordy than scanpy...
So direct commit of suggestions instead of knitty-gritty review comments to save your time, what is your take on these additions @nicolassidoux? Would you as user think this is more clear now, or worse?

[nicolassidoux]

@eroell
Yes, direct commit is a good idea indeed!
In regard with documentation stuff, I really let you decide whatever suits, I definitely don't have the skills to judge from a user perspective 😄 But AFAIK the description looks good!
I let you close the PR if you think all is good!

[eroell]

great - this is a nice addition, thank you @nicolassidoux !