Thanks for the explanation.  It would be great if you could explain this to some extent in the docstring as well, perhaps under a Notes section?