Clarify status of gradient search resampler with nearest neighbour method #3275
Description
Feature Request
Is your feature request related to a problem? Please describe.
It is reportedly possible to use the gradient search resampler with a nearest neighbour method. The documentation mentions a method keyword argument, but not what values it accepts. It seems that method="nn" or method="nearest_neighbour" work, but this is undocumented.
Describe the solution you'd like
Firstly, I would like to know if passing "nearest_neighbour" or "nn" to this method specification is officially supported.
Secondly, if it is supported, it could be documented.
Can it make use of caching like the "normal" nearest neighbour resampling?
Describe any changes to existing user workflow
Some users may discover a feature they were not previously aware of. This might make them happy. Happiness can have all kinds of unexpected and unprecedented consequences!
Additional context
So far I've simply used nearest neighbour resampling for nearest neighbour and gradient search for gradient search, never gradient search with nearest neighbour as a method. Perhaps it would perform better in some cases.